> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/deezer/charts>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/deezer/charts.mdx>

---

# Deezer Charts API

Five chart kinds, a genre filter and a country tracks chart.

`GET /v1/deezer/charts` returns `lookupStatus`, `type`, `genreId`, `country`, the list for the chosen chart, and `windowLimited`. Set `type` to `tracks`, `albums`, `artists`, `playlists` or `podcasts`; `genreId` filters by genre and `0` means all genres. `limit` accepts 1 to 300 and defaults to 100.

`country` is only for a tracks chart with all genres. If it is combined with another type or a genre, the request is refused with a 400 before any lookup. A country tracks chart holds at most 100 rows and sets `windowLimited` when `limit` asks for more. Rows in a country tracks chart do not carry `previewUrl`, `previewExpiresAt`, `rank`, `available`, `titleShort`, `version`, `trackNumber` or `discNumber`, so those fields are null.

## Request

- **Endpoint:** `GET /v1/deezer/charts`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by chart type
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/deezer/charts/get)
- **Platform page:** [/platforms/deezer](https://www.socialfetch.dev/platforms/deezer)

## FAQ

### How many credits does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

### Can I get a country chart for albums?

No. country is only accepted with type=tracks and genreId=0 or omitted. Other chart kinds follow the region of the request.

### Why did the chart return fewer rows than limit?

The country tracks chart is limited to 100 rows. windowLimited is true when the window was smaller than limit.