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": []
  }
}

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.