# Apple Music API guide



## Choose a Apple Music operation



Start with the object your task needs. The groups below use the current catalogue; open an endpoint to check accepted identifiers, filters, price and availability before retrieving.



### Other operations



- [Get an Apple Music album](https://www.monocrawl.com/docs/endpoints/apple_music/album) — Look up one Apple Music album by id or music.apple.com URL, including its full track listing.

- [Get an Apple Music artist](https://www.monocrawl.com/docs/endpoints/apple_music/artist) — Look up one Apple Music artist by id or music.apple.com URL.

- [Get an Apple Music track](https://www.monocrawl.com/docs/endpoints/apple_music/track) — Look up one Apple Music track by id or music.apple.com URL, with preview audio and album context.



### Search and discovery



- [Search Apple Music](https://www.monocrawl.com/docs/endpoints/apple_music/search) — Search Apple Music artists, albums, and tracks by keyword.



## Check fields and collection limits



Use the endpoint’s declared parameters and returned continuation. Filters from another platform do not automatically apply here. Preserve source identifiers, URLs and warnings; a successful page does not establish complete history. Published response schemas identify whether they come from a reviewed shaper or observed response shapes.



Agents can use `get_endpoint` for the current contract and `get_docs` with topic `platforms/apple_music` to read this page. The [coverage guide](https://www.monocrawl.com/docs/data-availability) explains nulls and partial results, and the [production guide](https://www.monocrawl.com/docs/production-checklist) covers budgets and recovery.



## Endpoint reference

## apple_music/album

`GET /v1/apple_music/album`

Look up one Apple Music album by id or music.apple.com URL, including its full track listing.

*Get an Apple Music album*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | Apple Music album id (this or url) — e.g. `697194953` |
| `url` | no | music.apple.com album URL (this or id) — e.g. `https://music.apple.com/us/album/discovery/697194953` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/apple_music/album?url=https%3A%2F%2Fmusic.apple.com%2Fus%2Falbum%2Fdiscovery%2F697194953" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "artist": {
    "id": "example",
    "name": "example",
    "url": "https://example.com/example"
  },
  "artwork_url": "https://example.com/example",
  "copyright": "example",
  "currency": "example",
  "explicit": false,
  "genre": "example",
  "id": "example",
  "kind": "example",
  "price": 0,
  "release_date": "2026-09-01T12:00:00Z",
  "title": "example",
  "track_count": 0,
  "tracks": [
    {
      "album": {
        "id": "example",
        "title": "example",
        "url": "https://example.com/example"
      },
      "artist": {
        "id": "example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "artwork_url": "https://example.com/example",
      "currency": "example",
      "disc_number": 0,
      "duration_ms": 0,
      "explicit": false,
      "genre": "example",
      "id": "example",
      "kind": "example",
      "media_kind": "example",
      "preview_url": "https://example.com/example",
      "price": 0,
      "release_date": "2026-09-01T12:00:00Z",
      "title": "example",
      "track_number": 0,
      "url": "https://example.com/example"
    }
  ],
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/apple_music/album#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/apple_music/album.json)


## apple_music/artist

`GET /v1/apple_music/artist`

Look up one Apple Music artist by id or music.apple.com URL.

*Get an Apple Music artist*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | Apple Music artist id (this or url) — e.g. `5468295` |
| `url` | no | music.apple.com artist URL (this or id) — e.g. `https://music.apple.com/us/artist/daft-punk/5468295` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/apple_music/artist?url=https%3A%2F%2Fmusic.apple.com%2Fus%2Fartist%2Fdaft-punk%2F5468295" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "artist_type": "example",
  "genre": "example",
  "id": "example",
  "kind": "example",
  "name": "example",
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/apple_music/artist#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/apple_music/artist.json)


## apple_music/search

`GET /v1/apple_music/search`

Search Apple Music artists, albums, and tracks by keyword.

*Search Apple Music*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search terms — e.g. `daft punk` |
| `type` | no | Restrict results: artist, album, or track (omit for all music) Accepted values: artist, album, track. Case, spaces, hyphens and underscores are interchangeable. — e.g. `artist` |
| `limit` | no | Max results, 1-50 (default 25) — e.g. `25` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/apple_music/search?query=daft%20punk" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "items": [
    {
      "album": {
        "id": "example",
        "title": "example",
        "url": "https://example.com/example"
      },
      "artist": {
        "id": "example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "artwork_url": "https://example.com/example",
      "currency": "example",
      "disc_number": 0,
      "duration_ms": 0,
      "explicit": false,
      "genre": "example",
      "id": "example",
      "kind": "example",
      "media_kind": "example",
      "preview_url": "https://example.com/example",
      "price": 0,
      "release_date": "2026-09-01T12:00:00Z",
      "title": "example",
      "track_number": 0,
      "url": "https://example.com/example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/apple_music/search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/apple_music/search.json)


## apple_music/track

`GET /v1/apple_music/track`

Look up one Apple Music track by id or music.apple.com URL, with preview audio and album context.

*Get an Apple Music track*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | Apple Music track id (this or url) — e.g. `697195462` |
| `url` | no | music.apple.com track or album?i= URL (this or id) — e.g. `https://music.apple.com/us/album/discovery/697194953?i=697195462` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/apple_music/track?url=https%3A%2F%2Fmusic.apple.com%2Fus%2Falbum%2Fdiscovery%2F697194953%3Fi%3D697195462" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "album": {
    "id": "example",
    "title": "example",
    "url": "https://example.com/example"
  },
  "artist": {
    "id": "example",
    "name": "example",
    "url": "https://example.com/example"
  },
  "artwork_url": "https://example.com/example",
  "currency": "example",
  "disc_number": 0,
  "duration_ms": 0,
  "explicit": false,
  "genre": "example",
  "id": "example",
  "kind": "example",
  "media_kind": "example",
  "preview_url": "https://example.com/example",
  "price": 0,
  "release_date": "2026-09-01T12:00:00Z",
  "title": "example",
  "track_number": 0,
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/apple_music/track#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/apple_music/track.json)