The Apple Music API from Social Fetch — 4 operation(s) for apple music.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/social-fetch-apple-music-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Social Fetch Public Apple Music API
version: 1.0.0
description: 'REST API for Social Fetch. Versioned routes under `/v1` accept `x-api-key` credits or x402 USDC on Base (walk-up, no key). OpenAPI: https://api.socialfetch.dev/openapi.json. x402 discovery: https://api.socialfetch.dev/.well-known/x402. MCP: https://api.socialfetch.dev/mcp (POST). Docs and agent guide: https://www.socialfetch.dev/docs and https://www.socialfetch.dev/llms.txt.'
servers:
- url: https://api.socialfetch.dev
description: API origin
tags:
- name: Apple Music
paths:
/v1/apple-music/search:
get:
tags:
- Apple Music
summary: Search Apple Music
description: Search the Apple Music catalog by keyword.
security:
- ApiKeyAuth: []
- {}
x-socialfetch-pricing:
version: 1
baseCredits: 1
surcharges: []
maxCredits: 1
normalizationFailureCredits: 1
x-socialfetch-credits-pricing: 1 credit per successful request.
parameters:
- schema:
type: string
minLength: 1
maxLength: 512
description: Search query text for Apple Music catalog results.
required: true
description: Search query text for Apple Music catalog results.
name: query
in: query
- schema:
type: string
enum:
- all
- song
- album
- artist
- playlist
- station
- music_video
- radio_episode
description: Catalog result type to return. Omit to search across types (treated as all).
required: false
description: Catalog result type to return. Omit to search across types (treated as all).
name: type
in: query
responses:
'200':
description: Search results for the requested query.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
query:
type: string
minLength: 1
description: Search query string evaluated for this response.
type:
type: string
enum:
- all
- song
- album
- artist
- playlist
- station
- music_video
- radio_episode
description: Result type applied for this response.
artists:
type: array
items:
type: object
properties:
artistId:
type: string
minLength: 1
description: Stable Apple Music artist identifier.
displayName:
type: string
minLength: 1
description: Artist display name.
url:
type:
- string
- 'null'
description: Canonical public Apple Music artist URL when available.
artworkUrl:
type:
- string
- 'null'
description: Best available square artwork image URL when available.
required:
- artistId
- displayName
- url
- artworkUrl
description: An artist in Apple Music search results.
description: Matching Apple Music artists.
albums:
type: array
items:
type: object
properties:
albumId:
type: string
minLength: 1
description: Stable Apple Music album identifier.
title:
type: string
minLength: 1
description: Album title.
artistName:
type:
- string
- 'null'
description: Primary artist display name when available.
url:
type:
- string
- 'null'
description: Canonical public Apple Music album URL when available.
trackCount:
type:
- integer
- 'null'
minimum: 0
description: Number of tracks on the album when available.
artworkUrl:
type:
- string
- 'null'
description: Best available square artwork image URL when available.
explicit:
type:
- boolean
- 'null'
description: Whether the album is marked explicit when available.
required:
- albumId
- title
- artistName
- url
- trackCount
- artworkUrl
- explicit
description: An album in Apple Music search results.
description: Matching Apple Music albums.
songs:
type: array
items:
type: object
properties:
trackId:
type: string
minLength: 1
description: Stable Apple Music song identifier.
title:
type: string
minLength: 1
description: Song title.
artistName:
type:
- string
- 'null'
description: Primary artist display name when available.
url:
type:
- string
- 'null'
description: Canonical public Apple Music song URL when available.
durationMs:
type:
- integer
- 'null'
minimum: 0
description: Track duration in milliseconds when available.
artworkUrl:
type:
- string
- 'null'
description: Best available square artwork image URL when available.
explicit:
type:
- boolean
- 'null'
description: Whether the track is marked explicit when available.
previewUrl:
type:
- string
- 'null'
description: Short audio preview URL when available.
required:
- trackId
- title
- artistName
- url
- durationMs
- artworkUrl
- explicit
- previewUrl
description: A song in Apple Music search results.
description: Matching Apple Music songs.
playlists:
type: array
items:
type: object
properties:
playlistId:
type: string
minLength: 1
description: Stable Apple Music playlist identifier.
title:
type: string
minLength: 1
description: Playlist title.
url:
type:
- string
- 'null'
description: Canonical public Apple Music playlist URL when available.
artworkUrl:
type:
- string
- 'null'
description: Best available square artwork image URL when available.
required:
- playlistId
- title
- url
- artworkUrl
description: A playlist in Apple Music search results.
description: Matching Apple Music playlists.
stations:
type: array
items:
type: object
properties:
stationId:
type: string
minLength: 1
description: Stable Apple Music station identifier.
title:
type: string
minLength: 1
description: Station title.
url:
type:
- string
- 'null'
description: Canonical public Apple Music station URL when available.
artworkUrl:
type:
- string
- 'null'
description: Best available square artwork image URL when available.
required:
- stationId
- title
- url
- artworkUrl
description: A station in Apple Music search results.
description: Matching Apple Music stations.
musicVideos:
type: array
items:
type: object
properties:
musicVideoId:
type: string
minLength: 1
description: Stable Apple Music music video identifier.
title:
type: string
minLength: 1
description: Music video title.
artistName:
type:
- string
- 'null'
description: Primary artist display name when available.
url:
type:
- string
- 'null'
description: Canonical public Apple Music music video URL when available.
artworkUrl:
type:
- string
- 'null'
description: Best available square artwork image URL when available.
explicit:
type:
- boolean
- 'null'
description: Whether the music video is marked explicit when available.
required:
- musicVideoId
- title
- artistName
- url
- artworkUrl
- explicit
description: A music video in Apple Music search results.
description: Matching Apple Music music videos.
radioEpisodes:
type: array
items:
type: object
properties:
radioEpisodeId:
type: string
minLength: 1
description: Stable Apple Music radio episode identifier.
title:
type: string
minLength: 1
description: Radio episode title.
artistName:
type:
- string
- 'null'
description: Primary artist display name when available.
url:
type:
- string
- 'null'
description: Canonical public Apple Music radio episode URL when available.
artworkUrl:
type:
- string
- 'null'
description: Best available square artwork image URL when available.
explicit:
type:
- boolean
- 'null'
description: Whether the radio episode is marked explicit when available.
required:
- radioEpisodeId
- title
- artistName
- url
- artworkUrl
- explicit
description: A radio episode in Apple Music search results.
description: Matching Apple Music radio episodes.
totalResults:
type: integer
minimum: 0
description: Count of result rows returned in this response across all sections.
required:
- query
- type
- artists
- albums
- songs
- playlists
- stations
- musicVideos
- radioEpisodes
- totalResults
description: Endpoint-specific response payload.
meta:
type: object
properties:
requestId:
type: string
minLength: 1
description: Unique request identifier for tracing this API call.
creditsCharged:
type: integer
minimum: 0
description: Credits charged for this request.
version:
type: string
enum:
- v1
description: Public API version that served the response.
cached:
type: boolean
description: True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
required:
- requestId
- creditsCharged
- version
description: Metadata describing the request and billing outcome.
required:
- data
- meta
description: Standard success response envelope.
examples:
results:
value:
data:
query: taylor swift
type: song
artists: []
albums: []
songs:
- trackId: '1590368457'
title: 22 (Taylor's Version)
artistName: Taylor Swift
url: https://music.apple.com/us/album/22-taylors-version/1590368448?i=1590368457
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368886'
title: Message In A Bottle (Taylor's Version) [From The Vault]
artistName: Taylor Swift
url: https://music.apple.com/us/album/message-in-a-bottle-taylors-version-from-the-vault/1590368448?i=1590368886
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368453'
title: Red (Taylor's Version)
artistName: Taylor Swift
url: https://music.apple.com/us/album/red-taylors-version/1590368448?i=1590368453
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368461'
title: We Are Never Ever Getting Back Together (Taylor's Version)
artistName: Taylor Swift
url: https://music.apple.com/us/album/we-are-never-ever-getting-back-together-taylors-version/1590368448?i=1590368461
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368455'
title: I Knew You Were Trouble (Taylor's Version)
artistName: Taylor Swift
url: https://music.apple.com/us/album/i-knew-you-were-trouble-taylors-version/1590368448?i=1590368455
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368893'
title: The Very First Night (Taylor's Version) [From The Vault]
artistName: Taylor Swift
url: https://music.apple.com/us/album/the-very-first-night-taylors-version-from-the-vault/1590368448?i=1590368893
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368754'
title: Better Man (Taylor's Version) [From The Vault]
artistName: Taylor Swift
url: https://music.apple.com/us/album/better-man-taylors-version-from-the-vault/1590368448?i=1590368754
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1541905893'
title: cardigan
artistName: Taylor Swift
url: https://music.apple.com/us/album/cardigan/1541905871?i=1541905893
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music114/v4/dd/6a/2f/dd6a2fec-2476-b44a-f2cc-8a2736143d8c/20UM1IM08851.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368762'
title: Nothing New (Taylor's Version) [From The Vault] [feat. Phoebe Bridgers]
artistName: Taylor Swift
url: https://music.apple.com/us/album/nothing-new-taylors-version-from-the-vault-feat/1590368448?i=1590368762
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368456'
title: All Too Well (Taylor's Version)
artistName: Taylor Swift
url: https://music.apple.com/us/album/all-too-well-taylors-version/1590368448?i=1590368456
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368894'
title: All Too Well (10 Minute Version) [Taylor's Version] [From The Vault]
artistName: Taylor Swift
url: https://music.apple.com/us/album/all-too-well-10-minute-version-taylors-version-from/1590368448?i=1590368894
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: true
previewUrl: null
- trackId: '1742058094'
title: Florida!!! (feat. Florence + the Machine)
artistName: Taylor Swift
url: https://music.apple.com/us/album/florida-feat-florence-the-machine/1742057774?i=1742058094
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a4/86/59/a486593a-53c9-1c2a-5122-8f25339f7359/24UMGIM44778.rgb.jpg/1200x1200bb.jpg
explicit: true
previewUrl: null
- trackId: '1590368889'
title: I Bet You Think About Me (Taylor's Version) [From The Vault] [feat. Chris Stapleton]
artistName: Taylor Swift
url: https://music.apple.com/us/album/i-bet-you-think-about-me-taylors-version-from-the/1590368448?i=1590368889
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: true
previewUrl: null
- trackId: '1590368892'
title: Run (Taylor's Version) [From The Vault] [feat. Ed Sheeran]
artistName: Taylor Swift
url: https://music.apple.com/us/album/run-taylors-version-from-the-vault-feat-ed-sheeran/1590368448?i=1590368892
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1541904691'
title: the 1
artistName: Taylor Swift
url: https://music.apple.com/us/album/the-1/1541904688?i=1541904691
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music114/v4/0f/a0/14/0fa0144d-6cd5-792a-1589-3e1f0c25db49/20UM1IM08851.rgb.jpg/1200x1200bb.jpg
explicit: true
previewUrl: null
- trackId: '1590368465'
title: Sad Beautiful Tragic (Taylor's Version)
artistName: Taylor Swift
url: https://music.apple.com/us/album/sad-beautiful-tragic-taylors-version/1590368448?i=1590368465
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368740'
title: Everything Has Changed (Taylor's Version) [feat. Ed Sheeran]
artistName: Taylor Swift
url: https://music.apple.com/us/album/everything-has-changed-taylors-version-feat-ed-sheeran/1590368448?i=1590368740
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368450'
title: State Of Grace (Taylor's Version)
artistName: Taylor Swift
url: https://music.apple.com/us/album/state-of-grace-taylors-version/1590368448?i=1590368450
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368747'
title: Come Back...Be Here (Taylor's Version)
artistName: Taylor Swift
url: https://music.apple.com/us/album/come-back-be-here-taylors-version/1590368448?i=1590368747
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
- trackId: '1590368463'
title: The Last Time (Taylor's Version) [feat. Gary Lightbody]
artistName: Taylor Swift
url: https://music.apple.com/us/album/the-last-time-taylors-version-feat-gary-lightbody/1590368448?i=1590368463
durationMs: null
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/15/38/9b/15389bf4-8074-06c3-11ee-655b5453af68/21UM1IM25046.rgb.jpg/1200x1200bb.jpg
explicit: false
previewUrl: null
playlists: []
stations: []
musicVideos: []
radioEpisodes: []
totalResults: 20
meta:
requestId: req_9957d122-2591-4b59-8dd7-d8d36cdfdae0
creditsCharged: 1
version: v1
mixed:
value:
data:
query: taylor swift
type: all
artists:
- artistId: '159260351'
displayName: Taylor Swift
url: https://music.apple.com/us/artist/taylor-swift/159260351
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/70/30/3b/70303b1c-4744-57b7-27be-5cb94a8fc3cb/ami-identity-994af5c375f4c3aa96cd6ced4a700799-2025-09-26T18-27-12.403Z_cropped.png/1200x1200bb.jpg
- artistId: '690319057'
displayName: Dan + Shay
url: https://music.apple.com/us/artist/dan-shay/690319057
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/c2/1c/94/c21c9454-68a1-c684-6bbc-6be3d141dbe7/ami-identity-da1de433f8cabc891f22036698c8b6c7-2026-05-14T15-57-58.064Z_cropped.png/1200x1200bb.jpg
- artistId: '281070699'
displayName: Florence + the Machine
url: https://music.apple.com/us/artist/florence-the-machine/281070699
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/e3/34/00/e3340015-2eea-8e3b-de17-22b175f15f6a/ami-identity-5e67cf4707105e30d7f452b1de6f19e5-2025-08-19T10-57-53.200Z_cropped.png/1200x1200bb.jpg
- artistId: '602767352'
displayName: Lorde
url: https://music.apple.com/us/artist/lorde/602767352
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/76/ca/e2/76cae283-f3ba-aa7f-6256-1817e9b5179f/ami-identity-2d92b3a772aa3368c092544fed8cac42-2026-06-26T22-33-16.704Z_cropped.png/1200x1200bb.jpg
- artistId: '3300203'
displayName: Rascal Flatts
url: https://music.apple.com/us/artist/rascal-flatts/3300203
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/a8/54/fd/a854fd24-b67f-e9a4-4221-2ba2748cbf11/ami-identity-7ce6c14a3e8d27acc20e6b0e45b4c63e-2025-01-31T05-12-40.483Z_cropped.png/1200x1200bb.jpg
- artistId: '1084576956'
displayName: Brett Young
url: https://music.apple.com/us/artist/brett-young/1084576956
artworkUrl: https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/b3/7e/44/b37e44a1-c454-907d-8739-c8df57a4ba78/ami-identity-34e14f2e6977df8038259d35a0b97781-2025-04-11T04-36-22.128Z_cropped.png/1200x1200bb.jpg
# --- truncated at 32 KB (177 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/social-fetch/refs/heads/main/openapi/social-fetch-apple-music-api-openapi.yml