# iTunes



Apple's catalog — search the songs, albums, podcasts, movies, apps, and ebooks in the biggest store on earth.



## iTunes Search

Apple's catalog — search the songs, albums, podcasts, movies, apps, and ebooks in the biggest store on earth.

- Method: `GET`
- Path: `/v1/entertainment/itunes-search`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `q` | string | required | Search terms. |
| `entity` | string | optional | `song`, `album`, `podcast`, `movie`, `ebook`, `software`, and more. |
| `limit` | integer | optional | 1 to 50 results. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/entertainment/itunes-search \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "query": "daft punk",
    "entity": "song",
    "items": [
      {
        "id": "2176301",
        "kind": "song",
        "name": "Harder, Better, Faster, Stronger",
        "artist": "Daft Punk",
        "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music/…/600x600.jpg",
        "previewUrl": "https://audio-ssl.itunes.apple.com/…/preview.m4a",
        "url": "https://music.apple.com/album/2176301",
        "releaseDate": "2001-03-07",
        "genre": "Electronic",
        "durationMs": 224000
      }
    ]
  },
  "meta": { "request_id": "req_7Q2fK4mZ", "as_of": "2026-08-22T04:05:00.000Z", "age_seconds": 42, "next_update_at": "2026-08-23T04:05:00.000Z" }
}
```

## Podcast Directory

Apple's podcast catalog — the directory every podcast app starts from.

- Method: `GET`
- Path: `/v1/entertainment/itunes-search?entity=podcast`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `q` | string | required | Search terms. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/entertainment/itunes-search?entity=podcast \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "query": "startup",
    "entity": "podcast",
    "items": [
      {
        "id": "1001820123",
        "kind": "podcast",
        "name": "StartUp Podcast",
        "artist": "Gimlet",
        "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/…/600x600.jpg",
        "url": "https://podcasts.apple.com/podcast/1001820123",
        "genre": "Business",
        "trackCount": 128
      }
    ]
  },
  "meta": { "request_id": "req_7Q2fK4mZ", "as_of": "2026-08-22T04:05:00.000Z", "age_seconds": 42, "next_update_at": "2026-08-23T04:05:00.000Z" }
}
```