Fetch and aggregate track metadata from the selected sources
POST/api/v1/musiccompanion/metadata/lookup
The Search & Enrich aggregation as one synchronous call: the configured sources are queried server-side, the results run through the same similarity filtering as the product UI, and the response carries one aggregated best-value per field with a confidence score. Search by text metadata, by ISRC or EAN, or by an AcoustID (Chromaprint) audio fingerprint; a fingerprint-identified recording also restricts which results may enter the aggregation. Each lookup that reached at least one source bills one search on the search.metadata-enrichment meter.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 429
- 500
- 502
- 503
The aggregated metadata.
No search criterion was provided (invalid_request), or the isrc/ean is malformed (invalid_isrc, invalid_ean).
Missing or invalid bearer token.
The token lacks the required permission.
No release matches the barcode (ean_not_found).
The barcode resolves to a multi-track release and no title was given to pick one (ean_ambiguous).
Rate limit exceeded. Retry after the period in the Retry-After header.
Unexpected server error.
An identifier provider could not be reached: the fingerprint could not be resolved (fingerprint_failed) or the barcode could not be resolved (ean_failed).
Fingerprint lookups are not configured on this server (fingerprint_unavailable).