Get track UPCs

Returns known release UPCs for one Spotify track ID or one ISRC. Supply exactly one of ids or isrcs, with a single value; mixed selectors, repeated parameters and extra comma-separated values return HTTP 400 before lookup work. The plural parameter names and data[] envelope are retained for approved higher-volume accounts. Standard request-rate quotas continue to apply. Saved Track and UPC data is reused. A cold Spotify track is resolved through the existing Track Manager ingestion pipeline, which persists the Track and ISRC for future requests; this endpoint does not substitute a metadata-only resolver. Missing UPCs use the existing Apple/Deezer primitives. Spotify-ID requests have a 30-second client waiting budget; ISRC requests have a 10-second budget. A clean UPC miss follows the existing 30-day retry policy. If Track Manager returns no usable Track for a cold Spotify ID, the endpoint cannot distinguish a missing track from failed ingestion and returns a retryable per-input 503 with partial=true. Newly ingested occurrences use a short cache window while their asynchronous save settles; omitted occurrences set partial=true. Full discovered release lists and descriptive metadata live in the process cache, while anchored UPCs persist on Track documents. Another instance or a restart can therefore return fewer known UPCs, null release names/artists/dates and different confidence; absence of partial is not an exhaustive catalog guarantee. At most 50 saved occurrences are considered per ISRC and 100 distinct UPCs are returned per input; partial=true reports clipping or incomplete results. Large stored ISRC groups use the ID-based primitive to avoid materializing the entire group in the API process. The result represents known recording-to-release associations, not every release worldwide. Confidence does not imply that every Spotify occurrence belongs to the exact release. No discover, force, update or caller-controlled account-limit parameter is supported. No request queue is introduced; overloaded or unfinished lookup work returns a safe retryable error.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
ids
array of strings
length between 1 and 1

Spotify track IDs. Mutually exclusive with isrcs. Supply one value as a string, not repeated query parameters. Duplicate normalized values produce one result, in first-seen input order. Standard accounts may supply exactly one value. Approved API keys may have a negotiated higher limit, up to 10.

ids
isrcs
array of strings
length between 1 and 1

ISRCs, normalized to uppercase; common separators and an isrc: prefix are accepted. Mutually exclusive with ids. Supply one value as a string, not repeated query parameters. Duplicate normalized values produce one result, in first-seen input order. Standard accounts may supply exactly one value. Approved API keys may have a negotiated higher limit, up to 10.

isrcs
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json