Introducing the Instagram APIRead more →

Apple Music Top Tracks API. Top tracks, on request.

Most played songs and music videos by country. We handle the proxies, blocks and platform changes.

Apple Music Top Tracks API at a glance

Returns Apple Music's chart of the most played songs or music videos in a country's store, top first, a page at a time, with each one's rank and ISRC. Each row also has the credited artists with their IDs, album, length, release date, composer, genres, explicit rating, audio formats, whether Apple has its lyrics, artwork and a preview clip. Pick the store with country and the chart with kind: the US songs chart by default.

GET /v1/applemusic/top_tracks

Read the API reference
  • 1 credit per page, $0.75–$1.97 per 1,000 pages
  • 22 typed fields null when unknown
  • 100 tracks per page, Apple Music's own chart order (1 = most played)
  • 100 credits free when you sign up, no card, so you can build before you spend

Send one request. Get up to 100 tracks back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

$ npm install socialtap
GET /v1/applemusic/top_tracksTry in
const params = new URLSearchParams({
  country: "US",
  kind: "song",
});
const res = await fetch(`https://socialtap.dev/v1/applemusic/top_tracks?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, page, meta } = body;
console.log(data, meta.credits_charged);
200 OK · GET https://socialtap.dev/v1/applemusic/top_tracksLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 21 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

  • Null means unknown

    A field Apple Music doesn't show is null, never zero or an empty string, so a real zero always means zero.

  • No input needed

    Every parameter is optional: the plain request returns the default list.

  • Write one parser

    Apple Music, TikTok, Instagram and 18 more platforms answer in these fields, so the code that reads one reads them all.

platformstring
Platform ID (tiktok, youtube, …).
idstring
Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix).
urlstring
Canonical post URL.
typestring
Normalized content shape. New values may be added; treat unknown values as other.
platform_typestring
The platform's own product label, lowercase (reel, short, story, live, tweet, …).
titlestring
Headline (YouTube title, Reddit title); null on caption-only platforms.
textstring
Caption, description or body as plain text.
languagestring
BCP-47 language of text, when the platform states it.

What teams build with the Apple Music Top Tracks API.

  • Track the most played songs each day

  • Compare a song's rank across countries

  • Feed trend dashboards with matching ISRCs

  • Spot new songs breaking into the chart

Good to know before you build.

  • platform_specific.applemusic.rank is the row's place in the chart, top first, and stays the same whatever limit you ask for. Apple publishes no play counts, so metrics are null and the rank is all the chart says.
  • Apple serves about 200 rows per chart, fewer in a few small stores, and the walk then ends with page.end_reason end: that is the whole chart.
  • since and until filter by release date. A chart isn't in date order, so they don't end the walk early: every page is read and charged until the chart ends.
  • Charts differ by store, and platform_specific.applemusic.storefront says which store answered. A store's titles can be in its own language: lang asks for another where Apple offers it, and a language it doesn't offer gets the store's own, as a US chart with lang=ja-JP does.
  • The Apple Music Top Albums API charts albums, and the Apple Music Top Playlists API playlists.
  • When Apple's catalog API fails, the top of the chart comes from Apple's RSS feed and ends the walk with platform_limit: isrc, composer_name, duration_ms, the album, the preview, the audio formats and the lyrics flags are null or [], and only the first artist is named (those lists in unknown_fields). The feed has no languages, so a request with lang fails rather than answer in another.

1 credit per page. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

SourcePrice per successful pagePer 1,000 pages
Platform API api1 credit$0.75–$1.97
  • Cache hits are free.
  • Credits from packs and top-ups never expire.
  • A monthly plan's credits are spent first, and what is left of them ends at each renewal.
  • Prices exclude tax: sales tax is added at checkout where it applies.
  • Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

Questions about the Apple Music Top Tracks API.

More in the API reference.

Can I get the chart for another country?
Yes. Send country as a two-letter code, such as GB or JP, for that store's chart. A country with no Apple Music store returns invalid_input.
How much does the Apple Music Top Tracks API cost?
A page of up to 100 tracks costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.
How do I get the next page?
Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours.

See what's on the list right now.

Run it in the playground, or copy the request into your code.

100free credits
  • No credit card
  • Failed requests are free
  • Works on all 218 endpoints
Start for free Read the docs