Deezer Music Scraper

Scrape music data from Deezer — the world's largest music streaming platform with over 90 million tracks. Search for tracks, artists, albums, and playlists using any keyword. No API key or account required.

What This Actor Does

Deezer Music Scraper connects to Deezer's public REST API and returns structured music data based on your search query. You can search across four data types:

• Tracks — song title, artist, album, duration, popularity rank, explicit flag, and preview URL
• Artists — artist name, fan count, album count, and profile image
• Albums — album title, artist, track count, release date, cover art, and explicit flag
• Playlists — playlist title, creator, track count, fan count, and public/private status

This actor is perfect for music analytics, content research, playlist curation, and music metadata enrichment workflows.

Input Fields

Field	Type	Required	Default	Description
mode	Select	Yes	searchTracks	What to search: searchTracks, searchArtists, searchAlbums, searchPlaylists
searchQuery	String	Yes	—	Keyword to search (e.g. "Taylor Swift", "jazz", "Beatles")
maxItems	Integer	No	20	Maximum records to return (1–500)

Output Fields

Tracks (mode: searchTracks)

Field	Type	Description
trackId	String	Deezer internal track ID
title	String	Track title
artistName	String	Artist name
albumTitle	String	Album title
duration	Integer	Duration in seconds
rank	Integer	Deezer popularity rank
explicit	Boolean	Whether the track has explicit content
previewUrl	String	30-second MP3 preview URL
sourceUrl	String	Full Deezer track page URL
scrapedAt	String	ISO 8601 timestamp when scraped

Artists (mode: searchArtists)

Field	Type	Description
artistId	String	Deezer internal artist ID
name	String	Artist name
fanCount	Integer	Number of fans on Deezer
albumCount	Integer	Number of albums on Deezer
imageUrl	String	Artist profile image URL
sourceUrl	String	Full Deezer artist page URL
scrapedAt	String	ISO 8601 timestamp when scraped

Albums (mode: searchAlbums)

Field	Type	Description
albumId	String	Deezer internal album ID
title	String	Album title
artistName	String	Artist name
trackCount	Integer	Number of tracks in the album
releaseDate	String	Release date (YYYY-MM-DD)
coverUrl	String	Album cover image URL (high resolution)
explicit	Boolean	Whether the album has explicit content
sourceUrl	String	Full Deezer album page URL
scrapedAt	String	ISO 8601 timestamp when scraped

Playlists (mode: searchPlaylists)

Field	Type	Description
playlistId	String	Deezer internal playlist ID
title	String	Playlist title
creatorName	String	Username of playlist creator
trackCount	Integer	Number of tracks in the playlist
fanCount	Integer	Number of fans following the playlist
publicPlaylist	Boolean	Whether the playlist is public
sourceUrl	String	Full Deezer playlist page URL
scrapedAt	String	ISO 8601 timestamp when scraped

Example

Input

{
  "mode": "searchTracks",
  "searchQuery": "Taylor Swift",
  "maxItems": 3
}

Output

[
  {
    "trackId": "67238735",
    "title": "Shake It Off",
    "artistName": "Taylor Swift",
    "albumTitle": "1989",
    "duration": 219,
    "rank": 987654,
    "explicit": false,
    "previewUrl": "https://cdns-preview-d.dzcdn.net/stream/c-abcdef1234567890.mp3",
    "sourceUrl": "https://www.deezer.com/track/67238735",
    "scrapedAt": "2026-06-01T12:00:00+00:00"
  },
  {
    "trackId": "54249538",
    "title": "Blank Space",
    "artistName": "Taylor Swift",
    "albumTitle": "1989",
    "duration": 231,
    "rank": 876543,
    "explicit": false,
    "previewUrl": "https://cdns-preview-5.dzcdn.net/stream/c-abcdef0987654321.mp3",
    "sourceUrl": "https://www.deezer.com/track/54249538",
    "scrapedAt": "2026-06-01T12:00:00+00:00"
  }
]

Frequently Asked Questions

Q: Do I need an API key or Deezer account to use this actor?
A: No. Deezer's public search API is completely free and requires no authentication. This actor works out of the box with zero configuration beyond your search query.

Q: How many results can I get per run?
A: You can retrieve up to 500 results per run using the maxItems field. Deezer's API paginates results in batches of 25, so the actor automatically fetches multiple pages when needed.

Q: Are the preview URLs always accessible?
A: Preview URLs are 30-second MP3 clips hosted on Deezer's CDN (cdns-preview-*.dzcdn.net). These are publicly accessible without authentication. Some tracks may not have a preview if Deezer hasn't processed one.

Q: What does the popularity rank field represent?
A: The rank field is Deezer's internal popularity score — a higher number means the track is more popular on the platform. It reflects recent streaming activity and is updated regularly by Deezer.