Apple Music
Search
per_call
Searches the Apple Music catalog and returns matches per entity type with IDs, names, artwork and store URLs, optionally narrowed to a single type. Useful for cross-platform catalog matching and for enriching a music dataset that already has Spotify identifiers.
What you get
Each call returns one search result record. There is no pagination.
Endpoint
GET /v1/apple-music/search
Price
$1.50
per 1,000 calls · $0.0015 per call
Cost per call
1 credit
Failed calls never charged
Parameters
query
required
stringKeyword to search across Apple Music catalog entities.
type
optional
enumRestrict results to a single entity type. Defaults to all.
One of: all, song, album, artist, playlist, station, music_video
fresh
optional
enumBypass cached data and force a live fetch for this one call. Use it for daily monitoring or any figure you are tracking over time. Accepts `true`, `1`, `false` or `0`; anything else returns 400 `invalid_fresh`. Defaults to false and costs exactly the same as a cached call.
One of: true, 1, false, 0
Example request
Live call. Successful calls are charged; failed and empty results are not.
curl
curl "https://fastfetchz.com/v1/apple-music/search?query=tame%20impala" \
-H "X-API-Key: $FASTFETCHZ_KEY"Example response
200 application/json
{
"success": true,
"service": {
"platform": "Apple Music",
"name": "Search",
"slug": "search"
},
"credits_charged": 1,
"credits_remaining": 99,
"latency_ms": 214,
"data": {
"query": "coldplay",
"type": "all",
"sections": [
{
"id": "top-search-section - top",
"title": "Top Results",
"items": [
{
"id": "471744",
"kind": "artist",
"title": "Coldplay",
"subtitle": "Artist",
"album": null,
"url": "https://music.apple.com/us/artist/coldplay/471744",
"artwork": {
"url": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/63/94/ac/6394acdd-a223-049c-e373-5a3597c3858e/9947797f-59c5-420d-9c1d-81be5a7b5889_ami-identity-627a3a5a7feb2fd65e55602f252c9aa8-2024-06-17T12-11-33.334Z_cropped.png/1200x1200bb.jpg",
"width": 1681,
"height": 1681,
"bgColor": "0090d5",
"textColor1": "0d0912",
"textColor2": "121118",
"textColor3": "0b2439",
"textColor4": "0f2a3e"
},
"duration_ms": null,
"track_number": null,
"disc_number": null,
"artist_name": null,
"explicit": false,
"preview_url": null,
"track_count": null
},
{
"id": "pl.0b42b4ce31584d949e6a0603f3777e6e",
"kind": "playlist",
"title": "Coldplay Essentials",
"subtitle": "Playlist · Apple Music Alternative",
"album": null,
"url": "https://music.apple.com/us/playlist/coldplay-essentials/pl.0b42b4ce31584d949e6a0603f3777e6e",
"artwork": {
"url": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/63/94/ac/6394acdd-a223-049c-e373-5a3597c3858e/9947797f-59c5-420d-9c1d-81be5a7b5889_ami-identity-627a3a5a7feb2fd65e55602f252c9aa8-2024-06-17T12-11-33.334Z_cropped.png/1200x1200SC.FPESS04.jpg?l=en-US",
"width": 1080,
"height": 1080,
"bgColor": "0090d5",
"textColor1": "0d0912",
"textColor2": "121118",
"textColor3": "0b2439",
"textColor4": "0f2a3e"
},
"duration_ms": null,
"track_number": null,
"disc_number": null,
"artist_name": null,
"explicit": false,
"preview_url": null,
"track_count": null
}
]
},
{
"id": "bubble-section - artist",
"title": "Artists",
"items": [
{
"id": "471744",
"kind": "artist",
"title": "Coldplay",
"subtitle": null,
"album": null,
"url": "https://music.apple.com/us/artist/coldplay/471744",
"artwork": {
"url": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/63/94/ac/6394acdd-a223-049c-e373-5a3597c3858e/9947797f-59c5-420d-9c1d-81be5a7b5889_ami-identity-627a3a5a7feb2fd65e55602f252c9aa8-2024-06-17T12-11-33.334Z_cropped.png/1200x1200bb.jpg",
"width": 1681,
"height": 1681,
"bgColor": "0090d5",
"textColor1": "0d0912",
"textColor2": "121118",
"textColor3": "0b2439",
"textColor4": "0f2a3e"
},
"duration_ms": null,
"track_number": null,
"disc_number": null,
"artist_name": null,
"explicit": false,
"preview_url": null,
"track_count": null
},
{
"id": "920870729",
"kind": "artist",
"title": "ColdPlay Wu",
"subtitle": null,
"album": null,
"url": "https://music.apple.com/us/artist/coldplay-wu/920870729",
"artwork": {
"url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/5c/72/83/5c728302-82df-c6b5-a9af-bbd34cb63293/artwork.jpg/1200x1200ac.jpg",
"width": 3000,
"height": 3000,
"bgColor": "000000",
"textColor1": "efefec",
"textColor2": "f1cb92",
"textColor3": "bfbfbd",
"textColor4": "c0a275"
},
"duration_ms": null,
"track_number": null,
"disc_number": null,
"artist_name": null,
"explicit": false,
"preview_url": null,
"track_count": null
}
]
}
]
}
}Limits
- Maximum per call: 9 search results.
- Minimum per call: 1 search result — a target with less data returns fewer search results, and an empty result is still a successful call.
- Each call fetches a full page of up to 9 and costs the same either way. Pass limit to receive fewer than that in the response.
- This endpoint returns a single record per call and is not paginated.
What this costs in practice
10,000 search results = 10,000 calls × 1 credits per call = 10,000 credits = $0.00
Priced at the Custom pack rate: 1,000,000 credits for $0.00.
Open in the pricing calculatorError codes
StatusCodeMeaning
401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.
402insufficient_creditsYour balance is below the cost of the call. Top up to continue.
403account_suspended / key_revokedThe account is suspended or the key was revoked.
429rate_limitedOver your account's requests-per-second limit. Retrying helps: the body carries retry_after_seconds and the response carries a Retry-After header. Not charged.
429monthly_cap_reachedThis key used the monthly call cap you set for it. Retrying will not help — raise the cap, use another key, or wait for the next calendar month. No Retry-After header is sent. Not charged.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.