OrbTop

Deezer Music Catalog API Scraper

DEVELOPER TOOLSAI
Try on Apify

Deezer Music Catalog API Scraper

Search and retrieve music catalog data from Deezer's public API — tracks, artists, albums, and playlists — without any authentication. Exposes ISRC and UPC join keys, BPM, gain, and popularity rank fields unavailable in most competing actors.

What it does

  • Searches Deezer's catalog by keyword across any entity type: track, artist, album, playlist, or chart
  • Handles offset-based pagination automatically, respecting Deezer's 50 req/5s rate limit
  • Optionally fetches full track detail records (BPM, gain, ISRC, track position, disk number) via fetchDetails: true
  • Supports comma-separated batch queries for multi-keyword runs in a single execution
  • Chart mode (entityType: chart) returns trending tracks for any Deezer genre without a keyword

Why use this

Deezer is the last major streaming catalog with a public, auth-free API. Spotify now requires OAuth; Apple Music requires an enterprise token. Deezer's API returns 90M+ tracks with cross-platform join fields:

  • ISRC — standard track identifier; joins to MusicBrainz, Discogs, Apple Music
  • UPC — album barcode; joins to Discogs, Amazon, Bandcamp
  • BPM / gain — audio features for music-analysis workflows

Input

Field Type Description
query string Search keyword(s). Comma-separate for batch: "radiohead, jazz". Required unless entityType is "chart".
entityType string One of: track (default), artist, album, playlist, chart
genreId integer Genre ID for chart mode. 0 = global top. Examples: 85 = Alternative, 132 = Pop, 116 = Rap/Hip-Hop, 106 = Electronic, 152 = Jazz
fetchDetails boolean When true and entityType is track, fetches detail pages for BPM, gain, ISRC, track position, and disk number. Slower but richer data. Default: false
maxItems integer Maximum records to return. Deezer caps searches at 2000 per query. Default: 50

Output

Each record contains:

Field Description
id Deezer entity ID
type track, artist, album, or playlist
title Track/album title, or artist name
artist_id, artist_name, artist_picture Artist info
album_id, album_title, album_cover Album info (tracks/albums)
duration Track length in seconds
isrc International Standard Recording Code (tracks)
upc Universal Product Code / album barcode (albums)
rank Deezer popularity rank
explicit_lyrics Explicit content flag
bpm Beats per minute (requires fetchDetails: true)
gain Loudness gain in dB (requires fetchDetails: true)
release_date Release date (YYYY-MM-DD)
nb_tracks Track count (albums, playlists)
nb_fan Artist follower count
preview_url 30-second preview MP3 URL
deezer_url Canonical Deezer URL

Example inputs

Search tracks by an artist:

{
  "query": "radiohead",
  "entityType": "track",
  "maxItems": 100
}

Get album catalog with UPC join keys:

{
  "query": "ok computer",
  "entityType": "album",
  "maxItems": 20
}

Get global top chart:

{
  "entityType": "chart",
  "genreId": 0,
  "maxItems": 50
}

Rich track data with BPM and ISRC:

{
  "query": "jazz",
  "entityType": "track",
  "fetchDetails": true,
  "maxItems": 25
}

Rate limits

Deezer's public API allows approximately 50 requests per 5 seconds. This actor throttles to 5 requests per second (200ms delay between pages) and handles paginated results automatically. No proxy or authentication is required.

Notes

  • Deezer caps search results at index 2000 — queries matching millions of tracks will be capped there
  • track_position, disk_number, bpm, gain, and release_date are only populated on track records when fetchDetails: true
  • Chart mode returns top tracks only; to get top artists or albums, search directly by genre keyword
Try on Apify