| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Retrieve a paginated collection of songs. The data array contains songs, and included contains the artists and audio files referenced by those songs. Match each relationship ID to its full resource in included.
The first resource in each song's relationships.artists.data array is the primary artist. The first resource in relationships.audio_files.data is the primary audio file. By default, only the primary audio file is included to limit response size. Set filter[include_alternate_audio_files]=true to include every audio file for each returned song.
Use filter[isrc] to find songs by International Standard Recording Code. Supply a 12-character ISRC; matching ignores hyphens and whitespace and is case-insensitive. An ISRC can belong to more than one song, so this endpoint always returns a collection. Songs that have not been released to digital streaming platforms do not have an ISRC and cannot match this filter.
Example request
This request finds songs with an ISRC and requests up to 10 results. USABC1234567 and US-ABC-12-34567 are equivalent values.
curl --get "https://api.soundstripe.com/v1/songs" \
-H "Authorization: Token YOUR_API_KEY" \
-H "Accept: application/vnd.api+json" \
--data-urlencode "filter[isrc]=US-ABC-12-34567" \
--data-urlencode "page[size]=10"Responses
A successful request returns 200, including pagination links in the top-level links object. A valid filter that has no matches returns an empty data array with 200. An invalid ISRC returns 400; requests without a valid API key return 401; an expired, inactive, or unauthorized key returns 403. filter[q] values longer than 512 characters return 413. See Pagination for traversal details and The song object for the song attributes returned in each result.