# Deezer Scraper: Tracks, Artists, Albums & Charts (`recordsdata/deezer-music-scraper`) Actor Scrape Deezer without an API key: search tracks, artists and albums, pull the global Top 100 charts, and get artist profiles with fan counts, top tracks and discographies. Export CSV, Excel, JSON, XML. No login. Pay per row, 5.2M fans tracked for Daft Punk. - **URL**: https://apify.com/recordsdata/deezer-music-scraper.md - **Developed by:** [RecordsData](https://apify.com/recordsdata) (community) - **Categories:** Videos, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README

PunkRecordsData

## ๐ŸŽง Deezer Scraper: Tracks, Artists, Albums & Charts > **Deezer Scraper exports Deezer music data without an API key: search tracks, artists and albums, pull the global Top 100 charts, and get artist profiles with fan counts, top tracks and discographies. Each track row has duration, popularity rank, explicit flag and a 30-second preview URL. Export CSV, Excel, JSON or XML. Pay per row, nothing for empty or failed rows.** Deezer Scraper turns Deezer's public catalog into clean datasets. A test search for "daft punk" reported 181 matching tracks, and the artist profile for Daft Punk (ID 27) showed 5,215,685 fans and 36 albums when checked on 2026-10-04. It is built for music marketers, A\&R teams, playlist and app developers, and analysts who need catalog metadata at scale. ### ๐Ÿ”Ž What does Deezer Scraper do? - **Search Deezer by keyword** for tracks, artists or albums, paginated up to 1,000 results per query. - **Scrape Deezer global charts**: Top tracks, Top albums and Top artists, 100 positions each, with chart position. - **Get Deezer artist profiles** by ID or URL: name, fan count, album count and picture. - **Export an artist's top tracks and discography**: up to 50 top tracks and 100 albums per artist. - **Run on a schedule** to snapshot charts or track fan growth over time. ### ๐Ÿ“Š What data can you extract from Deezer? | Record type | Fields | |---|---| | Track (`track`, `chart-track`, `artist-top-track`) | `trackId`, `title`, `artist`, `album`, `durationSec`, `deezerRank`, `explicit`, `previewUrl`, `coverUrl`, `url`, `chartPosition` (charts), `artistRank` (top tracks) | | Artist (`artist`, `chart-artist`) | `artistId`, `name`, `fans`, `albumCount`, `pictureUrl`, `url`, `chartPosition` (charts) | | Album (`album`, `chart-album`, `artist-album`) | `albumId`, `title`, `artist`, `trackCount`, `releaseDate`, `recordKind`, `explicit`, `coverUrl`, `url`, `chartPosition` (charts) | Every row also has `recordType` and `scrapedAt`. Fields Deezer does not provide for a row are left out instead of filled with placeholders, so you do not get empty columns. ### ๐Ÿงพ Sample output Real row from a run of the track search (`previewUrl` shortened here, the dataset has the full signed URL): ```json { "recordType": "track", "trackId": "3135563", "title": "Veridis Quo", "artist": "Daft Punk", "album": "Discovery", "durationSec": 345, "deezerRank": 928445, "explicit": false, "previewUrl": "https://cdnt-preview.dzcdn.net/api/1/1/6/4/5/0/6456b666c0b1d4537e34d71e5cbd098c.mp3?hdnea=...", "coverUrl": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/250x250-000000-80-0-0.jpg", "url": "https://www.deezer.com/track/3135563", "scrapedAt": "2026-10-04T05:10:20.836Z" } ``` ### ๐Ÿ’ฐ How much does it cost to scrape Deezer? Pay per event. You pay for each result row saved to the dataset. Prices at the entry tier (higher Apify plans get lower prices on track rows): | Event | Price per row | Per 1,000 rows | |---|---|---| | Track row | $0.012 | $12.00 | | Artist row | $0.01 | $10.00 | | Album row | $0.01 | $10.00 | You are **not** charged for error rows, empty searches, "artist not found" rows, duplicates or runs that fail. Set a maximum cost per run in the Apify run options and the actor stops cleanly when it is reached. A 10-row test costs about $0.12 for tracks. ### ๐Ÿš€ How to scrape Deezer in 3 steps 1. Open the actor and click **Try for free**. 2. Enter a search query and type, or switch on **Global charts**, or paste artist IDs (for example `27`). 3. Set **Max Items**, click **Start**, then download CSV, Excel, JSON or XML from the dataset. Leaving every input empty runs a 10-row demo search for "daft punk", so API and MCP agents always get a valid result. ### โš™๏ธ Deezer Scraper input | Field | Type | Default | What it does | |---|---|---|---| | `searchQuery` | string | none | Keyword to search for tracks, artists or albums | | `searchType` | `track`, `artist`, `album` | `track` | Which record type the search returns | | `includeCharts` | boolean | `false` | Add the global Top charts | | `chartTypes` | array | `["tracks"]` | `tracks`, `albums`, `artists` | | `artistIds` | array | `[]` | Artist IDs or URLs for profiles | | `includeArtistTopTracks` | boolean | `true` | Top 50 tracks per artist ID | | `includeArtistAlbums` | boolean | `false` | Up to 100 albums per artist ID | | `maxItems` | integer | 10 prefill | Row cap across all sources (free plan: 10) | ```json { "searchQuery": "daft punk", "searchType": "track", "includeCharts": true, "chartTypes": ["tracks", "artists"], "artistIds": ["27"], "maxItems": 50 } ``` ### ๐Ÿ“ฆ Output Rows go to the default dataset with an Overview table view (cover, title or name, artist, chart position, rank, fans, release date, link). A search with no matches ends as SUCCEEDED with the message "No Deezer results matched this input" and no charge. If Deezer cannot be reached and zero rows are saved, the run is marked FAILED with a clear message. ### โš–๏ธ Deezer scraper vs alternatives Prices read from the public Apify Store on 2026-10-04 (per delivered row, before platform start fees where listed): | Actor | Pricing | Notes | |---|---|---| | This actor | $10 to $12 per 1,000 rows | Search, charts, artist profiles, top tracks and discographies in one actor | | parseforge/deezer-music-catalog-scraper | $41.90 per 1,000 results + $5 per 1,000 track details | Higher price | | lexis-solutions/deezer-artist-scraper | $9 per 1,000 rows + $0.005 per start | Artist-focused | | fortuitous\_pirate/deezer-scraper | $12.50 per 1,000 rows | Similar price | | velvety\_bedbug, benthepythondev, crawlerbros | $1.50 to $5 per 1,000 rows | Cheaper per row | We are not the cheapest per row. Several smaller Deezer actors charge less. What the price covers here: three record types plus charts and discographies in one run, cleaned rows without placeholder values, deduplication before billing, and a hard stop at your max cost. ### ๐ŸŽฏ Use cases - **A\&R scouting**: rank artists in a genre by fan count and track rank. - **Chart monitoring**: schedule daily Top 100 snapshots into a warehouse. - **App and playlist building**: seed catalog metadata with preview MP3 links. - **Catalog research**: pull full discographies with release dates for a list of artists. ### ๐Ÿ”Œ Run Deezer Scraper via API and integrations ```bash curl -X POST "https://api.apify.com/v2/acts/recordsdata~deezer-music-scraper/runs?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"includeCharts": true, "chartTypes": ["tracks"], "maxItems": 100}' ``` Use the Apify client for JavaScript or Python, schedule runs, or connect the dataset to Zapier, Make, n8n, Google Sheets or Slack. The actor also works through the Apify MCP server, so AI agents can call it with the input above. ### ๐Ÿ“œ Is it legal to scrape Deezer? The actor reads Deezer's public API endpoints for catalog data (tracks, artists, albums, charts) at a polite rate of about two requests per second, with no login. It collects no private user data. Preview URLs are Deezer's public 30-second clips; check Deezer's terms before reusing audio or artwork in a product. ### โ“ Frequently asked questions #### Does Deezer Scraper need an API key or login? No. It uses Deezer's public catalog endpoints, so you only need an Apify account. #### How many results can I get per search? Up to 1,000 rows per query (Deezer's pagination limit), capped by your `maxItems`. #### Why did I get 0 results? The query matched nothing on Deezer, or a chart or ID list was empty. The run still succeeds and you are not charged. Try a broader keyword or check the artist ID. #### Are the previews full songs? No. They are the 30-second preview MP3 links Deezer publishes. The signed URL expires after a while, so download previews soon after the run. #### How do I find Deezer artist IDs? Run a search with `searchType` set to `artist`; each row has `artistId`. The number in a deezer.com/artist/27 URL is the ID, and you can paste the full URL. #### What does `deezerRank` mean? Deezer's internal popularity score for a track. Higher means more popular, and it is comparable across the catalog. #### Am I charged for failed or duplicate rows? No. Error rows, not-found rows and duplicates are never billed. Rows are billed only after they are saved. #### Can I export to Excel or CSV? Yes. Download the dataset as CSV, Excel, JSON, XML, HTML or RSS from the run page or via API. ### ๐ŸŽถ Want more charts and rankings data? Try these other PunkRecordsData scrapers: - [Billboard Charts Scraper](https://apify.com/RecordsData/billboard-charts-scraper) for Billboard Hot 100 and other chart histories. - [Steam Charts Scraper](https://apify.com/RecordsData/steam-charts-scraper) for game player counts and rankings. - [Wikipedia Articles Scraper](https://apify.com/RecordsData/wikipedia-articles-scraper) for artist and album background text. ### ๐Ÿ›Ÿ Support Found a bug or a missing field? Open the Issues tab on this actor's page, or email contact.punkrecordsdata@gmail.com. Custom solutions on request. Last updated: 2026-10-03 # Actor input Schema ## `searchQuery` (type: `string`): Keyword to search the Deezer catalog for tracks, artists or albums, for example daft punk or reggaeton 2026. Leave empty and enable charts or add artist IDs to skip search. If everything is empty the actor runs a 10-row demo search for daft punk. ## `searchType` (type: `string`): Type of Deezer record the search query returns: track, artist or album. Default is track. ## `includeCharts` (type: `boolean`): Set to true to scrape Deezer's global Top charts (positions 1 to 100) for the chart types selected below. ## `chartTypes` (type: `array`): Which global charts to pull: tracks, albums and/or artists. Used only when Global charts is enabled. ## `artistIds` (type: `array`): Deezer artist IDs or artist URLs, one per line, for profiles with fan counts and album counts, for example 27 for Daft Punk. Find IDs by searching with type artist. ## `includeArtistTopTracks` (type: `boolean`): For each artist ID, also export up to 50 top tracks with duration, rank and preview URL. ## `includeArtistAlbums` (type: `boolean`): For each artist ID, also export up to 100 albums (discography) with release date and track count. ## `maxItems` (type: `integer`): Maximum number of rows to export across all sources. Free users are limited to 10 rows (preview). Paid users: optional, up to 1,000,000. Set a low value to control cost. ## Actor input object example ```json { "searchQuery": "daft punk", "searchType": "track", "includeCharts": false, "chartTypes": [ "tracks" ], "artistIds": [], "includeArtistTopTracks": true, "includeArtistAlbums": false, "maxItems": 10 } ``` # Actor output Schema ## `overview` (type: `string`): Key fields per row ## `fullData` (type: `string`): Complete dataset with all fields # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "daft punk", "artistIds": [], "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("recordsdata/deezer-music-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "daft punk", "artistIds": [], "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("recordsdata/deezer-music-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "daft punk", "artistIds": [], "maxItems": 10 }' | apify call recordsdata/deezer-music-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,recordsdata/deezer-music-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/s0deA2RfCyGzCMLqk/builds/WFmA5ablt6taIUYUh/openapi.json