> **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/artists-artistid-top-tracks>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/deezer/artists-artistid-top-tracks.mdx>

---

# Deezer Artist Top Tracks API

The artist's most played tracks, ready for a chart or a starting queue.

`GET /v1/deezer/artists/{artistId}/top-tracks` returns `lookupStatus`, `tracks` and `total`. Tracks are ordered most played first and use the list track shape: `id`, `title`, `durationMs`, `rank`, `artist`, `album`, `previewUrl` and the rest of the list fields. `limit` accepts 1 to 100 and defaults to 50.

An artist that exists but has no top tracks returns `lookupStatus: found` with an empty `tracks` array. An unknown artist returns `not_found`, so an empty list is not confused with a missing artist.

## Request

- **Endpoint:** `GET /v1/deezer/artists/{artistId}/top-tracks`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by artist id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/deezer/artists/artistid/top-tracks/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.

### How many top tracks can I ask for?

limit accepts 1 to 100 and defaults to 50. total says how many Deezer lists for the artist, up to 100.

### What is the difference between found and empty?

found with an empty tracks array means the artist exists but has no top tracks. not_found means the artist id itself was not found.
