Search Response¶

Example Search Response (Identify Music Search)¶

JSON

{
  "lookup_ids": [
    "123456789012345678"
  ],
  "query_file_duration_seconds": 158.0,
  "matches": [
    {
      "asset": {
        "title": "Example Track",
        "subtitle": "",
        "artist": "Example Artist",
        "isrc": "USRC12345678",
        "id": "987654321098765432",
        "duration_seconds": 207.0,
        "album_name": "Example Album",
        "barcode": "123456789012",
        "label": "Example Label",
        "distributor": "Example Distributor",
        "release_date": {
          "year": 2024,
          "month": 1,
          "day": 15
        },
        "dsp": [
          {
            "name": "spotify",
            "url": "https://open.spotify.com/track/example-track"
          }
        ]
      },
      "match_details": {
        "audio": {
          "query_match_duration_seconds": 158.0,
          "query_match_percentage": 100.0,
          "asset_match_duration_seconds": 207.0,
          "asset_match_percentage": 76.3,
          "segments": [
            {
              "query_start": 0,
              "query_end": 158,
              "asset_start": 12,
              "asset_end": 170,
              "audio_pitch": 0,
              "audio_speed": 100,
              "melody_transposition": null,
              "confidence": 100
            }
          ]
        },
        "melody": null,
        "phonetic": null,
        "video": null
      }
    }
  ],
  "content_classification": null
}

Example Search Response (Content Classifiation)¶

JSON

{
  "lookup_ids": [
    "123456789012345678"
  ],
  "query_file_duration_seconds": 241.0,
  "matches": null,
  "content_classification": {
    "silence": [
      {
        "start": 230,
        "end": 240,
        "confidence": 100.0,
        "subclasses": []
      }
    ],
    "music": [
      {
        "start": 2,
        "end": 230,
        "confidence": 98.4,
        "subclasses": [
          {
            "name": "singing",
            "confidence": 82.1
          },
          {
            "name": "pop music",
            "confidence": 35.2
          }
        ]
      }
    ],
    "speech": []
  }
}

Search Response Glossary¶

Top-Level Fields¶

Field	Description
`lookup_ids`	Lookup IDs associated with the completed Search request.
`query_file_duration_seconds`	Duration of the uploaded query media file.
`matches`	Match results returned from Search workflows.
`content_classification`	Content classification results returned from classification workflows.

Match Object¶

Field	Description
`asset`	Metadata describing the matched asset.
`match_details`	Match information grouped by fingerprint type.

Asset Fields¶

Field	Description
`title`	Asset title.
`subtitle`	Asset subtitle or version information.
`artist`	Primary artist name.
`isrc`	ISRC associated with the matched asset.
`id`	Internal asset identifier.
`duration_seconds`	Asset duration in seconds.
`album_name`	Album or release name.
`barcode`	UPC/EAN barcode associated with the release.
`label`	Record label name.
`distributor`	Distribution company name.
`release_date`	Structured release date object.
`dsp`	DSP/platform links associated with the asset.

Match Details¶

Field	Description
`audio`	Audio fingerprint match details.
`melody`	Melody fingerprint match details.
`phonetic`	Phonetic fingerprint match details.

Segment Fields¶

Field	Description
`query_start`	Start timestamp within the query media.
`query_end`	End timestamp within the query media.
`asset_start`	Start timestamp within the matched asset.
`asset_end`	End timestamp within the matched asset.
`audio_pitch`	Relative pitch adjustment information.
`audio_speed`	Relative playback speed information.
`melody_transposition`	Melody transposition value when applicable.
`confidence`	Match confidence score.

Content Classification¶

Field	Description
`music`	Music classification segments.
`speech`	Speech classification segments.
`silence`	Silence classification segments.

Classification Segment Fields¶

Field	Description
`start`	Segment start timestamp.
`end`	Segment end timestamp.
`confidence`	Classification confidence score.
`subclasses`	Additional detailed classification labels.

Classification Subclasses¶

Field	Description
`name`	Detailed subclass label name.
`confidence`	Subclass confidence score.