# Search Response ### Interpreting a Search Response A search may result in zero or many matches. If one or more assets are matched, the search response conveys the following information: * Matched Assets - the "provided ID" of the matched asset(s) * Match Details - the details of the match including match duration, match segments and any modification details Below is an example of a search response for an `audio` search that matched to one asset: ```json { "lookup_ids": [ "522174538802801153" ], "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": 450, "audio_speed": 130, "melody_transposition": null, "confidence": 100 } ] }, "melody": null, "video": null } } ] } ``` Below is an example of a search response for a `melody` search that matched to one asset: ```json { "lookup_ids": [ "522174538802801153" ], "query_file_duration_seconds": 158.0, "matches": [ { "provided_id": "my_custom_asset_id_123", "match_details": { "audio": null, "melody": { "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": null, "audio_speed": null, "melody_transposition": 5, "confidence": 100 } ] }, "video": null } } ] } ``` Below is an example of a search response for a `video` search that matched to one asset: ```json { "lookup_ids": [ "522174538802801153" ], "query_file_duration_seconds": 158.0, "matches": [ { "provided_id": "my_custom_asset_id_123", "match_details": { "audio": null, "melody": null, "video": { "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": null, "audio_speed": null, "melody_transposition": null, "confidence": 100 } ] } } } ] } ``` ### Search Response Glossary Below is a description of the fields provided in a search response:
FieldDescription
lookup_idsUnique identifier(s) representing a particular search
query_file_duration_secondsTotal duration of the file submitted for search
matchesMatch information for assets identified in the search
.provided_idCustom ID of the identified asset
.match_detailsMatch details between the submitted file (query) and the identified asset
..audio (or ..melody)Audio or Melody match details between query and identified asset
...query_match_duration_secondsMatch duration of the query that matched to the identified asset
...query_match_percentageMatch percentage (query match duration / query duration) of the query that matched to the identified asset
...asset_match_duration_secondsMatch duration of the identified asset that matched to query
...asset_match_percentageMatch percentage (asset match duration / asset duration) of the identified asset that matched to query
...segmentsDetails about the match segments between the submitted file (query) and the identified asset
....query_startStart point of the query's match segment that matched to the identified asset
....query_endEnd point of the query's match segment that matched to the identified asset
....asset_startStart point of the asset's match segment that matched to the query
....asset_endEnd point of the asset's match segment that matched to the query
....audio_pitchFor audio matches only: Difference in pitch (in terms of cents) between the query and the identified asset. For example a value of 0 indicates the pitch of both the query segment and the asset segment is the same. A value of 400 indicates the pitch of the query segment is 400 cents higher (or 4 semitones higher) than the speed of the asset segment
....audio_speedFor audio matches only: Difference in speed (in terms of %) between the query and the identified asset. For example a value of 100 indicates the speed of both the query segment and the asset segment is the same. A value of 125 indicates the speed of the query segment is 25% faster than the speed of the asset segment
....melody_transpositionFor melody matches only: Pitch transposition (in terms of semitones) between the query and the identified asset. For example a value of 0 indicates the there is no transposition between the query segment and the asset segment. A value of -2 indicates the query segment is 2 semitones lower than the identified asset segment
....confidenceThe confidence score reflects the system's certainty about each segment decision, providing a relative measure of certainty for each match, ranging from 85 to 100. While the score indicates how closely a segment matches, it’s intended to aid in QA prioritization rather than serve as a strict measure of match accuracy or consistency.
For more information on how best to use the confidence score, please visit our FAQ
--- # Agent Instructions: 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/sdk-integration/search-custom-database/search-response.md?ask= ``` 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.