Search Response (Custom Database)¶

Interpreting a Private Search Response¶

A search against your Custom Database returns matches against assets you have ingested into your private catalog. If one or more assets match the query, the response conveys:

lookup_ids: The lookup ID(s) associated with this query
query_file_duration_seconds: Duration of the query media file or fingerprint in seconds
matches: A list of matched assets, including:
- provided_id: The custom identifier assigned to the asset when it was ingested
- match_details: Signal-specific match information (audio, melody, phonetic, or video), including durations, percentages, and segment timestamps

Example Search Response¶

JSON

{
  "lookup_ids": [
    "123456789012345678"
  ],
  "query_file_duration_seconds": 158.0,
  "matches": [
    {
      "provided_id": "my_custom_asset_id_123",
      "match_details": {
        "audio": {
          "query_match_duration_seconds": 158.0,
          "query_match_percentage": 100.0,
          "asset_match_duration_seconds": 207.0,
          "asset_match_percentage": 100.0,
          "segments": [
            {
              "query_start": 0,
              "query_end": 158,
              "asset_start": 0,
              "asset_end": 207,
              "audio_pitch": 0,
              "audio_speed": 100,
              "melody_transposition": null,
              "confidence": 100
            }
          ]
        },
        "melody": null,
        "phonetic": null,
        "video": null
      }
    }
  ]
}

Field Definitions¶

Match Details¶

Field	Type	Description
`query_match_duration_seconds`	float	Total duration of the matched portion in the query file (seconds).
`query_match_percentage`	float	Percentage of the query file matched to this asset.
`asset_match_duration_seconds`	float	Total duration of the matched portion in the catalog asset (seconds).
`asset_match_percentage`	float	Percentage of the catalog asset matched to this query.
`segments`	array	List of matched time ranges and transformation details.

Segment Details¶

Field	Type	Description
`query_start`	integer	Start timestamp in the query file (seconds).
`query_end`	integer	End timestamp in the query file (seconds).
`asset_start`	integer	Start timestamp in the catalog asset (seconds).
`asset_end`	integer	End timestamp in the catalog asset (seconds).
`audio_pitch`	integer \| null	Pitch modification in cents (e.g., `450` represents +4.5 semitones), or `0` for no change.
`audio_speed`	integer \| null	Speed modification percentage (e.g., `130` represents 1.3x speed), or `100` for unchanged.
`melody_transposition`	integer \| null	Semitone transposition detected for melody matching, or `null`.
`confidence`	integer	Confidence score of the match from `0` to `100`.