Apple Music
Apple Music search, artists, albums, and tracks through one unified API
Apple Music catalog reads: search by keyword, then fetch an artist, album or track by id or URL. Every endpoint is a GET and costs 1 credit.
Base URL: /v1/apple_music/...
Quickstart
1. Search the catalog
curl "https://www.socialcrawl.dev/v1/apple_music/search?query=taylor%20swift&type=song" \
-H "x-api-key: YOUR_API_KEY"2. Fetch the full record
artist, album and track each take an id or a url. Supply exactly one.
curl "https://www.socialcrawl.dev/v1/apple_music/artist?url=https://music.apple.com/us/artist/taylor-swift/159260351" \
-H "x-api-key: YOUR_API_KEY"Search
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
GET /v1/apple_music/search | 1 | Catalog matches for a keyword | query, type (a result kind such as song, album or artist) |
Search is the keyword entry point. It is the only endpoint here that does not need an id.
Catalog records
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
GET /v1/apple_music/artist | 1 | One performer's full catalog record | id or url |
GET /v1/apple_music/album | 1 | One record with its track list | id or url |
GET /v1/apple_music/track | 1 | One song | id or url |
The id is the numeric segment at the end of any music.apple.com link.
All endpoints
5 endpoints available.
| Endpoint | Path | Credit Tier |
|---|---|---|
| Get an Apple Music album | /v1/apple_music/album | standard (1cr) |
| Get an Apple Music artist | /v1/apple_music/artist | standard (1cr) |
| Get the Apple Music charts for a country | /v1/apple_music/charts | standard (1cr) |
| Search Apple Music | /v1/apple_music/search | standard (1cr) |
| Get an Apple Music track | /v1/apple_music/track | standard (1cr) |
Platform notes
artist,albumandtrackeach acceptidorurl. Supply exactly one. Sending neither is a400before billing.- Search returns a single page. There is no cursor and no offset on this platform.
- Where an endpoint supports a computed field and the required source inputs are present, the response carries it. See Computed fields for formulas, clamping rules, and null semantics. Where an endpoint supports them, list rows also carry judged labels (
computed.labels,computed.relevance) by default at no extra credits; see Labels. - All endpoints use
GETwith query parameters, and responses follow the unified SocialCrawl schema.