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. Apple Music and Spotify are searched in the storefront and market the calling user chose in the musiccompanion. settings, or the service default when none is set. Each lookup in which at least one source returned status succeeded 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).