# Social Fetch API - Deezer endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

36 documented Deezer operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/deezer/tracks/{trackId}
Get Deezer track
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/tracks/trackid/get.mdx
SDK: client.deezer.getTrack({ trackId: "3135556" })
Parameters:
- trackId (required, string) - Deezer track id, for example `3135556`.
- language (optional, string) - Two-letter language code for editorial text, such as `fr`. Titles and names are not translated. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/tracks/3135556" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/tracks/isrc/{isrc}
Get Deezer track by ISRC
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/tracks/isrc/isrc/get.mdx
SDK: client.deezer.getTrackByIsrc({ isrc: "GBDUW0000059" })
Parameters:
- isrc (required, string) - ISRC of the recording, for example `GBDUW0000059`.
- language (optional, string) - Two-letter language code for editorial text, such as `fr`. Titles and names are not translated. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/tracks/isrc/GBDUW0000059" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/tracks
Get several Deezer tracks
Credit cost: 1 credit per id. Up to 200 ids per request. Max 200 credits. An id Deezer does not know is still charged. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/tracks/get.mdx
SDK: client.deezer.getTracks({ ids: "3135556,916424" })
Parameters:
- ids (required, array) - Comma-separated Deezer track ids, 1 to 200.
curl "https://api.socialfetch.dev/v1/deezer/tracks?ids=3135556,916424" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/tracks/{trackId}/lyrics
Get Deezer track lyrics
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/tracks/trackid/lyrics/get.mdx
SDK: client.deezer.getTrackLyrics({ trackId: "3135556" })
Parameters:
- trackId (required, string) - Deezer track id, for example `3135556`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/tracks/3135556/lyrics" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/albums/{albumId}
Get Deezer album
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/albums/albumid/get.mdx
SDK: client.deezer.getAlbum({ albumId: "302127" })
Parameters:
- albumId (required, string) - Deezer album id, for example `302127`.
- language (optional, string) - Two-letter language code for editorial text, such as `fr`. Titles and names are not translated. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/albums/302127" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/albums/upc/{upc}
Get Deezer album by barcode
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/albums/upc/upc/get.mdx
SDK: client.deezer.getAlbumByUpc({ upc: "724384960650" })
Parameters:
- upc (required, string) - UPC or EAN barcode of the album, for example `724384960650`.
- language (optional, string) - Two-letter language code for editorial text, such as `fr`. Titles and names are not translated. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/albums/upc/724384960650" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/albums
Get several Deezer albums
Credit cost: 1 credit per id. Up to 200 ids per request. Max 200 credits. An id Deezer does not know is still charged. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/albums/get.mdx
SDK: client.deezer.getAlbums({ ids: "302127,1262014" })
Parameters:
- ids (required, array) - Comma-separated Deezer album ids, 1 to 200.
curl "https://api.socialfetch.dev/v1/deezer/albums?ids=302127,1262014" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/artists/{artistId}
Get Deezer artist
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/artists/artistid/get.mdx
SDK: client.deezer.getArtist({ artistId: "27" })
Parameters:
- artistId (required, string) - Deezer artist id, for example `27`.
- language (optional, string) - Two-letter language code for editorial text, such as `fr`. Titles and names are not translated. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/artists/27" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/artists
Get several Deezer artists
Credit cost: 1 credit per id. Up to 200 ids per request. Max 200 credits. An id Deezer does not know is still charged. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/artists/get.mdx
SDK: client.deezer.getArtists({ ids: "27,13" })
Parameters:
- ids (required, array) - Comma-separated Deezer artist ids, 1 to 200.
curl "https://api.socialfetch.dev/v1/deezer/artists?ids=27,13" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/artists/{artistId}/top-tracks
List Deezer artist top tracks
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/artists/artistid/top-tracks/get.mdx
SDK: client.deezer.listArtistTopTracks({ artistId: "27" })
Parameters:
- artistId (required, string) - Deezer artist id, for example `27`.
- limit (optional, integer) - Items per page, 1 to 100. Default: 50.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/artists/27/top-tracks" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/artists/{artistId}/albums
List Deezer artist releases
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/artists/artistid/albums/get.mdx
SDK: client.deezer.listArtistAlbums({ artistId: "27" })
Parameters:
- artistId (required, string) - Deezer artist id, for example `27`.
- role (optional, string, enum: main | featured) - `main` (default) lists the artist's own releases; `featured` lists releases they appear on.
- includeNonOfficial (optional, boolean) - Also list releases that are not official artist releases but credit the artist. Default: false.
- recordType (optional, string, enum: album | ep | single) - Only releases of this type.
- subType (optional, string, enum: studio | live | compilation | karaoke) - Only releases of this kind.
- sort (optional, string, enum: title | newest | popular) - Order of the list. Default: `newest`.
- limit (optional, integer) - Items per page, 1 to 500. Default: 100.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/artists/27/albums" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/artists/{artistId}/related
List Deezer related artists
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/artists/artistid/related/get.mdx
SDK: client.deezer.listRelatedArtists({ artistId: "27" })
Parameters:
- artistId (required, string) - Deezer artist id, for example `27`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/artists/27/related" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/artists/{artistId}/playlists
List Deezer artist playlists
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/artists/artistid/playlists/get.mdx
SDK: client.deezer.listArtistPlaylists({ artistId: "27" })
Parameters:
- artistId (required, string) - Deezer artist id, for example `27`.
- limit (optional, integer) - Items per page, 1 to 100. Default: 50.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/artists/27/playlists" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/artists/{artistId}/mix
Get Deezer artist mix
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/artists/artistid/mix/get.mdx
SDK: client.deezer.getArtistMix({ artistId: "27" })
Parameters:
- artistId (required, string) - Deezer artist id, for example `27`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/artists/27/mix" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/artists/{artistId}/events
List Deezer artist concerts
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/artists/artistid/events/get.mdx
SDK: client.deezer.listArtistEvents({ artistId: "119" })
Parameters:
- artistId (required, string) - Deezer artist id, for example `119`.
- type (optional, string, enum: concert | festival) - Only this kind of event. Default: both.
- near (optional, string) - Sort by distance from this point, `latitude,longitude`. Default: soonest first. With `near`, `type` is applied to each page after Deezer sorts by distance, so a page can hold fewer than `limit` events.
- limit (optional, integer) - Items per page, 1 to 100. Default: 50.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/artists/119/events" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/events/{eventId}
Get Deezer event
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/events/eventid/get.mdx
SDK: client.deezer.getEvent({ eventId: "13515852" })
Parameters:
- eventId (required, string) - Deezer event id, for example `13515852`. An event id stops resolving after its date, so take a current id from the events list.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/events/13515852" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/events
List Deezer events
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/events/get.mdx
SDK: client.deezer.listEvents({ query: "London" })
Parameters:
- query (optional, string) - A place or an act, for example `London` or `Metallica`. Without it the endpoint lists events Deezer still marks as pending in the United Kingdom.
- type (optional, string, enum: concert | festival) - Only this kind of event. Default: both.
- limit (optional, integer) - Items per page, 1 to 100. Default: 50.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
curl "https://api.socialfetch.dev/v1/deezer/events?query=London" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/playlists/{playlistId}
Get Deezer playlist
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/playlists/playlistid/get.mdx
SDK: client.deezer.getPlaylist({ playlistId: "908622995" })
Parameters:
- playlistId (required, string) - Deezer playlist id, for example `908622995`.
- language (optional, string) - Two-letter language code for editorial text, such as `fr`. Titles and names are not translated. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/playlists/908622995" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/playlists
Get several Deezer playlists
Credit cost: 1 credit per id. Up to 200 ids per request. Max 200 credits. An id Deezer does not know is still charged. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/playlists/get.mdx
SDK: client.deezer.getPlaylists({ ids: "908622995,1313621735" })
Parameters:
- ids (required, array) - Comma-separated Deezer playlist ids, 1 to 200.
curl "https://api.socialfetch.dev/v1/deezer/playlists?ids=908622995,1313621735" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/playlists/{playlistId}/tracks
List Deezer playlist tracks
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/playlists/playlistid/tracks/get.mdx
SDK: client.deezer.listPlaylistTracks({ playlistId: "908622995" })
Parameters:
- playlistId (required, string) - Deezer playlist id, for example `908622995`.
- limit (optional, integer) - Items per page, 1 to 1000. Default: 100.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/playlists/908622995/tracks" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/search
Search Deezer
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/search/get.mdx
SDK: client.deezer.search({ query: "daft punk", type: "artist" })
Parameters:
- query (required, string) - What to search for, such as `daft punk` or `AC/DC`.
- type (optional, string, enum: track | artist | album | playlist | show | episode | station | user) - What to search. Default: `track`.
- limit (optional, integer) - Items per page, 1 to 100. Default: 50.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
curl "https://api.socialfetch.dev/v1/deezer/search?query=daft%20punk" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/charts
Get Deezer chart
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/charts/get.mdx
SDK: client.deezer.getCharts({ type: "tracks" })
Parameters:
- type (optional, string, enum: tracks | albums | artists | playlists | podcasts) - Which chart. Default: `tracks`.
- genreId (optional, string) - Genre id from the genres list; `0` (default) is all genres.
- country (optional, string) - Two-letter country code for the tracks chart, for example `BR`. Only with `type=tracks` and all genres; the other charts follow Deezer's default region.
- limit (optional, integer) - Items per page, 1 to 300. Default: 100.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/charts?type=tracks" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/genres
List Deezer genres
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/genres/get.mdx
SDK: client.deezer.listGenres({})
Parameters:
- language (optional, string) - Two-letter language code for editorial text, such as `fr`. Titles and names are not translated. Default: `en`.
curl "https://api.socialfetch.dev/v1/deezer/genres" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/genres/{genreId}/artists
List Deezer genre artists
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/genres/genreid/artists/get.mdx
SDK: client.deezer.listGenreArtists({ genreId: "132" })
Parameters:
- genreId (required, string) - Genre id from the genres list, or `0` for all genres.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/genres/132/artists" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/pages
Get Deezer editorial page
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/pages/get.mdx
SDK: client.deezer.getPages({ path: "channels/charts" })
Parameters:
- path (optional, string) - Which page: `home`, `channels/explore`, `channels/charts`, `channels/moods`, `channels/genres`, `channels/radios`, `channels/podcasts`, any `channels/{slug}` or a section's `moreTarget`. Default: `home`.
- language (optional, string) - Two-letter language code for editorial text, such as `fr`. Titles and names are not translated. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/pages?path=channels/charts" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/radios
List Deezer radios
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/radios/get.mdx
SDK: client.deezer.listRadios({})
Parameters:
- genreId (optional, string) - Only the radios of this genre.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/radios" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/radios/{radioId}/tracks
Get Deezer radio tracks
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/radios/radioid/tracks/get.mdx
SDK: client.deezer.listRadioTracks({ radioId: "38305" })
Parameters:
- radioId (required, string) - Deezer radio id from the radios list, for example `38305`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/radios/38305/tracks" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/stations/{stationId}
Get Deezer station
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/stations/stationid/get.mdx
SDK: client.deezer.getStation({ stationId: "15202" })
Parameters:
- stationId (required, string) - Deezer internet radio station id, for example `15202`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/stations/15202" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/shows/{showId}
Get Deezer show
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/shows/showid/get.mdx
SDK: client.deezer.getShow({ showId: "1189202" })
Parameters:
- showId (required, string) - Deezer podcast show id, for example `1000702442`.
- language (optional, string) - Two-letter language code for editorial text, such as `fr`. Titles and names are not translated. Default: `en`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/shows/1189202" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/shows/{showId}/episodes
List Deezer show episodes
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/shows/showid/episodes/get.mdx
SDK: client.deezer.listShowEpisodes({ showId: "1189202" })
Parameters:
- showId (required, string) - Deezer podcast show id, for example `1000702442`.
- limit (optional, integer) - Items per page, 1 to 100. Default: 50.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/shows/1189202/episodes" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/episodes/{episodeId}
Get Deezer episode
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/episodes/episodeid/get.mdx
SDK: client.deezer.getEpisode({ episodeId: "526673645" })
Parameters:
- episodeId (required, string) - Deezer podcast episode id, for example `871770701`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/episodes/526673645" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/users/{userId}
Get public Deezer account
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/users/userid/get.mdx
SDK: client.deezer.getUser({ userId: "5" })
Parameters:
- userId (required, string) - Deezer account id, for example `753546365`.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/users/5" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/users/{userId}/playlists
List Deezer account playlists
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/users/userid/playlists/get.mdx
SDK: client.deezer.listUserPlaylists({ userId: "5" })
Parameters:
- userId (required, string) - Deezer account id, for example `753546365`.
- limit (optional, integer) - Items per page, 1 to 100. Default: 50.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `private`
curl "https://api.socialfetch.dev/v1/deezer/users/5/playlists" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/users/{userId}/library
List Deezer account favourites
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/users/userid/library/get.mdx
SDK: client.deezer.listUserLibrary({ userId: "5", kind: "albums" })
Parameters:
- userId (required, string) - Deezer account id, for example `753546365`.
- kind (required, string, enum: albums | artists | tracks) - Which part of the library to list.
- limit (optional, integer) - Items per page, 1 to 100. Default: 50.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `private`
curl "https://api.socialfetch.dev/v1/deezer/users/5/library?kind=albums" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/users/{userId}/connections
List Deezer account connections
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/users/userid/connections/get.mdx
SDK: client.deezer.listUserConnections({ userId: "5", kind: "followers" })
Parameters:
- userId (required, string) - Deezer account id, for example `753546365`.
- kind (required, string, enum: followers | following) - Which side of the follow relationship to list.
- limit (optional, integer) - Items per page, 1 to 1000. Default: 100.
- cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. Keep the other parameters the same.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
Outcome field: `data.lookupStatus` in `found`, `not_found`, `private`
curl "https://api.socialfetch.dev/v1/deezer/users/5/connections?kind=followers" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/deezer/oembed
Get Deezer page embed
Credit cost: 1 credit. Failed requests are free.
Auth: API key or x402 payment (no key needed for payment)
Docs: https://www.socialfetch.dev/docs/api/v1/deezer/oembed/get.mdx
SDK: client.deezer.getOembed({ url: "https://www.deezer.com/track/3135556" })
Parameters:
- url (required, string) - A Deezer track, album, playlist, show or episode page URL.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/deezer/oembed?url=https://www.deezer.com/track/3135556" \
  -H "x-api-key: YOUR_API_KEY"