# 🚀 Deezer Scraper · 5,000 Free Results/Month (`omkar-cloud/deezer-scraper`) Actor

Deezer Scraper gets you Deezer data ⚡ fast, 🎯 100% accurate and 🔍 ridiculously detailed — tracks with ISRC, credits & previews, albums, artists, playlists & charts from a search, an id or a URL. 💰 $1 per 1,000 results, no start fee. Scrape your first 5,000 results free every month 🚀

- **URL**: https://apify.com/omkar-cloud/deezer-scraper.md
- **Developed by:** [Chetan Jain](https://apify.com/omkar-cloud) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Deezer Scraper

Deezer Scraper by Omkar Cloud gets you 🎯 accurate, 🔍 detailed Deezer music data.

Deezer's catalogue holds 120+ million tracks, and every run reads it live — so you get today's search results, full track, album, artist and playlist records with ISRCs, UPCs, credits, rights and preview links, and the current charts of any country, and can successfully complete your project.

**$1 per 1,000 results.** And with Apify's free plan you get $5 of credit every month, so your first **~5,000 results each month are free**.

This is an excellent Actor made by Omkar Cloud, which is Rated Excellent — [4.7 based on 30 reviews on Trustpilot](https://www.trustpilot.com/review/omkar.cloud).

👉 [**Try Deezer Scraper free**](https://apify.com/omkar-cloud/deezer-scraper) — your first ~5,000 results are Free.

### What can I get

- 🔍 **Search anything on Deezer** — tracks, albums, artists, playlists, user profiles or podcasts by keyword, fuzzy or strict, in any Deezer market; up to 4,000 results per query
- 🎵 **Full track records** — ISRC, duration, BPM, gain, rank, release dates, copyright, explicit flags, credits (authors, composers, producers…), contributors, availability by country and related releases, plus a 30-second preview MP3 link
- 💿 **Full album, artist & playlist records** — albums with UPC, label, genres, credits, subtypes and the first 50 tracks with ISRCs; artists with biography, fans, social links, top 10 tracks, 10 albums, related artists and playlists; playlists with creator, counts, dates and the first 50 tracks
- 🔗 **From a URL, an ISRC or a UPC** — paste deezer.com links, `isrc:GBDUW0000059` or `upc:724384960650` and get the complete record back
- 📈 **Charts per country** — today's top tracks, albums, artists, playlists and podcasts for any country, optionally within a genre, in chart order — track, album and artist entries with their position
- 🖼️ **Cover art & pictures in four sizes** — 56, 250, 500 and 1000 px for every track, album, artist, playlist, user and podcast

### Why Deezer Scraper

Most other Deezer scrapers fail you in one of four ways:

- 🧩 **Low-detail data** — a title and an artist, never the ISRC, the credits or the rights
- 🪓 **One thing only** — a search *or* a chart *or* one record type, so you chain three actors for one job
- 💸 **Pay more to get the same data** — start fees, tiers and paid "extra data" events
- 🪦 **Works today, breaks next month** — nobody maintains it

Deezer Scraper does search, full records and charts in one run, is priced honestly, and actively maintained.

### Example: A Full Deezer Track Record

```json
{
  "source": "https://www.deezer.com/track/3135556",
  "record_type": "track",
  "id": 3135556,
  "title": "Harder, Better, Faster, Stronger",
  "title_short": "Harder, Better, Faster, Stronger",
  "title_version": null,
  "link": "https://www.deezer.com/track/3135556",
  "preview_link": "https://cdnt-preview.dzcdn.net/api/1/1/6/a/2/0/6a2c0a5670afe821e08fc5154909534a.mp3?hdnea=%E2%80%A6",
  "isrc": "GBDUW0000059",
  "duration_seconds": 226,
  "release_date": "2001-03-12",
  "physical_release_date": "2001-03-12",
  "track_position": 4,
  "disk_number": 1,
  "bpm": null,
  "gain_db": -12.4,
  "rank": 810329,
  "copyright": "© 2001 Daft Life Limited",
  "is_readable": true,
  "has_lyrics": false,
  "is_explicit_lyrics": false,
  "explicit_lyrics_status": "not_explicit",
  "explicit_cover_status": "not_explicit",
  "credits": {
    "main_artists": ["Daft Punk"],
    "authors": ["Edwin Birdsong", "Guy-Manuel de Homem-Christo", "Thomas Bangalter"]
  },
  "artist": {
    "id": 27,
    "name": "Daft Punk",
    "link": "https://www.deezer.com/artist/27",
    "pictures": {
      "small": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/56x56-000000-80-0-0.jpg",
      "medium": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/250x250-000000-80-0-0.jpg",
      "big": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/500x500-000000-80-0-0.jpg",
      "xl": "https://cdn-images.dzcdn.net/images/artist/638e69b9caaf9f9f3f8826febea7b543/1000x1000-000000-80-0-0.jpg"
    }
  },
  "album": {
    "id": 302127,
    "title": "Discovery",
    "link": "https://www.deezer.com/album/302127",
    "upc": null,
    "release_date": "2001-03-07",
    "cover": {
      "small": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/56x56-000000-80-0-0.jpg",
      "medium": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/250x250-000000-80-0-0.jpg",
      "big": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/500x500-000000-80-0-0.jpg",
      "xl": "https://cdn-images.dzcdn.net/images/cover/5718f7c81c27e0b2417e2a4c45224f8a/1000x1000-000000-80-0-0.jpg"
    }
  },
  "contributors": [
    { "id": 27, "name": "Daft Punk", "link": "https://www.deezer.com/artist/27", "pictures": { "small": "…", "medium": "…", "big": "…", "xl": "…" }, "role": "Main" }
  ],
  "availability": {
    "country": "us",
    "is_available_in_country": true,
    "country_count": 209,
    "countries": ["AE", "AF", "AG", "AI", "AL", "…"],
    "subscription_only_countries": null,
    "is_free_stream_available": true,
    "is_subscription_stream_available": true
  },
  "related_albums": [
    { "id": 302127, "title": "Discovery", "link": "https://www.deezer.com/album/302127", "release_date": "2001-03-12", "duration_seconds": 226, "is_streamable": true, "artist": { "id": 27, "name": "Daft Punk", "link": "https://www.deezer.com/artist/27" } },
    { "id": 302378, "title": "Harder, Better, Faster, Stronger", "link": "https://www.deezer.com/album/302378", "release_date": "2001-10-19", "duration_seconds": 226, "is_streamable": true, "artist": { "id": 27, "name": "Daft Punk", "link": "https://www.deezer.com/artist/27" } }
  ],
  "updated_at": "2026-03-04T01:47:10Z"
}
```

*Trimmed for readability — the real row lists all 209 countries the track is available in and all ten related releases with their cover art.*

A search row carries `search_query`, `search_type` and `country` in front of the result fields; a chart row carries `chart_type`, `chart_country` and `genre_id` (plus `position` on track, album and artist charts).

### Get Started with 5,000 Free Results

1. [Hit **Try for Free Button**](https://apify.com/omkar-cloud/deezer-scraper) — the input is pre-filled with an "eminem" track search.
2. Enjoy your data 😎.

### Pricing

High value, Low price.

| What | Price | What you get |
|---|---|---|
| **Results** | **$1 per 1,000** | A search result, a chart entry or a full record — tracks with ISRC, duration, rank, preview link, artist and album; albums with UPC, cover art, label, genres and tracks; artists with pictures, fans, bio and top tracks; playlists with creator, counts and tracks; users and podcasts — plus the query, chart or source that produced each row |

No start fee, no add-ons, one flat price on every plan — you pay only for the rows you get. Control your spend with **Max Results per Query** and **Chart Size**: 1,000 results ≈ $1. One query at the default 100 results costs about $0.10; a URL costs $0.001; the top-100 tracks of 10 countries cost about $1.

💡 Apify's free plan includes $5 of credit every month — about **5,000 free results, every month**.

👉 [**Scrape your first 5,000 results free**](https://apify.com/omkar-cloud/deezer-scraper)

### Run It from Code

Grab your API token from [Integrations Settings here](https://console.apify.com/settings/integrations) and replace `<YOUR_API_TOKEN>` below.

**Python** (`pip install apify-client`)

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("omkar-cloud/deezer-scraper").call(run_input={
    "queries": ["lose yourself"],
    "searchType": "tracks",
    "maxResults": 10,
    "urls": ["https://www.deezer.com/track/3135556", "isrc:GBDUW0000059"],
})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row["title"], row["artist"]["name"], row["isrc"], row["preview_link"])
```

**Node.js** (`npm install apify-client`)

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('omkar-cloud/deezer-scraper').call({
    chartTypes: ['tracks', 'albums'],
    chartCountries: ['us', 'gb', 'fr'],
    chartLimit: 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

### FAQ

#### What can I search for?

Tracks, albums, artists, playlists, user profiles or podcasts — pick the **Search Type**, list your **Queries** one per line, and every query is searched separately. Each query pages through Deezer's results 100 at a time, up to **Max Results per Query** (at most 4,000 — Deezer stops at 40 pages). Turn on **Strict Matching** to disable fuzzy matching.

#### How do I get the full record of a track, album, artist or playlist?

Paste it under **URLs** — a deezer.com link (`https://www.deezer.com/track/3135556`, `https://www.deezer.com/us/album/302127`), an ISRC as `isrc:GBDUW0000059`, a UPC as `upc:724384960650`, or `track:<id>`, `album:<id>`, `artist:<id>`, `playlist:<id>`. A bare number is not accepted because a track, an album and an artist can share the same id. Rows carry `source` and `record_type`. User profiles and podcasts have no full-record endpoint — search for those instead.

#### How do the charts work?

Select one or more **Chart Types** (top tracks, albums, artists, playlists, podcasts) and list the **Chart Countries** as 2-letter codes. Every chart × country combination is scraped, up to **Chart Size** entries (1–100) each, optionally restricted to a **Chart Genre Id** (`0` = all genres, `132` = Pop, `116` = Rap/Hip Hop, `152` = Rock…). Rows come in chart order and carry `chart_type`, `chart_country` and `genre_id`; track, album and artist entries also carry their `position` — Deezer does not number its playlist and podcast charts.

#### Can I combine searches, URLs and charts in one run?

Yes — fill in any of the three sections and everything runs in one job. A record that comes back twice (the same track from two searches, or from a URL and then a search) is pushed and billed once. Chart entries are kept per chart, so the same song at #3 in the US and #7 in the UK is two rows.

#### Which country should I use?

**Country** is Deezer's market (`us`, `gb`, `fr`, `de`, `br`, `in`…). It is not cosmetic: search ranking, availability flags and charts follow that market. Searches and URLs use Country; charts use the Chart Countries list (and fall back to Country when it is empty).

#### What does it cost?

$0.001 per result — $1 per 1,000, flat on every plan, with no start fee. Apify's free plan gives you $5 of credit every month, which is 5,000 results free every month.

#### Is the preview link a full song?

No — `preview_link` is Deezer's own 30-second MP3 preview, the same clip deezer.com plays to visitors. The link is signed and expires after a while, so download it soon after the run or re-run to refresh it.

#### Is it legal to scrape Deezer?

The Actor collects publicly available catalogue and chart data. User-profile searches return only the public display name, profile link and pictures. Please review Deezer's terms of use and make sure your use complies with the law of your jurisdiction.

#### Can I get lyrics, an album's full tracklist beyond 50, or an artist's whole discography?

Not with this Actor — it returns Deezer's search results, charts and the full records described above. Message us below if you need paginated album, playlist or artist tracklists and we will sort you out.

### 💬 Have Questions? We Have Answers.

You're a business owner — we know how hard completing a project can be. So we offer full support: just message us and we'll reply ✅ with a solution within 1 working day.

[![Message Us on WhatsApp](https://raw.githubusercontent.com/omkarcloud/assets/master/images/whatsapp-us.png)](https://api.whatsapp.com/send?phone=918178804274\&text=I%20need%20help%20with%20using%20the%20Deezer%20Scraper%20Actor.)

[![Ask Us on Email](https://raw.githubusercontent.com/omkarcloud/assets/master/images/ask-on-email.png)](mailto:happy.to.help@omkar.cloud?subject=Help%20with%20Deezer%20Scraper%20Actor\&body=I%20need%20help%20with%20using%20the%20Deezer%20Scraper%20Actor.)

You are important to us — just message us and we will solve your problem ✅ within 1 working day. 🩷 Pinky Promise 🤙!

### Popular Actors by Omkar Cloud

- [**Booking Scraper**](https://apify.com/omkar-cloud/booking-scraper) — Booking.com hotels: prices, ratings, rooms & amenities
- [**Rightmove Scraper**](https://apify.com/omkar-cloud/rightmove-scraper) — UK homes for sale, to rent & new homes with agent phones, $1 per 1,000 listings
- [**Zoopla Scraper**](https://apify.com/omkar-cloud/zoopla-scraper) — Zoopla homes for sale, to rent & new homes with agent phones, $1 per 1,000 listings
- [**IMDb Scraper**](https://apify.com/omkar-cloud/imdb-scraper) — IMDb titles, charts, cast, ratings & box office
- [**G2 Product Scraper**](https://apify.com/omkar-cloud/g2-product-scraper) — G2 product details, ratings & AI-found contacts
- [**Website Email Contact Scraper**](https://apify.com/omkar-cloud/website-email-contact-scraper) — emails, phones & socials from any website
- [**AliExpress Product Scraper**](https://apify.com/omkar-cloud/aliexpress-product-scraper) — live product details, SKU variants, stock & shipping
- [**Etsy Scraper**](https://apify.com/omkar-cloud/etsy-scraper) — Etsy products: prices, discounts, shops & variations

👉 [**Scrape your first 5,000 results free now**](https://apify.com/omkar-cloud/deezer-scraper)

# Actor input Schema

## `queries` (type: `array`):

Search phrases, one per line — an artist (`eminem`), a song (`lose yourself`), an album, a playlist theme (`workout`), a user name or a podcast. Each is searched as the Search Type below.

## `searchType` (type: `string`):

What the queries search for. Tracks come with preview MP3, ISRC, duration, rank, artist and album; albums with cover art, record type, track count, genre and artist; artists with pictures, album and fan counts; playlists with cover, track count, creator and dates; users with profile link and pictures; podcasts with description, artwork and fan count.

## `strict` (type: `boolean`):

Disable Deezer's fuzzy matching so only exact words match. Off by default.

## `maxResults` (type: `integer`):

Maximum number of results to scrape per query (1–4,000; Deezer serves at most 40 pages of 100). Use this to control your cost: 1,000 results ≈ $1.

## `country` (type: `string`):

Deezer market as a 2-letter ISO code (`us`, `gb`, `fr`, `de`, `br`, `in`…). Not cosmetic: search ranking and availability follow that market. Applies to searches and to the URLs below; charts have their own country list.

## `urls` (type: `array`):

One reference per line: a deezer.com track, album, artist or playlist URL (`https://www.deezer.com/track/3135556`, `https://www.deezer.com/us/album/302127`), an ISRC as `isrc:GBDUW0000059` (→ track), a UPC as `upc:724384960650` (→ album), or an explicit `track:3135556`, `album:302127`, `artist:27` or `playlist:3155776842`. A bare number is not accepted — a track, an album and an artist can share the same id, so the kind must be stated. User profiles and podcasts have no full-record endpoint; search for those instead.

## `chartTypes` (type: `array`):

Which charts to scrape. Each selected chart is scraped for every country listed below.

## `chartCountries` (type: `array`):

Countries whose charts to scrape, as 2-letter ISO codes (`us`, `gb`, `fr`, `de`, `br`, `in`…), one per line. Leave empty to use the Country field above.

## `chartGenreId` (type: `integer`):

Deezer genre id to restrict the charts to — `0` for all genres, `132` for Pop, `116` for Rap/Hip Hop, `152` for Rock, `113` for Dance, `106` for Electro, `98` for Classical…

## `chartLimit` (type: `integer`):

Number of entries per chart (1–100).

## Actor input object example

```json
{
  "queries": [
    "eminem"
  ],
  "searchType": "tracks",
  "strict": false,
  "maxResults": 100,
  "country": "us",
  "urls": [
    "https://www.deezer.com/track/3135556",
    "isrc:GBDUW0000059",
    "upc:724384960650",
    "https://www.deezer.com/artist/27"
  ],
  "chartTypes": [],
  "chartCountries": [
    "us",
    "gb",
    "fr"
  ],
  "chartGenreId": 0,
  "chartLimit": 25
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "eminem"
    ],
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("omkar-cloud/deezer-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": ["eminem"],
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("omkar-cloud/deezer-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 '{
  "queries": [
    "eminem"
  ],
  "maxResults": 100
}' |
apify call omkar-cloud/deezer-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,omkar-cloud/deezer-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 <APIFY_API_TOKEN>` 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/c3qW0KYcn0TWHTcNe/builds/mAK7eR2FcWr1fyuF8/openapi.json