# iTunes Search API

> Search Apple's iTunes and App Store catalog: music, albums, podcasts, apps, movies, books, prices

- Vendor: `itunessearchapi` · version 1.0 · category Music · tags itunes api, apple music search api, app store search api, podcast search api, album lookup api, apple catalog api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/itunessearchapi
- This document: https://apiclay.com/docs/itunessearchapi.md
- OpenAPI 3.1: https://apiclay.com/api/itunessearchapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `itunessearchapi`
- Updated: 2026-11-18

## About

## iTunes Search API

Search Apple's catalog through the iTunes Search API: songs, albums, artists, podcasts, music videos, iOS and Mac apps, movies, TV and books, with prices, release dates, genres, artwork and store links, in any country storefront; and look items up by iTunes id, UPC or ISBN.

Data comes from **apple.com** (https://www.apple.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/search?term=jack johnson&amp;entity=album&amp;country=US&amp;limit=10`, then `/lookup?id=909253&amp;entity=album`.

### Routes

#### GET `/search` - Search catalog
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| term | query | string | yes | Search words. |
| media | query | string | no | `music`, `podcast`, `software`, `movie`, `ebook`... |
| entity | query | string | no | e.g. `song`, `album`, `musicArtist`, `software`. |
| attribute | query | string | no | Field to search, e.g. `artistTerm`. |
| country | query | string | no | Two-letter storefront, e.g. `US`. |
| limit | query | number | no | Up to 200. |

Returns: `resultCount`, `results[]` with names, ids, `collectionPrice`/`price`, `releaseDate`, `primaryGenreName`, artwork URLs and store URLs.

#### GET `/lookup` - Lookup
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | query | string | no | iTunes id(s), comma-separated. |
| upc | query | string | no | Album UPC. |
| isbn | query | string | no | Book ISBN. |
| entity | query | string | no | Related items, e.g. `album`. |
| country | query | string | no | Storefront. |
| limit | query | number | no | Max. |

Returns: same shape as search.

### Caveats

- Apple asks for about 20 calls a minute at most.
- The response is JSON sent as `text/javascript`.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by apple.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Search catalog
- Gateway: `GET https://api.apiclay.com/v1/api/itunessearchapi/search`
- Public query params: `term` (string, required), `media` (string), `entity` (string), `attribute` (string), `country` (string), `limit` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /lookup — Lookup
- Gateway: `GET https://api.apiclay.com/v1/api/itunessearchapi/lookup`
- Public query params: `id` (string), `upc` (string), `isbn` (string), `entity` (string), `country` (string), `limit` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/itunessearchapi/search?term=<term>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
