Apple Music API

Scrape public Apple Music data with one API

Name: Apple Music Data API
Brand: SocialCrawl
Availability: InStock

Fetch public Apple Music artists, albums, tracks, and search as structured JSON with one SocialCrawl API key. Same Author and Post schema as every other platform. Reads are priced in credits.

Read the docs How it works Try live

/v1/apple_music

4 active endpoints

GET /v1/apple_music/search
GET /v1/apple_music/artist
GET /v1/apple_music/album
GET /v1/apple_music/track

What Apple Music endpoints does SocialCrawl ship?

Four live read endpoints for public Apple Music catalog data. Keyword search, then artist, album, and track by id or URL. Data API only. No playback control, no private library, no MusicKit in your client.

Catalog search

1 credit

/v1/apple_music/search

Catalog hits for a keyword. Optional type restricts the kind to song, album, or artist. Single page. Deepen a hit with artist, album, or track.

query, optional type

Artist

1 credit

/v1/apple_music/artist

One artist: id, name, artwork, and the Apple Music artist URL. Address by music.apple.com artist URL or id.

id or url

Album

1 credit

/v1/apple_music/album

One album: title, artist, artwork, track count, and the Apple Music album URL. Address by album URL or id.

id or url

Track

1 credit

/v1/apple_music/track

One track: title, artist, duration, preview audio URL, and the Apple Music track URL. Address by track URL or id.

id or url

Apple Music API4 endpoints supported

View docs

Returns Apple Music search results for a query, optionally restricted by type such as song, album, or artist.

Use it to find a catalog item by keyword, then call artist, album, or track with an id or URL for the full record.

GET/v1/apple_music/search?query=taylor+swift&type=song

query

query · Search query.

$ curl https://www.socialcrawl.dev/v1/apple_music/search?query=taylor+swift&type=song \
    -H "x-api-key: sc_YOUR_API_KEY"

— · idle

// Running this live needs your own API key — hit "Try it" to see an example response

How the Apple Music API works

Apple Music is a normal SocialCrawl social surface. You call GET /v1/apple_music/… with an API key, spend credits on live misses, and get a single JSON envelope back. No MusicKit. No Apple developer token in your client. No second SDK.

Authenticate every call

Send your key in the x-api-key header. No MusicKit flow in your app. The same key works across the SocialCrawl catalog.

GET with query params

All Apple Music routes are GET. Pass query, type, url, and id as query strings. We validate formats before charging.

Pay in credits, not seats

Every Apple Music read costs 1 credit on a live miss. Cache hits cost 0. Empty or hard failures refund.

Read one JSON envelope

Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Search is a single page.

The usual integration chain

Most products search the catalog, then deepen only the artist, album, or track that matters.

01Search

GET /v1/apple_music/search?query=…

Catalog hits for a keyword, optionally filtered by type

Find an id or URL before you spend a call on the full record.

02Artist

GET /v1/apple_music/artist?url=…

Author-shaped artist: name, artwork, catalog URL

Resolve the performer once before listing albums or tracks.

03Album

GET /v1/apple_music/album?url=…

Post-shaped album with artwork and track count

Open the whole record when a search hit is not enough.

04Track

GET /v1/apple_music/track?url=…

Post-shaped song with duration and preview audio URL

Fetch one song when you already have the catalog URL.

request

GET /v1/apple_music/search
  ?query=taylor+swift&type=song
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

# then deepen one hit
GET /v1/apple_music/artist?url=https://music.apple.com/us/artist/taylor-swift/159260351
GET /v1/apple_music/album?url=https://music.apple.com/us/album/red-taylors-version/1590368448
GET /v1/apple_music/track?url=https://music.apple.com/us/album/22-taylors-version/1590368448?i=1590368457

response envelope

{
  "success": true,
  "data": {
    "id": "159260351",
    "username": "Taylor Swift",
    "display_name": "Taylor Swift",
    "url": "https://music.apple.com/us/artist/taylor-swift/159260351",
    "avatar_url": "https://is1-ssl.mzstatic.com/image/thumb/…"
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

What lands in data

Field names match the rest of SocialCrawl where archetypes align. Artists map to Author. Albums and tracks map to Post leaves. Search stays a SearchResult list.

Authorartist

id, username/display_name, avatar_url, url

Postalbum, track

album or track as Post: id, url, content (title, artwork, duration, preview), author, ext.apple_music

SearchResultsearch

items[] catalog hits for query; optional type filter; single page

Envelopeenvelope fields

success, data, credits_used, credits_remaining, request_id, cached

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint. Apple Music is not a sidecar.

Edge receives the call

Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).

Validate, then debit

Registry lookup finds apple_music/search (or artist, album, track). Required params and URL format checks run first. Invalid input returns 400 with no charge. Valid calls debit 1 credit atomically before upstream work.

Cache or fetch

A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: social-read upstream for Apple Music routes. Retries on 5xx/network with a circuit breaker if the source is unhealthy.

Normalize and return

Upstream JSON is mapped to Author / Post / SearchResult, validated against the canonical Zod schema, then wrapped in the success envelope and logged for billing audit.

Billing rules that matter in production

Standard live miss: 1 credit
Search, artist, album, track: all 1 credit
No advanced tier on this platform
No premium tier on this platform
Cache hit: 0 credits
Empty / hard fail: auto-refund
Bad params: 400, never charged
No credits: 402, never charged
Disabled routes: 503, never charged

How we get the data

Apple Music is public-read catalog data. We normalize it into the SocialCrawl schema so your code does not learn MusicKit or a second developer token.

What Apple Music is for this API

Public artists, albums, tracks, and keyword search. Read-only surface for research, monitoring, and product jobs. No private libraries and no playback control.

How SocialCrawl reaches it

Social-read upstreams behind one gateway. You send music.apple.com URLs or ids; we fetch and normalize without MusicKit in your client.

What leaves our edge

A unified JSON envelope: success, data, credits_used, request_id, cached. Artists become Author objects. Albums and tracks share Post leaves. Search stays a SearchResult list.

What we do not ship live

No write endpoints. No user library or playlist mutation. No playback. Prefer the registry docs for the live inventory.

field map sketch

artist card→ author.*artist name, artwork, catalog URL

album / track→ post.* + ext.apple_musicalbum or track title, artist, artwork, duration, preview

search hits→ SearchResult items[]search hits for a keyword, optionally filtered by type

What this API is used for

The jobs this API is most often used for.

4active Apple Music endpoints in the registry

1 creditflat 1 credit per live miss

Catalog enrichment and track or album lookup

Callers concentrate on keyword search, then artist, album, and track detail by URL. Public Apple Music catalog reads on the shared schema with credit pricing. No MusicKit and no Apple developer token in your client.

Artist, album, and track calls are typically a few seconds on live miss. Search can be slightly slower on cold cache.

Use case examples

Common ways teams put this data to work, and the stack each one tends to run.

Catalog enrichers

Python, workers, CMS loads

Resolve artist, album, and track URLs into structured cards. Fill internal catalogs with titles, artwork, and preview URLs.

Search then deepen

Node, workers, Explorer

Search by keyword, pick a hit, then call artist, album, or track for the full record.

Backend product jobs

Go, workers, same API key

Wire Apple Music next to Spotify on the shared schema. Same key as the rest of SocialCrawl.

Call it in two lines

Every Apple Music route is one credit per live call. Cache hits are free.

curl "https://www.socialcrawl.dev/v1/apple_music/search?query=taylor+swift&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"

Apple Music on SocialCrawl

Same key as the rest of the catalog

Platform docs Get an API key

Endpoints

What data does the Apple Music API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

SearchSearch Apple Music ArtistGet an Apple Music artist AlbumGet an Apple Music album TrackGet an Apple Music track

Comparison

How does SocialCrawl compare to Apple MusicKit API for Apple Music data?

Same Apple Music data, two very different paths. Auth, rate limits, schema, and cost — side by side.

Feature	SocialCrawl	Apple MusicKit API
Authentication	One x-api-key header	MusicKit identifier plus a signed developer token (JWT)
Setup	Sign up and call, no Apple Developer account	Apple Developer Program and MusicKit key before the first call
Rate limits	Credit-based: your only quota is your balance	Per-token Apple rate limits with 429 retry handling
Response schema	Unified JSON shared across 49 platforms	Apple Music catalog objects documented for MusicKit
Pricing	1 credit per request; 100 free credits on signup	Catalog reads are free within Apple's rate limits
Data coverage	Search, artist, album, and track catalog metadata	Full catalog plus playback and user-authorized library data
Maintenance	One integration covers Apple Music and 48 other platforms	Separate MusicKit SDK and token logic just for Apple Music

Authentication

SocialCrawl

One x-api-key header

Apple MusicKit API

MusicKit identifier plus a signed developer token (JWT)

Setup

SocialCrawl

Apple MusicKit API

Apple Developer Program and MusicKit key before the first call

Rate limits

SocialCrawl

Credit-based: your only quota is your balance

Apple MusicKit API

Per-token Apple rate limits with 429 retry handling

Response schema

SocialCrawl

Unified JSON shared across 49 platforms

Apple MusicKit API

Apple Music catalog objects documented for MusicKit

Pricing

SocialCrawl

1 credit per request; 100 free credits on signup

Apple MusicKit API

Catalog reads are free within Apple's rate limits

Data coverage

SocialCrawl

Search, artist, album, and track catalog metadata

Apple MusicKit API

Full catalog plus playback and user-authorized library data

Maintenance

SocialCrawl

One integration covers Apple Music and 48 other platforms

Apple MusicKit API

Separate MusicKit SDK and token logic just for Apple Music

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

How do I get Apple Music data with an API?

Send a GET request to any of SocialCrawl's 4 Apple Music endpoints (search, artist, album, track) with your x-api-key header. Each returns unified JSON without MusicKit, a developer token, or Apple Developer Program setup.

Is there an Apple Music data API?

Yes. SocialCrawl is an Apple Music data API that returns artist, album, and track metadata plus keyword search as unified JSON from one x-api-key. Apple's MusicKit / Apple Music API is the right tool for playback and user-library work, but it needs a developer token (JWT) and often a user token. For public catalog reads, SocialCrawl skips all of that: 4 endpoints at 1 credit each, with 100 free credits on signup.

Do I need MusicKit or an Apple developer token?

No. The official Apple Music API requires a MusicKit identifier and a signed developer token before the first catalog call. SocialCrawl needs one API key, the same key that covers 48 other platforms on the same unified schema.

What Apple Music data can I get?

Keyword search (optionally filtered by type such as song, album, or artist); artist name, artwork, and catalog URL; album title, artist, artwork, and track count; track title, artist, duration, preview audio URL, and catalog URL. Playback control and private library data are not included.

How much does the Apple Music API cost?

Every Apple Music endpoint costs 1 credit per request on the standard tier. New accounts get 100 free credits with no credit card required, so you can make around 100 calls before paying anything.

How does SocialCrawl handle Apple Music rate limits?

You never deal with Apple's per-token rate limits or 429 retry logic. SocialCrawl's upstream layer manages that for you. Your only quota is your credit balance, and repeated requests for the same resource are served from cache.

Can I use the Apple Music API in production?

Yes. The endpoints are built for production workloads with a unified schema that stays stable even when Apple changes its catalog response format. One envelope, one auth model, one credit system.

What is the best Apple Music scraper API?

For catalog metadata without MusicKit, SocialCrawl is the simplest route: 4 Apple Music endpoints (search, artist, album, track) at 1 credit per request, with 100 free credits and no card. Apple's official MusicKit API is broader for playback and user libraries, but requires a developer token and Apple Developer setup.

Is scraping Apple Music data legal?

SocialCrawl returns publicly available Apple Music data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction — you are responsible for complying with Apple Music's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.

Apple Music scraping API vs the official Apple Music API — what's the difference?

With SocialCrawl there is no app review or approval queue — sign up and call Apple Music endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Ask ChatGPT Ask Perplexity Ask Gemini Ask Claude Ask Grok

Read the Apple Music API reference in the docs

🤖 AI agent or LLM? Read this page as markdown