Get track by ISRC

Resolves an ISRC to one canonical Spotify track by default (type track), preserving the existing single-track behavior and snapshot opt-in. The canonical selection prefers active and playable occurrences, valid popularity, playlist presence, then a stable Spotify ID tie-break. Set returnMultiple=true for a page of stored occurrences (type track_isrc_occurences); this mode never performs external discovery or ingestion. Default and maximum limit: 100. Sort: valid popularity descending, unknown popularity last, then Spotify ID ascending. Follow pagination.nextCursor until hasMore=false to retrieve subsequent stored matches. update=true and includeSnapshots=true are invalid in multiple mode. limit/cursor require multiple mode. A stored multiple miss returns HTTP 200 with data:[]; a single-track miss returns HTTP 404. Stored lookup client waiting budget: 10 seconds, including databaseOnly single-track lookups. Ordinary pagination is not marked partial. Track responses omit private metaData.upc bookkeeping; multiple-mode responses also omit all metaData and snapshot fields. The cursor is opaque and scoped to this ISRC; ordering reflects the current catalog, which can change between requests. This provides all stored matches across pages, not a global list of DSP editions.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

International Standard Recording Code. Accepts a 12-character ISRC such as USUG12000497; common separators and an isrc: prefix are normalized before lookup.

Query Params
boolean

Returns database-only data, unless the entity has not been ingested yet. Useful for speed.

boolean

Force the service to refresh the data before returning. This will increase latency but provide the most up-to-date data.

boolean

Performs a database-only lookup, skipping external API calls. Useful for speed, or testing if we've ingested the data.

boolean
Defaults to false

Include historical snapshots; omitted or false excludes history. Metrics on each snapshot are optional: absent or null means unknown, while 0 is a real measurement. Partial rows retain independent valid metrics and their capture time.

boolean
Defaults to false

Return a stored page of matching Spotify occurrences instead of a canonical single track. History, forced refresh and external discovery are unavailable in this mode.

integer
1 to 100
Defaults to 100

Stored occurrences per page. Available only in multiple mode; at most 100 tracks are hydrated.

string
length between 1 and 512
^[A-Za-z0-9_-]+$

Opaque nextCursor returned by the previous page for this ISRC. Omit it for the first page.

Responses

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