# Apple Charts API
> Live Apple App Store, Music and Podcast charts by country, with no key. This reads Apple's own public Marketing Tools RSS feeds and returns clean JSON: the top apps (free and paid), the most-played songs and the top podcasts, ranked, for any of Apple's storefronts. The apps endpoint ranks the top free or paid iOS apps; the music endpoint ranks the most-played songs on Apple Music; the podcasts endpoint ranks the top podcasts on Apple Podcasts — each entry with its rank, title, artist or developer, artwork, genres and store link. The app-store / charts / trending-media layer for app-store optimisation (ASO), market research, media-monitoring and content tools. Distinct from the iTunes catalogue-lookup reader and the App-Store-search reader — this is the live top-charts data per country. Live from Apple; short cache only.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/applecharts-api/..."
```

## Pricing
- **Free** (Free) — 10,800 calls/Mo, 3 req/s
- **Starter** ($7/Mo) — 198,000 calls/Mo, 10 req/s
- **Pro** ($24/Mo) — 1,020,000 calls/Mo, 25 req/s
- **Scale** ($71/Mo) — 6,300,000 calls/Mo, 60 req/s

## Endpoints

### Apps

#### `GET /v1/apps` — Top iOS apps chart

**Parameters:**
- `country` (query, optional, string) — 2-letter storefront code Example: `us`
- `feed` (query, optional, string) — top-free or top-paid Example: `top-free`
- `limit` (query, optional, string) — Rows (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/applecharts-api/v1/apps?country=us&feed=top-free&limit=25"
```

**Response:**
```json
{
    "data": {
        "apps": [
            {
                "id": "6746049430",
                "url": "https://apps.apple.com/us/app/fox-one-live-news-sports-tv/id6746049430",
                "kind": "apps",
                "name": "FOX One: Live News, Sports, TV",
                "rank": 1,
                "artist": "Fox Digital Services, LLC",
                "genres": [],
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/00/ec/33/00ec3381-b756-542e-3a77-50955634add0/AppIcon-0-1x_U007epad-0-1-0-85-220-0.png/100x100bb.png",
                "release_date": "2025-08-20",
                "content_rating": null
            },
            {
                "id": "1632713844",
                "url": "https://apps.apple.com/us/app/kalshi-trade-the-cup/id1632713844",
                "kind": "apps",
                "name": "Kalshi: Trade the Cup",
                "rank": 2,
                "artist": "KalshiEX LLC",
                "genres": [],
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/5b/04/7b/5b047bef-4700-50e5-0180-e36188e4062f/flavor_productionAppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/100x100bb.png",
                "release_date": "2022-09-16",
                "content_rating": null
            },
            {
                "id": "1508186374",
                "url": "https://apps.apple.com/us/app/peacock-tv-stream-tv-movies/id1508186374",
                "kind": "apps",
                "name": "
…(truncated, see openapi.json for full schema)
```

### Music

#### `GET /v1/music` — Most-played songs chart

**Parameters:**
- `country` (query, optional, string) — 2-letter storefront code Example: `us`
- `limit` (query, optional, string) — Rows (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/applecharts-api/v1/music?country=us&limit=25"
```

**Response:**
```json
{
    "data": {
        "feed": "most-played",
        "note": "The most-played songs on Apple Music for a country, ranked — each with its rank, title, artist, genres, artwork and link. Pass country (storefront code, default us). The live Apple Music chart.",
        "count": 25,
        "songs": [
            {
                "id": "6769568596",
                "url": "https://music.apple.com/us/album/janice-stfu/6769568449?i=6769568596",
                "kind": "songs",
                "name": "Janice STFU",
                "rank": 1,
                "artist": "Drake",
                "genres": [
                    "Hip-Hop/Rap",
                    "Music"
                ],
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/35/b9/06/35b90629-a873-14f8-4789-ffc324960038/26UMGIM63614.rgb.jpg/100x100bb.jpg",
                "release_date": "2026-05-15",
                "content_rating": "Explict"
            },
            {
                "id": "6769568598",
                "url": "https://music.apple.com/us/album/shabang/6769568449?i=6769568598",
                "kind": "songs",
                "name": "Shabang",
                "rank": 2,
                "artist": "Drake",
                "genres": [
                    "Hip-Hop/Rap",
                    "Music"
                ],
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/35/b9/06/35b90629-a873-14f8-4789-ffc324960038/26UMGIM63614.rgb.jpg/100x100bb.j
…(truncated, see openapi.json for full schema)
```

### Podcasts

#### `GET /v1/podcasts` — Top podcasts chart

**Parameters:**
- `country` (query, optional, string) — 2-letter storefront code Example: `us`
- `limit` (query, optional, string) — Rows (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/applecharts-api/v1/podcasts?country=us&limit=25"
```

**Response:**
```json
{
    "data": {
        "feed": "top",
        "note": "The top podcasts on Apple Podcasts for a country, ranked — each with its rank, title, publisher, genres, artwork and link. Pass country (storefront code, default us). The live Apple Podcasts chart.",
        "count": 25,
        "title": "Top Shows",
        "source": "Apple",
        "country": "us",
        "updated": "Sun, 14 Jun 2026 17:03:37 +0000",
        "podcasts": [
            {
                "id": "1200361736",
                "url": "https://podcasts.apple.com/us/podcast/the-daily/id1200361736",
                "kind": "podcasts",
                "name": "The Daily",
                "rank": 1,
                "artist": "The New York Times",
                "genres": [
                    "News"
                ],
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/ab/64/66/ab6466a9-9a7d-e20e-7a3d-bc5be37d29ce/mza_15084852813176276273.jpg/100x100bb.png",
                "release_date": null,
                "content_rating": null
            },
            {
                "id": "1464919521",
                "url": "https://podcasts.apple.com/us/podcast/dateline-nbc/id1464919521",
                "kind": "podcasts",
                "name": "Dateline NBC",
                "rank": 2,
                "artist": "NBC News",
                "genres": [
                    "True Crime",
                    "News"
                ],
                "artwork": "https://is1-ssl.mzst
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/applecharts-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "top_us_free_app": "FOX One: Live News, Sports, TV"
        },
        "source": "Apple public Marketing Tools RSS (rss.marketingtools.apple.com), keyless",
        "service": "applecharts-api",
        "endpoints": {
            "GET /v1/apps": "Top iOS apps chart (country, feed=top-free|top-paid, limit).",
            "GET /v1/meta": "This document.",
            "GET /v1/music": "Most-played songs chart (country, limit).",
            "GET /v1/podcasts": "Top podcasts chart (country, limit)."
        },
        "description": "Live Apple App Store, Music and Podcast charts by country with no key: the top free/paid iOS apps, the most-played songs and the top podcasts, ranked, for any Apple storefront. Each entry with rank, title, artist/developer, artwork, genres and store link. The app-store / charts / trending-media layer for ASO, market research and media-monitoring. Distinct from the iTunes catalogue-lookup and App-Store-search readers. Live, short cache only.",
        "storefronts": [
            "us",
            "gb",
            "de",
            "fr",
            "es",
            "it",
            "nl",
            "ca",
            "au",
            "br",
            "mx",
            "jp",
            "kr",
            "in",
            "ru",
            "tr",
            "se",
            "pl",
            "cn",
            "ae"
        ],
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": 
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/applecharts-api
OpenAPI spec: https://www.oanor.com/api/applecharts-api/openapi.json
