# Apple Music Charts API (https://www.socialcrawl.dev/platforms/apple_music/charts)

> Returns what a country is playing most on Apple Music right now: the Top Songs, Top Albums, Top Music Videos or Top Playlists chart, with no keyword in. Each item is a Post: `content.text` is the title, `author.username` the artist, `url` the Apple Music link and `content.thumbnail_url` the artwork. The chart position is on `ext.trend`: `rank` (1 is the top), `country_code`, `chart` and Apple's own `chart_title` and `updated_at`. `ext.apple_music` carries `kind`, `release_date`, `artist_id`, `artist_url`, `genres` and `content_advisory`. `published_at` is the release date at midnight UTC. Playlists have no artist or release date, so those are null. The item ids work with /v1/apple_music/track and /v1/apple_music/album for the full record. A country Apple Music does not publish a chart for is a free 400. Exact repeats within an hour are served from cache at 0 credits.

TL;DR: `GET /v1/apple_music/charts` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `country` | no | Country as an ISO 3166-1 alpha-2 code, in any case (`us`, `DE`, `kr`). Apple Music publishes a chart for most countries where it is sold; one it does not is rejected with a free 400. `uk` is read as `gb`. Defaults to `us`. |
| `type` | no | Which chart: `songs` (the default), `albums`, `music-videos` or `playlists`. (songs \| albums \| music-videos \| playlists) |
| `limit` | no | How many chart positions to return, from the top, 1 to 100. Defaults to 50. |
| `since` | no | Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off each page. This list is not in date order, so the walk does not stop at the date: keep following `next_cursor`, and each page costs what a page costs even when every row on it is filtered out. A row with no date is kept. `published_after`, `start_date`, `from_date`, `publish_time` (`yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`) and `max_age_days` are accepted and applied as `since`. |
| `until` | no | Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept. `published_before`, `end_date` and `to_date` are accepted and applied as `until`. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/apple_music/charts" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### Does Apple Music have an API for charts?

SocialCrawl has one. /v1/apple_music/charts returns what a country is playing most on Apple Music right now, as the Top Songs, Top Albums, Top Music Videos or Top Playlists chart, with no keyword needed.

### How do I call the Apple Music charts API?

Send a GET request to /v1/apple_music/charts with an x-api-key header. country takes an ISO code in any case (us, DE, kr) and defaults to us, type takes songs (the default), albums, music-videos or playlists, and limit takes 1 to 100 and defaults to 50.

### What does each chart item contain?

Each item is a Post: content.text is the title, author.username the artist, url the Apple Music link and content.thumbnail_url the artwork. ext.trend holds rank, country_code, chart, chart_title and updated_at, and ext.apple_music holds kind, release_date, artist_id, artist_url, genres and content_advisory.

### Can I get the full track or album record for a chart entry?

Yes. The item ids work with /v1/apple_music/track and /v1/apple_music/album. Playlists have no artist or release date, so those fields are null for them.

### Which countries have an Apple Music chart?

It covers most countries where Apple Music is sold. A country with no published chart is rejected with a free 400, and uk is read as gb.

### How much does it cost and how fresh is the chart?

Each call costs 1 credit on the standard tier. Apple refreshes the chart about once a day, so exact repeats within an hour come from cache at 0 credits. Credits for failed or empty calls are refunded automatically.

See the full Apple Music API: https://www.socialcrawl.dev/platforms/apple_music

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- Does Apple Music have an API for its charts?
- How do I get the Apple Music top songs for a country as JSON with SocialCrawl?
- Is there an API for Apple Music top albums and playlists by country?