Headers
Get your API keyAPI key (`sfk_...`)
Search query text for Apple Music catalog results.
min 1 chars · max 512 chars
Catalog result type to return. Omit to search across types (treated as all).
one of: all, song, album, artist, playlist, station, music_video, radio_episode
Endpoint-specific response payload.
Search query string evaluated for this response.
min 1 chars
Result type applied for this response.
one of: all, song, album, artist, playlist, station, music_video, radio_episode
Matching Apple Music artists.
Stable Apple Music artist identifier.
min 1 chars
Artist display name.
min 1 chars
Canonical public Apple Music artist URL when available.
Best available square artwork image URL when available.
Matching Apple Music albums.
Stable Apple Music album identifier.
min 1 chars
Album title.
min 1 chars
Primary artist display name when available.
Canonical public Apple Music album URL when available.
Number of tracks on the album when available.
≥ 0
Best available square artwork image URL when available.
Whether the album is marked explicit when available.
Matching Apple Music songs.
Stable Apple Music song identifier.
min 1 chars
Song title.
min 1 chars
Primary artist display name when available.
Canonical public Apple Music song URL when available.
Track duration in milliseconds when available.
≥ 0
Best available square artwork image URL when available.
Whether the track is marked explicit when available.
Short audio preview URL when available.
Matching Apple Music playlists.
Stable Apple Music playlist identifier.
min 1 chars
Playlist title.
min 1 chars
Canonical public Apple Music playlist URL when available.
Best available square artwork image URL when available.
Matching Apple Music stations.
Stable Apple Music station identifier.
min 1 chars
Station title.
min 1 chars
Canonical public Apple Music station URL when available.
Best available square artwork image URL when available.
Matching Apple Music music videos.
Stable Apple Music music video identifier.
min 1 chars
Music video title.
min 1 chars
Primary artist display name when available.
Canonical public Apple Music music video URL when available.
Best available square artwork image URL when available.
Whether the music video is marked explicit when available.
Matching Apple Music radio episodes.
Stable Apple Music radio episode identifier.
min 1 chars
Radio episode title.
min 1 chars
Primary artist display name when available.
Canonical public Apple Music radio episode URL when available.
Best available square artwork image URL when available.
Whether the radio episode is marked explicit when available.
Count of result rows returned in this response across all sections.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/apple-music/search?query=taylor swift" \
-H "x-api-key: YOUR_API_KEY"Responses
Search results for the requested query.