# Apple Music (/docs/apple_music)



Apple Music [#apple-music]

Apple Music catalog reads: search, then artist, album, or track by id or URL. Same 1-credit standard tier as Spotify.

Base URL: `/v1/apple_music/...`

Getting Started [#getting-started]

1\. Search, then fetch one record [#1-search-then-fetch-one-record]

```bash
curl "https://www.socialcrawl.dev/v1/apple_music/search?query=taylor%20swift&type=song" \
  -H "x-api-key: sc_your_api_key_here"

curl "https://www.socialcrawl.dev/v1/apple_music/artist?url=https://music.apple.com/us/artist/taylor-swift/159260351" \
  -H "x-api-key: sc_your_api_key_here"
```

`search` is the keyword entry. `artist`, `album`, and `track` take `id` or `url` for the full record.

2\. Read computed fields [#2-read-computed-fields]

When an endpoint supports a computed field and the required source inputs are present, the unified response includes that optional field. Depending on the endpoint, optional fields can include `engagement_rate`, `language`, `content_category`, and `estimated_reach`. See [Computed fields](/docs/computed-fields.md) for formulas, clamping rules, and null semantics.

Endpoints [#endpoints]

<PlatformEndpoints platform="apple_music" />

Notes [#notes]

* All endpoints use `GET` method with query parameters
* Authentication via `x-api-key` header
* Responses follow the unified SocialCrawl schema