Search Deezer
Search Deezer for tracks, artists, albums, playlists, podcasts, episodes, radio stations and accounts.
Headers
Get your API keyAPI key (`sfk_...`)
What to search for, such as `daft punk` or `AC/DC`.
min 1 chars · max 200 chars
What to search. Default: `track`.
one of: track, artist, album, playlist, show, episode, station, user
Items per page, 1 to 100. Default: 50.
≥ 1 · ≤ 100
Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.
min 1 chars · max 1000 chars
Endpoint-specific response payload.
The query searched for.
What was searched.
one of: track, artist, album, playlist, show, episode, station, user
Matches when `type` is `track`; otherwise null.
Track id.
Track title, version included.
Track title without the version.
Version label such as `(Radio Edit)`; null for most tracks.
International Standard Recording Code.
Track page URL.
Duration in milliseconds.
Position on the disc.
Disc number.
Deezer's popularity score for the track.
Whether the lyrics are marked explicit.
Whether Deezer can play the track in its catalogue.
A 30 second audio preview. The link is signed and stops working about 15 minutes after the response.
When the preview link stops working (ISO-8601, UTC).
When the track was added to the playlist; null outside playlists (ISO-8601, UTC).
The main artist.
Artist id.
Artist name.
Artist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
The album.
Album id.
Album title.
Album page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Matches when `type` is `artist`; otherwise null.
Artist id.
Artist name.
Artist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Number of fans; null when the record does not carry one.
Matches when `type` is `album`; otherwise null.
Album id.
Album title.
Album page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Release type.
one of: album, ep, single, compilation, null
Release date. Deezer's original release date when it gives one, otherwise its release date. (YYYY-MM-DD).
Number of tracks.
Number of fans; null when the record does not carry one.
Whether the album is marked explicit.
The main artist.
Artist id.
Artist name.
Artist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Matches when `type` is `playlist`; otherwise null.
Playlist id.
Playlist title.
Playlist page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Number of tracks.
Number of fans; null when the record does not carry one.
Total duration in milliseconds.
Description.
Whether the playlist is public.
The account that made the playlist.
Account id of the creator.
Display name of the creator.
Matches when `type` is `show`; otherwise null.
Show id.
Show title.
Show page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Description.
Number of fans; null when the record does not carry one.
Whether the show is available.
Matches when `type` is `episode`; otherwise null.
Episode id.
Episode title.
Episode page URL.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Description.
Duration in milliseconds.
When the episode was released (ISO-8601, UTC).
Whether the episode is available.
Whether the show the episode belongs to is marked explicit (Deezer flags it per show).
The show the episode belongs to.
Show id.
Show title.
Matches when `type` is `station`; otherwise null.
Station id.
Station name.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Country code of the station.
Description.
Matches when `type` is `user`; otherwise null.
Account id.
Display name chosen by the account holder.
Account page URL, as Deezer lists it.
Picture URLs in four sizes.
Image identifier; every size URL is built from it. Null when the item has no picture of its own.
Small image URL (about 56 px).
Medium image URL (about 250 px).
Large image URL (about 500 px).
Extra-large image URL (about 1000 px).
Country code the account holder gave, when public.
Number of matches Deezer will list for the query. It never exceeds about 300.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
True when the list reached Deezer's cap of about 300 results for a query; refine the query to reach more.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/deezer/search?query=daft%20punk" \
-H "x-api-key: YOUR_API_KEY"Responses
Deezer search results.