# iTunes API
> Real-time Apple iTunes catalogue data as an API — music, podcasts, ebooks and audiobooks, plus artist, album and podcast lookups, returned as clean JSON. Search songs, albums, podcasts, ebooks and audiobooks, or run a general search across any media type; look up any item by its iTunes id; fetch an artist with their albums and songs; fetch an album with its full track list; and fetch a podcast with its recent episodes. Live data with names, artists, artwork (upscaled), preview URLs, genres, prices, release dates, content ratings, track counts and podcast feed URLs. Ideal for music and podcast apps, media-catalogue and metadata enrichment, discovery and recommendation tools, and research. 12 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.

## 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/itunes-api/..."
```

## Pricing
- **Free** (Free) — 1,500 calls/Mo, 3 req/s
- **Starter** ($12/Mo) — 35,000 calls/Mo, 10 req/s
- **Pro** ($42/Mo) — 200,000 calls/Mo, 25 req/s
- **Mega** ($139/Mo) — 950,000 calls/Mo, 60 req/s

## Endpoints

### Search

#### `GET /v1/search` — Search any media

**Parameters:**
- `term` (query, required, string) — Search term Example: `daft punk`
- `media` (query, optional, string) — music, podcast, ebook, audiobook, all Example: `music`
- `limit` (query, optional, string) — Max results (1–200) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/itunes-api/v1/search?term=daft+punk&media=music&limit=25"
```

**Response:**
```json
{
    "data": {
        "term": "daft punk",
        "count": 26,
        "media": "music",
        "results": [
            {
                "kind": "song",
                "genre": "Pop",
                "price": 1.29,
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/e8/43/5f/e8435ffa-b6b9-b171-40ab-4ff3959ab661/886443919266.jpg/600x600bb.jpg",
                "country": "USA",
                "currency": "USD",
                "explicit": "notExplicit",
                "track_id": 617154366,
                "artist_id": 5468295,
                "track_url": "https://music.apple.com/us/album/get-lucky/617154241?i=617154366&uo=4",
                "artist_url": "https://music.apple.com/us/artist/daft-punk/5468295?uo=4",
                "track_name": "Get Lucky",
                "artist_name": "Daft Punk, Pharrell Williams & Nile Rodgers",
                "preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview126/v4/d4/d3/1e/d4d31eb4-7405-b806-8346-3c52ad5b4cf4/mzaf_8095545455942962509.plus.aac.p.m4a",
                "track_count": 13,
                "release_date": "2013-04-19T07:00:00Z",
                "track_number": 8,
                "wrapper_type": "track",
                "collection_id": 617154241,
                "track_time_ms": 369629,
                "collection_url": "https://music.apple.com/us/album/get-lucky/617154241?i=617154366&uo=4",
                "collection_name": "Random Access Memories",
        
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search/albums` — Search albums

**Parameters:**
- `term` (query, required, string) — Search term Example: `random access memories`
- `limit` (query, optional, string) — Max results Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/itunes-api/v1/search/albums?term=random+access+memories&limit=25"
```

**Response:**
```json
{
    "data": {
        "term": "random access memories",
        "count": 25,
        "media": "music",
        "results": [
            {
                "genre": "Pop",
                "price": 11.99,
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/e8/43/5f/e8435ffa-b6b9-b171-40ab-4ff3959ab661/886443919266.jpg/600x600bb.jpg",
                "country": "USA",
                "currency": "USD",
                "explicit": "notExplicit",
                "artist_id": 5468295,
                "artist_url": "https://music.apple.com/us/artist/daft-punk/5468295?uo=4",
                "artist_name": "Daft Punk",
                "track_count": 14,
                "release_date": "2013-05-17T07:00:00Z",
                "wrapper_type": "collection",
                "collection_id": 617154241,
                "collection_url": "https://music.apple.com/us/album/random-access-memories/617154241?uo=4",
                "collection_name": "Random Access Memories",
                "release_date_utc": "2013-05-17T07:00:00Z"
            },
            {
                "genre": "Dance",
                "price": 14.99,
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Music116/v4/86/b1/92/86b192cf-ceb6-6e51-9361-dc4a35e95d22/196589921154.jpg/600x600bb.jpg",
                "country": "USA",
                "currency": "USD",
                "explicit": "notExplicit",
                "artist_id": 5468295,
                "artist_url": "https:/
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search/audiobooks` — Search audiobooks

**Parameters:**
- `term` (query, required, string) — Search term Example: `stephen king`
- `limit` (query, optional, string) — Max results Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/itunes-api/v1/search/audiobooks?term=stephen+king&limit=25"
```

**Response:**
```json
{
    "data": {
        "term": "stephen king",
        "count": 29,
        "media": "audiobook",
        "results": [
            {
                "genre": "Mysteries & Thrillers",
                "price": 3.99,
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Music118/v4/49/0a/02/490a02cd-8161-f00e-8520-f8e7c2d7c49d/9781508245360.jpg/600x600bb.jpg",
                "country": "USA",
                "currency": "USD",
                "explicit": "cleaned",
                "artist_id": 2024797,
                "artist_url": "https://books.apple.com/us/author/stephen-king/id2024797?uo=4",
                "artist_name": "Stephen King",
                "description": "<b>#1 <i>New York Times </i>bestselling author Stephen King’s terrifying novella about a town engulfed in a dense, mysterious mist—as humanity makes its last stand against unholy destruction—now available as a stand-alone edition.</b><br /><br />David Drayton, his son Billy, and their neighbor Brent Norton head to the local grocery store to replenish supplies following a freak storm. Once there, they and other local citizens are trapped by a strange mist that has enveloped the town and in which strange creatures are lurking. As the mist takes its toll on the nerves of those trapped in the store, a religious zealot, Mrs. Carmody begins to play on their fears to convince them that this is God’s vengeance for their sins and that a sacrifice must be made and two groups—those for and thos
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search/ebooks` — Search ebooks

**Parameters:**
- `term` (query, required, string) — Search term Example: `harry potter`
- `limit` (query, optional, string) — Max results Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/itunes-api/v1/search/ebooks?term=harry+potter&limit=25"
```

**Response:**
```json
{
    "data": {
        "term": "harry potter",
        "count": 30,
        "media": "ebook",
        "results": [
            {
                "kind": "ebook",
                "price": 11.99,
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Publication211/v4/bd/f8/2f/bdf82fe6-9d8e-4825-96d9-89c43bf7a547/9781781105849.jpg/600x600bb.jpg",
                "currency": "USD",
                "track_id": 1037193578,
                "artist_id": 79595314,
                "track_url": "https://books.apple.com/us/book/harry-potter-and-the-sorcerers-stone-enhanced-edition/id1037193578?uo=4",
                "artist_url": "https://books.apple.com/us/artist/j-k-rowling/79595314?uo=4",
                "track_name": "Harry Potter and the Sorcerer's Stone (Enhanced Edition)",
                "artist_name": "J.K. Rowling",
                "description": "\"Turning the envelope over, his hand trembling, Harry saw a purple wax seal bearing a coat of arms; a lion, an eagle, a badger and a snake surrounding a large letter 'H'.\"<br /><br />Harry Potter has never even heard of Hogwarts when the letters start dropping on the doormat at number four, Privet Drive. Addressed in green ink on yellowish parchment with a purple seal, they are swiftly confiscated by his grisly aunt and uncle. Then, on Harry's eleventh birthday, a great beetle-eyed giant of a man called Rubeus Hagrid bursts in with some astonishing news: Harry Potter is a wizard, and he has a place at Hogwarts School
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search/music` — Search songs

**Parameters:**
- `term` (query, required, string) — Search term Example: `the weeknd`
- `limit` (query, optional, string) — Max results Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/itunes-api/v1/search/music?term=the+weeknd&limit=25"
```

**Response:**
```json
{
    "data": {
        "term": "the weeknd",
        "count": 25,
        "media": "music",
        "results": [
            {
                "kind": "song",
                "genre": "R&B/Soul",
                "price": 1.29,
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/2a/aa/b4/2aaab42a-a4cb-a600-4a25-d78961495960/18UMGIM17204.rgb.jpg/600x600bb.jpg",
                "country": "USA",
                "currency": "USD",
                "explicit": "notExplicit",
                "track_id": 1363310482,
                "artist_id": 479756766,
                "track_url": "https://music.apple.com/us/album/call-out-my-name/1363309866?i=1363310482&uo=4",
                "artist_url": "https://music.apple.com/us/artist/the-weeknd/479756766?uo=4",
                "track_name": "Call Out My Name",
                "artist_name": "The Weeknd",
                "preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/d1/2f/3d/d12f3d43-a2e2-eba4-8db5-91f3f3c13f5a/mzaf_8470584399239689698.plus.aac.p.m4a",
                "track_count": 6,
                "release_date": "2018-03-30T12:00:00Z",
                "track_number": 1,
                "wrapper_type": "track",
                "collection_id": 1363309866,
                "track_time_ms": 228382,
                "collection_url": "https://music.apple.com/us/album/call-out-my-name/1363309866?i=1363310482&uo=4",
                "collection_name": "My Dear Melancholy,",
   
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search/podcasts` — Search podcasts

**Parameters:**
- `term` (query, required, string) — Search term Example: `joe rogan`
- `limit` (query, optional, string) — Max results Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/itunes-api/v1/search/podcasts?term=joe+rogan&limit=25"
```

**Response:**
```json
{
    "data": {
        "term": "joe rogan",
        "count": 19,
        "media": "podcast",
        "results": [
            {
                "kind": "podcast",
                "genre": "Comedy",
                "price": 0,
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/33/11/6f/33116fdc-3ed2-1ddf-6dd5-e0f34446a7de/mza_7460778646059903122.jpg/600x600bb.jpg",
                "country": "USA",
                "currency": "USD",
                "explicit": "explicit",
                "feed_url": "https://feeds.megaphone.fm/GLT1412515089",
                "track_id": 360084272,
                "artist_id": 974891224,
                "track_url": "https://podcasts.apple.com/us/podcast/the-joe-rogan-experience/id360084272?uo=4",
                "artist_url": "https://podcasts.apple.com/us/artist/joe-rogan/974891224?uo=4",
                "track_name": "The Joe Rogan Experience",
                "artist_name": "Joe Rogan",
                "track_count": 2000,
                "release_date": "2026-06-05T17:00:00Z",
                "wrapper_type": "track",
                "collection_id": 360084272,
                "track_time_ms": 10129,
                "collection_url": "https://podcasts.apple.com/us/podcast/the-joe-rogan-experience/id360084272?uo=4",
                "content_rating": "Explicit",
                "collection_name": "The Joe Rogan Experience",
                "release_date_utc": "2026-06-05T17:00:00Z"
            },
            
…(truncated, see openapi.json for full schema)
```

### Lookup

#### `GET /v1/album` — Album and tracks by id

**Parameters:**
- `id` (query, required, string) — iTunes album (collection) id Example: `697194953`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/itunes-api/v1/album?id=697194953"
```

**Response:**
```json
{
    "data": {
        "album": {
            "genre": "Dance",
            "price": 9.99,
            "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/fd/4a/77/fd4a77db-0ebc-d043-41a2-f32fa1bb0fb4/dj.qrikkdwj.jpg/600x600bb.jpg",
            "country": "USA",
            "currency": "USD",
            "explicit": "notExplicit",
            "artist_id": 5468295,
            "artist_url": "https://music.apple.com/us/artist/daft-punk/5468295?uo=4",
            "artist_name": "Daft Punk",
            "track_count": 14,
            "release_date": "2001-03-12T08:00:00Z",
            "wrapper_type": "collection",
            "collection_id": 697194953,
            "collection_url": "https://music.apple.com/us/album/discovery/697194953?uo=4",
            "collection_name": "Discovery",
            "release_date_utc": "2001-03-12T08:00:00Z"
        },
        "tracks": [
            {
                "kind": "song",
                "genre": "Dance",
                "price": 1.29,
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/fd/4a/77/fd4a77db-0ebc-d043-41a2-f32fa1bb0fb4/dj.qrikkdwj.jpg/600x600bb.jpg",
                "country": "USA",
                "currency": "USD",
                "explicit": "notExplicit",
                "track_id": 697195462,
                "artist_id": 5468295,
                "track_url": "https://music.apple.com/us/album/one-more-time/697194953?i=697195462&uo=4",
                "artist_url": "https://mus
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/artist` — Artist by id

**Parameters:**
- `id` (query, required, string) — iTunes artist id Example: `5468295`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/itunes-api/v1/artist?id=5468295"
```

**Response:**
```json
{
    "data": {
        "artist": {
            "genre": "Dance",
            "artist_id": 5468295,
            "artist_name": "Daft Punk",
            "wrapper_type": "artist"
        }
    },
    "meta": {
        "timestamp": "2026-06-07T16:48:42.599Z",
        "request_id": "c1067b28-a1aa-46a3-811d-f83ff6176306"
    },
    "status": "ok",
    "message": "Artist retrieved successfully",
    "success": true
}
```

#### `GET /v1/artist/albums` — Artist albums

**Parameters:**
- `id` (query, required, string) — iTunes artist id Example: `5468295`
- `limit` (query, optional, string) — Max albums Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/itunes-api/v1/artist/albums?id=5468295&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "albums": [
            {
                "genre": "Pop",
                "price": 11.99,
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/e8/43/5f/e8435ffa-b6b9-b171-40ab-4ff3959ab661/886443919266.jpg/600x600bb.jpg",
                "country": "USA",
                "currency": "USD",
                "explicit": "notExplicit",
                "artist_id": 5468295,
                "artist_url": "https://music.apple.com/us/artist/daft-punk/5468295?uo=4",
                "artist_name": "Daft Punk",
                "track_count": 14,
                "release_date": "2013-05-17T07:00:00Z",
                "wrapper_type": "collection",
                "collection_id": 617154241,
                "collection_url": "https://music.apple.com/us/album/random-access-memories/617154241?uo=4",
                "collection_name": "Random Access Memories",
                "release_date_utc": "2013-05-17T07:00:00Z"
            },
            {
                "genre": "Dance",
                "price": 9.99,
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/fd/4a/77/fd4a77db-0ebc-d043-41a2-f32fa1bb0fb4/dj.qrikkdwj.jpg/600x600bb.jpg",
                "country": "USA",
                "currency": "USD",
                "explicit": "notExplicit",
                "artist_id": 5468295,
                "artist_url": "https://music.apple.com/us/artist/daft-punk/5468295?uo=4",
                "ar
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/artist/songs` — Artist songs

**Parameters:**
- `id` (query, required, string) — iTunes artist id Example: `5468295`
- `limit` (query, optional, string) — Max songs Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/itunes-api/v1/artist/songs?id=5468295&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "songs": [
            {
                "kind": "song",
                "genre": "Pop",
                "price": 1.29,
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/e8/43/5f/e8435ffa-b6b9-b171-40ab-4ff3959ab661/886443919266.jpg/600x600bb.jpg",
                "country": "USA",
                "currency": "USD",
                "explicit": "notExplicit",
                "track_id": 617154366,
                "artist_id": 5468295,
                "track_url": "https://music.apple.com/us/album/get-lucky/617154241?i=617154366&uo=4",
                "artist_url": "https://music.apple.com/us/artist/daft-punk/5468295?uo=4",
                "track_name": "Get Lucky",
                "artist_name": "Daft Punk, Pharrell Williams & Nile Rodgers",
                "preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview126/v4/d4/d3/1e/d4d31eb4-7405-b806-8346-3c52ad5b4cf4/mzaf_8095545455942962509.plus.aac.p.m4a",
                "track_count": 13,
                "release_date": "2013-04-19T07:00:00Z",
                "track_number": 8,
                "wrapper_type": "track",
                "collection_id": 617154241,
                "track_time_ms": 369629,
                "collection_url": "https://music.apple.com/us/album/get-lucky/617154241?i=617154366&uo=4",
                "collection_name": "Random Access Memories",
                "release_date_utc": "2013-04-19T07:00:00Z"
      
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/lookup` — Lookup by id

**Parameters:**
- `id` (query, required, string) — iTunes id Example: `5468295`
- `entity` (query, optional, string) — Filter entity (album, song, podcastEpisode)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/itunes-api/v1/lookup?id=5468295"
```

**Response:**
```json
{
    "data": {
        "count": 1,
        "results": [
            {
                "genre": "Dance",
                "artist_id": 5468295,
                "artist_name": "Daft Punk",
                "wrapper_type": "artist"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-07T16:48:43.018Z",
        "request_id": "298ad50a-36a6-4d2f-be5d-3f4b1f22943b"
    },
    "status": "ok",
    "message": "Item retrieved successfully",
    "success": true
}
```

#### `GET /v1/podcast/episodes` — Podcast episodes by id

**Parameters:**
- `id` (query, required, string) — iTunes podcast id Example: `360084272`
- `limit` (query, optional, string) — Max episodes Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/itunes-api/v1/podcast/episodes?id=360084272&limit=20"
```

**Response:**
```json
{
    "data": {
        "podcast": {
            "kind": "podcast",
            "genre": "Comedy",
            "price": 0,
            "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/33/11/6f/33116fdc-3ed2-1ddf-6dd5-e0f34446a7de/mza_7460778646059903122.jpg/600x600bb.jpg",
            "country": "USA",
            "currency": "USD",
            "explicit": "explicit",
            "feed_url": "https://feeds.megaphone.fm/GLT1412515089",
            "track_id": 360084272,
            "artist_id": 974891224,
            "track_url": "https://podcasts.apple.com/us/podcast/the-joe-rogan-experience/id360084272?uo=4",
            "artist_url": "https://podcasts.apple.com/us/artist/joe-rogan/974891224?uo=4",
            "track_name": "The Joe Rogan Experience",
            "artist_name": "Joe Rogan",
            "track_count": 2000,
            "release_date": "2026-06-05T17:00:00Z",
            "wrapper_type": "track",
            "collection_id": 360084272,
            "track_time_ms": 10129,
            "collection_url": "https://podcasts.apple.com/us/podcast/the-joe-rogan-experience/id360084272?uo=4",
            "content_rating": "Explicit",
            "collection_name": "The Joe Rogan Experience",
            "release_date_utc": "2026-06-05T17:00:00Z"
        },
        "episodes": [
            {
                "kind": "podcast-episode",
                "artwork": "https://is1-ssl.mzstatic.com/image/thumb/Podcasts221/v4/06/f9/91/06f99174-e874-dd50-3ad8-86eb
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

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

**Response:**
```json
{
    "data": {
        "service": "itunes-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/album": "Album and its tracks by id.",
            "GET /v1/artist": "Artist by id.",
            "GET /v1/lookup": "Lookup any item by id.",
            "GET /v1/search": "Search any media (term, media, entity).",
            "GET /v1/artist/songs": "An artist's songs.",
            "GET /v1/search/music": "Search songs.",
            "GET /v1/artist/albums": "An artist's albums.",
            "GET /v1/search/albums": "Search albums.",
            "GET /v1/search/ebooks": "Search ebooks.",
            "GET /v1/search/podcasts": "Search podcasts.",
            "GET /v1/podcast/episodes": "A podcast and its episodes.",
            "GET /v1/search/audiobooks": "Search audiobooks."
        },
        "description": "iTunes / Apple Media: music, podcasts, movies, ebooks, audiobooks; artist, album and podcast lookups — real live data."
    },
    "meta": {
        "timestamp": "2026-06-07T16:48:43.238Z",
        "request_id": "77232021-04ae-47ca-8411-b5c66eccb805"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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