> For the complete documentation index, see [llms.txt](https://docs.pex.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pex.com/search/api-documentation/search-response.md).

# Search Response

### Example Search Response (Identify Music Search)

{% tabs %}
{% tab title="JSON" %}

```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
}
```

{% endtab %}
{% endtabs %}

### Example Search Response (Content Classifiation)

{% tabs %}
{% tab title="JSON" %}

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

{% endtab %}
{% endtabs %}

### 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.    |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pex.com/search/api-documentation/search-response.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.