SocialCrawl

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
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
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"
EndpointCreditsWhat it returnsKey parameters
GET /v1/apple_music/search1Catalog matches for a keywordquery, 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

EndpointCreditsWhat it returnsKey parameters
GET /v1/apple_music/artist1One performer's full catalog recordid or url
GET /v1/apple_music/album1One record with its track listid or url
GET /v1/apple_music/track1One songid or url

The id is the numeric segment at the end of any music.apple.com link.

All endpoints

5 endpoints available.

EndpointPathCredit Tier
Get an Apple Music album/v1/apple_music/albumstandard (1cr)
Get an Apple Music artist/v1/apple_music/artiststandard (1cr)
Get the Apple Music charts for a country/v1/apple_music/chartsstandard (1cr)
Search Apple Music/v1/apple_music/searchstandard (1cr)
Get an Apple Music track/v1/apple_music/trackstandard (1cr)

How far back and how deep

Each list returns one page at a time. Send cursor for the next page, or max_items or max_pages to collect several pages in one call. A page size appears only where it has been verified. How paging works

PathRows per pageDate windowOne call collects
/v1/apple_music/chartsvariessince and until, applied to each page fetchedlimit up to 100

Country and region

country and region do different jobs on different endpoints. Each line below says what the parameter does there. How they differ

  • country on /v1/apple_music/charts: Country as an ISO 3166-1 alpha-2 code, in any case (us, DE, kr). Apple Music publishes a chart for most countries where it is sold; one it does not is rejected with a free 400. uk is read as gb. Defaults to us.

Platform notes

  • artist, album and track each accept id or url. Supply exactly one. Sending neither is a 400 before 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 GET with query parameters, and responses follow the unified SocialCrawl schema.

Next steps

On this page