> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Artist > Returns an Apple Music artist by id or link: name, genres, Apple's biography, artwork and logo, the artist station, the featured or latest release, Top Songs (album, year, length), essential albums with Apple's notes, albums, singles & EPs, live albums, compilations, "appears on", music videos, artist playlists, radio shows, editorial picks, similar artists and upcoming concerts (venue, date and time zone) — every shelf of the artist page (up to ~12 items each). Only publicly available data is returned. > [!NOTE] > > **Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free. > [accordion] Copy for AI assistant > > Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button). > > ```text Prompt > I want to make an API call to /v1/apple-music/artist. Here are the details: > > Endpoint: GET https://api.scraperize.com/v1/apple-music/artist > Description: Returns an Apple Music artist by id or link: name, genres, Apple's biography, artwork and logo, the artist station, the featured or latest release, Top Songs (album, year, length), essential albums with Apple's notes, albums, singles & EPs, live albums, compilations, "appears on", music videos, artist playlists, radio shows, editorial picks, similar artists and upcoming concerts (venue, date and time zone) — every shelf of the artist page (up to ~12 items each). Only publicly available data is returned. > > Required Headers: > - x-api-key: Your API key > > Parameters: > - id (string): The artist's Apple Music id (digits). Required unless `url` is given. Looked up in the US storefront. > - url (string): The artist's music.apple.com link. Required unless `id` is given. The link's storefront (country) is used. > - cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. > > Example Response: > { > "data": { > "id": "159260351", > "name": "Taylor Swift", > "url": "https://music.apple.com/us/artist/taylor-swift/159260351", > "genres": [ > "Pop" > ], > "bio": "The country world feigned surprise when, after three albums of Music Row-indebted songcraft, Taylor Swift formally embraced pop on 2012’s Red. But no one should…", > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a70…", > "logoUrl": "https://is1-ssl.mzstatic.com/image/thumb/lPXHgVOK2LRp_AkQZj_K8A/4826x1264bb.jpg", > "keyColor": "afb8be", > "stationUrl": "https://music.apple.com/us/station/taylor-swift/ra.a-159260351", > "featured": { > "heading": "Featured Album", > "kind": "album", > "id": "6814997249", > "name": "The Life of a Showgirl: The Encore", > "url": "https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249", > "releaseDate": "2026-09-24", > "subtitle": "16 songs", > "isExplicit": true, > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg" > }, > "topSongs": [ > { > "id": "6814997425", > "name": "Patient Zero", > "url": "https://music.apple.com/us/album/patient-zero/6814997249?i=6814997425", > "albumId": "6814997249", > "albumName": "The Life of a Showgirl: The Encore", > "releaseYear": 2026, > "artists": [], > "artistName": null, > "durationMs": 225868, > "trackNumber": null, > "discNumber": null, > "composer": null, > "previewUrl": null, > "isExplicit": false, > "isPopular": null, > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg" > } > ], > "essentialAlbums": [ > { > "kind": "album", > "id": "1528112358", > "name": "folklore (deluxe version)", > "headline": null, > "subtitle": "Taylor has one more folklore surprise: a bonus track, “the lakes.”", > "url": "https://music.apple.com/us/album/folklore-deluxe-version/1528112358", > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/b5/80/dc/b580dca0-349d-036b-e09b-bd849f6affd8/20UMGIM64216.rgb.jpg/3000x3000bb.jpg", > "isExplicit": true > } > ], > "albums": [ > { > "kind": "album", > "id": "6814997249", > "name": "The Life of a Showgirl: The Encore", > "headline": null, > "subtitle": "2026", > "url": "https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249", > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg", > "isExplicit": true > } > ], > "singles": [ > { > "kind": "album", > "id": "6821937445", > "name": "Patient Zero - Single", > "headline": null, > "subtitle": "2026", > "url": "https://music.apple.com/us/album/patient-zero-single/6821937445", > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/89/98/98/8998984f-9a80-c3e1-d59d-e6a6db859e0c/26UM1IM31403.rgb.jpg/3000x3000bb.jpg", > "isExplicit": false > } > ], > "liveAlbums": [ > { > "kind": "album", > "id": "1440932770", > "name": "Speak Now - World Tour Live", > "headline": null, > "subtitle": "2011", > "url": "https://music.apple.com/us/album/speak-now-world-tour-live/1440932770", > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music128/v4/9b/0c/f1/9b0cf19d-a19e-1d54-0775-9d90a63b3419/00843930006021.rgb.jpg/900x900bb.jpg", > "isExplicit": false > } > ], > "compilations": [ > { > "kind": "album", > "id": "1444778002", > "name": "reputation Stadium Tour Surprise Song Playlist", > "headline": null, > "subtitle": "2017", > "url": "https://music.apple.com/us/album/reputation-stadium-tour-surprise-song-playlist/1444778002", > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/34/2a/32/342a32e5-d708-a7e6-7cbf-fe4cf629a989/18OPBMR00186.rgb.jpg/3000x3000bb.jpg", > "isExplicit": false > } > ], > "appearsOn": [ > { > "kind": "album", > "id": "1608894948", > "name": "The Joker And The Queen (feat. Taylor Swift) - Single", > "headline": null, > "subtitle": "Ed Sheeran", > "url": "https://music.apple.com/us/album/the-joker-and-the-queen-feat-taylor-swift-single/1608894948", > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music116/v4/7b/36/ec/7b36ec5a-d752-167b-849f-2e6f8bdf90d5/190296267987.jpg/4000x4000bb.jpg", > "isExplicit": false > } > ], > "musicVideos": [ > { > "kind": "music-video", > "id": "6816241368", > "name": "Patient Zero", > "headline": null, > "subtitle": "2026", > "url": "https://music.apple.com/us/music-video/patient-zero/6816241368", > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Video221/v4/02/21/39/022139aa-083d-21c1-f0b9-cb7dc630dc98/26UM1IM22083.crop.jpg/3701x1912bb.jpg", > "isExplicit": false > } > ], > "playlists": [ > { > "kind": "playlist", > "id": "pl.3950454ced8c45a3b0cc693c2a7db97b", > "name": "Taylor Swift Essentials", > "headline": null, > "subtitle": "Apple Music Pop", > "url": "https://music.apple.com/us/playlist/taylor-swift-essentials/pl.3950454ced8c45a3b0cc693c2a7db97b", > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a70…", > "isExplicit": false > } > ], > "radioShows": [], > "moreToHear": [ > { > "kind": "station", > "id": "ra.6825008805", > "name": "20 Years of Taylor Swift", > "headline": "The Kelleigh Bannen Show", > "subtitle": "Celebrating the anniversary of her self-titled debut.", > "url": "https://music.apple.com/us/station/20-years-of-taylor-swift/ra.6825008805", > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features/v4/0e/3f/1a/0e3f1a42-fff2-c52f-35c8-0548f795db4c/53ad27e4-020a-4f53-b550-bc5b06f0ed0e.png/1080x1080SC.DN02.jpg…", > "isExplicit": false > } > ], > "moreToSee": [ > { > "kind": "artist-uploaded-video", > "id": "1844751770", > "name": "Taylor Swift on The Life of a Showgirl", > "headline": null, > "subtitle": "11:22", > "url": "https://music.apple.com/us/post/1844751770", > "artworkUrl": "https://is1-ssl.mzstatic.com/image/thumb/FuseSocial211/v4/15/6d/81/156d814f-fe9e-10ad-554e-a8d9a3f69687/TN.jpg/1920x1080bb.jpg", > "isExplicit": false > } > ], > "similarArtists": [ > { > "kind": "artist", > "id": "602767352", > "name": "Lorde", > "headline": null, > "subtitle": null, > "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-…", > "isExplicit": false > } > ], > "concerts": [], > "otherSections": [], > "fetchedAt": "2026-11-10T16:02:24.808Z" > }, > "meta": { > "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f", > "creditsCharged": 1, > "creditsRemaining": 4999, > "cached": false > } > } > > Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices. > ``` ## OpenAPI ````yaml /api-reference/openapi.json get /v1/apple-music/artist openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: LinkedIn description: LinkedIn scraping endpoints - name: Twitch description: Twitch scraping endpoints - name: TikTok description: TikTok (tiktok.com) scraping endpoints - name: Instagram description: Instagram scraping endpoints - name: Lagos Life description: Lagos Life scraping endpoints - name: Bluesky description: Bluesky (bsky.app) scraping endpoints - name: Threads description: Threads (threads.com) scraping endpoints - name: Reddit description: Reddit (reddit.com) scraping endpoints - name: Rumble description: Rumble (rumble.com) scraping endpoints - name: SoundCloud description: SoundCloud (soundcloud.com) scraping endpoints - name: Kwai description: Kwai (kwai.com) scraping endpoints - name: Apple Music description: Apple Music (music.apple.com) scraping endpoints - name: Truth Social description: Truth Social (truthsocial.com) scraping endpoints - name: YouTube description: YouTube (youtube.com) scraping endpoints paths: /v1/apple-music/artist: get: tags: - Apple Music summary: Artist description: >- Returns an Apple Music artist by id or link: name, genres, Apple's biography, artwork and logo, the artist station, the featured or latest release, Top Songs (album, year, length), essential albums with Apple's notes, albums, singles & EPs, live albums, compilations, "appears on", music videos, artist playlists, radio shows, editorial picks, similar artists and upcoming concerts (venue, date and time zone) — every shelf of the artist page (up to ~12 items each). Only publicly available data is returned. parameters: - name: id in: query required: false description: >- The artist's Apple Music id (digits). Required unless `url` is given. Looked up in the US storefront. schema: type: string example: '159260351' - name: url in: query required: false description: >- The artist's music.apple.com link. Required unless `id` is given. The link's storefront (country) is used. schema: type: string example: https://music.apple.com/us/artist/taylor-swift/159260351 - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: The artist. content: application/json: schema: type: object properties: data: type: object meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: id: '159260351' name: Taylor Swift url: https://music.apple.com/us/artist/taylor-swift/159260351 genres: - Pop bio: >- The country world feigned surprise when, after three albums of Music Row-indebted songcraft, Taylor Swift formally embraced pop on 2012’s Red. But no one should have been shocked: Any 14-year-old capable of persuading her parents to move from suburban Pennsylvania to Nashville for her career clearly has ambition to burn. Her early, youthful love songs heralded 2010’s newly self-possessed Speak Now—which showed off her scathing wit—and evolved into knowing, ironclad pop fare that held its own against boisterous Max Martin production on 1989, her fifth album, titled after her birth year. Throughout, her songwriting has blurred the lines between the public and private, burying enough real-life clues to make clear that only Swift can own her narrative, thank you very much, while still retaining a lyrical elegance. Though 2017’s reputation might have been perceived as a gorgeously constructed piece of dramatic theater—its attendant heroes and villains all real-life characters from Swift’s public feuds—all that spectacle proved an attention-grabbing cover for her most romantic album yet. She turned up the romance even more on 2019’s Lover, but it was 2020’s folklore and its companion, evermore—ruminative, relatively lo-fi albums written and recorded during the COVID-19 pandemic—that earned her the Apple Music Award for Songwriter of the Year. 2022’s Midnights came next, which she wrote and produced with Jack Antonoff, and described as “the stories of 13 sleepless nights scattered throughout my life.” In 2023, Swift undertook one of the most ambitious road shows of all time: the multiyear Eras Tour, which saw her presenting new and classic material across more than 100 locales worldwide: just one of many reasons she was named Apple Music's Artist of the Year for 2023. She returned to the soft, comfortable, bed-like sonics of Midnights for her 11th album, 2024’s THE TORTURED POETS DEPARTMENT. A study in extremes and heightened emotions, it was her most specific, candid, unsparing work to date—and it was followed by another whiplash turn when she reunited with Max Martin the following year for The Life of a Showgirl. “Making this was really something I’ve been wanting to do for my entire career, because I have always wanted to have fun in this type of way,” she said to Apple Music’s Zane Lowe. “To have fun, to exhibit mischief, and be flirty and fun and make jokes—that’s a huge part of my personality.” artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1640x1640bb.jpg logoUrl: >- https://is1-ssl.mzstatic.com/image/thumb/lPXHgVOK2LRp_AkQZj_K8A/4826x1264bb.jpg keyColor: afb8be stationUrl: >- https://music.apple.com/us/station/taylor-swift/ra.a-159260351 featured: heading: Featured Album kind: album id: '6814997249' name: 'The Life of a Showgirl: The Encore' url: >- https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249 releaseDate: '2026-09-24' subtitle: 16 songs isExplicit: true artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg topSongs: - id: '6814997425' name: Patient Zero url: >- https://music.apple.com/us/album/patient-zero/6814997249?i=6814997425 albumId: '6814997249' albumName: 'The Life of a Showgirl: The Encore' releaseYear: 2026 artists: [] artistName: null durationMs: 225868 trackNumber: null discNumber: null composer: null previewUrl: null isExplicit: false isPopular: null artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg - id: '6775527443' name: I Knew It, I Knew You (From "Toy Story 5") url: >- https://music.apple.com/us/album/i-knew-it-i-knew-you-from-toy-story-5/6775527442?i=6775527443 albumId: '6775527442' albumName: I Knew It, I Knew You (From "Toy Story 5") - Single releaseYear: 2026 artists: [] artistName: null durationMs: 178186 trackNumber: null discNumber: null composer: null previewUrl: null isExplicit: false isPopular: null artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/34/35/6c/34356cb4-bd0b-3bac-b118-1a6d7264dc64/26UMGIM69942.rgb.jpg/3000x3000bb.jpg - id: '1833328840' name: The Fate of Ophelia url: >- https://music.apple.com/us/album/the-fate-of-ophelia/1833328839?i=1833328840 albumId: '1833328839' albumName: The Life of a Showgirl releaseYear: 2025 artists: [] artistName: null durationMs: 226074 trackNumber: null discNumber: null composer: null previewUrl: null isExplicit: false isPopular: null artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/2d/46/e0/2d46e0bc-8ab9-85dd-4b56-ee6951351034/25UM1IM19577.rgb.jpg/3000x3000bb.jpg essentialAlbums: - kind: album id: '1528112358' name: folklore (deluxe version) headline: null subtitle: >- Taylor has one more folklore surprise: a bonus track, “the lakes.” url: >- https://music.apple.com/us/album/folklore-deluxe-version/1528112358 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/b5/80/dc/b580dca0-349d-036b-e09b-bd849f6affd8/20UMGIM64216.rgb.jpg/3000x3000bb.jpg isExplicit: true - kind: album id: '1440935467' name: '1989' headline: null subtitle: >- Leaving country behind for pop, Taylor uses nostalgia to move forward. url: https://music.apple.com/us/album/1989/1440935467 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/89/4a/4a/894a4ab9-b0b0-9ea5-ca41-8da0b9b79453/14UMDIM03405.rgb.jpg/1400x1400bb.jpg isExplicit: false - kind: album id: '1440935340' name: Red headline: null subtitle: >- When Taylor Swift introduced herself as a commanding pop supernova. url: https://music.apple.com/us/album/red/1440935340 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/25/0d/7e/250d7e42-3a2f-19ac-f865-f1e04a4a1f97/12UMDIM01007.rgb.jpg/2118x2118bb.jpg isExplicit: false albums: - kind: album id: '6814997249' name: 'The Life of a Showgirl: The Encore' headline: null subtitle: '2026' url: >- https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/3000x3000bb.jpg isExplicit: true - kind: album id: '1875381397' name: >- Opalite (Official Music Video Extended Versions) - Single headline: null subtitle: '2026' url: >- https://music.apple.com/us/album/opalite-official-music-video-extended-versions-single/1875381397 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/47/8a/b8/478ab8ac-d134-bad3-f700-364c83323bc6/26UMGIM11621.rgb.jpg/3000x3000bb.jpg isExplicit: false - kind: album id: '1850496031' name: The Life of a Showgirl + Acoustic Collection headline: null subtitle: '2025' url: >- https://music.apple.com/us/album/the-life-of-a-showgirl-acoustic-collection/1850496031 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/0e/e5/c7/0ee5c717-114f-f4e8-9f7c-e92dd6eb9152/25UM1IM74420.rgb.jpg/3000x3000bb.jpg isExplicit: true singles: - kind: album id: '6821937445' name: Patient Zero - Single headline: null subtitle: '2026' url: >- https://music.apple.com/us/album/patient-zero-single/6821937445 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/89/98/98/8998984f-9a80-c3e1-d59d-e6a6db859e0c/26UM1IM31403.rgb.jpg/3000x3000bb.jpg isExplicit: false - kind: album id: '6778230429' name: I Knew It, I Knew You (From "Toy Story 5") - Single headline: null subtitle: '2026' url: >- https://music.apple.com/us/album/i-knew-it-i-knew-you-from-toy-story-5-single/6778230429 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/ae/c1/15/aec11538-c395-b88e-b0f9-7b5b07b8e676/ticket.zkazzkhn.jpg/3000x3000bb.jpg isExplicit: false - kind: album id: '1888604488' name: Elizabeth Taylor headline: null subtitle: '2026' url: >- https://music.apple.com/us/album/elizabeth-taylor/1888604488 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/2b/14/dc/2b14dc4d-5173-7b38-b0ff-1c30daf5fa32/26UMGIM37308.rgb.jpg/3000x3000bb.jpg isExplicit: false liveAlbums: - kind: album id: '1440932770' name: Speak Now - World Tour Live headline: null subtitle: '2011' url: >- https://music.apple.com/us/album/speak-now-world-tour-live/1440932770 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music128/v4/9b/0c/f1/9b0cf19d-a19e-1d54-0775-9d90a63b3419/00843930006021.rgb.jpg/900x900bb.jpg isExplicit: false - kind: album id: '1508579276' name: Live From Clear Channel Stripped 2008 headline: null subtitle: '2008' url: >- https://music.apple.com/us/album/live-from-clear-channel-stripped-2008/1508579276 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music123/v4/26/e4/1c/26e41ced-ab49-e981-b738-c1b5c056e759/20OPBMR01217.rgb.jpg/3000x3000bb.jpg isExplicit: false - kind: album id: '1440929037' name: iTunes Live from SoHo headline: null subtitle: '2007' url: >- https://music.apple.com/us/album/itunes-live-from-soho/1440929037 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music114/v4/e1/ef/01/e1ef0155-6e87-f7c8-716b-d1d2114dcd5a/00843930000661.rgb.jpg/1400x1400bb.jpg isExplicit: false compilations: - kind: album id: '1444778002' name: reputation Stadium Tour Surprise Song Playlist headline: null subtitle: '2017' url: >- https://music.apple.com/us/album/reputation-stadium-tour-surprise-song-playlist/1444778002 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/34/2a/32/342a32e5-d708-a7e6-7cbf-fe4cf629a989/18OPBMR00186.rgb.jpg/3000x3000bb.jpg isExplicit: false appearsOn: - kind: album id: '1608894948' name: The Joker And The Queen (feat. Taylor Swift) - Single headline: null subtitle: Ed Sheeran url: >- https://music.apple.com/us/album/the-joker-and-the-queen-feat-taylor-swift-single/1608894948 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Music116/v4/7b/36/ec/7b36ec5a-d752-167b-849f-2e6f8bdf90d5/190296267987.jpg/4000x4000bb.jpg isExplicit: false musicVideos: - kind: music-video id: '6816241368' name: Patient Zero headline: null subtitle: '2026' url: >- https://music.apple.com/us/music-video/patient-zero/6816241368 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Video221/v4/02/21/39/022139aa-083d-21c1-f0b9-cb7dc630dc98/26UM1IM22083.crop.jpg/3701x1912bb.jpg isExplicit: false - kind: music-video id: '6818017941' name: Patient Zero headline: null subtitle: '2026' url: >- https://music.apple.com/us/music-video/patient-zero/6818017941 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Video211/v4/19/2e/ca/192ecabc-b8d2-a613-06af-d608c1037642/26UM1IM22083.crop.jpg/3701x1912bb.jpg isExplicit: false - kind: music-video id: '6818017943' name: Patient Zero (Expanded Video) headline: null subtitle: '2026' url: >- https://music.apple.com/us/music-video/patient-zero-expanded-video/6818017943 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Video211/v4/e1/ef/ce/e1efced7-7023-bcaf-d157-0492240aa10c/26UM1IM28169.crop.jpg/1912x1072bb.jpg isExplicit: false playlists: - kind: playlist id: pl.3950454ced8c45a3b0cc693c2a7db97b name: Taylor Swift Essentials headline: null subtitle: Apple Music Pop url: >- https://music.apple.com/us/playlist/taylor-swift-essentials/pl.3950454ced8c45a3b0cc693c2a7db97b artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1080x1080SC.FPESS05.jpg?l=en-US isExplicit: false - kind: playlist id: pl.6929cc16ba9e48878fcabb6af6412d0a name: Taylor Swift Video Essentials headline: null subtitle: Apple Music Pop url: >- https://music.apple.com/us/playlist/taylor-swift-video-essentials/pl.6929cc16ba9e48878fcabb6af6412d0a artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1080x1080SC.MVESS05.jpg?l=en-US isExplicit: false - kind: playlist id: pl.57891bdd1bc840948374f1c4cbe9c840 name: Taylor Swift’s Eras Tour Set List headline: null subtitle: Apple Music Pop url: >- https://music.apple.com/us/playlist/taylor-swifts-eras-tour-set-list/pl.57891bdd1bc840948374f1c4cbe9c840 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/6d/67/88/6d67888b-9e7f-53af-7853-0f91d6fd2332/ami_U003aidentity_U003a994af5c375f4c3aa96cd6ced4a700799-2026-09-25T04-00-05.358Z_cropped.png/1080x1080SC.FPSL03.jpg?l=en-US isExplicit: false radioShows: [] moreToHear: - kind: station id: ra.6825008805 name: 20 Years of Taylor Swift headline: The Kelleigh Bannen Show subtitle: Celebrating the anniversary of her self-titled debut. url: >- https://music.apple.com/us/station/20-years-of-taylor-swift/ra.6825008805 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Features/v4/0e/3f/1a/0e3f1a42-fff2-c52f-35c8-0548f795db4c/53ad27e4-020a-4f53-b550-bc5b06f0ed0e.png/1080x1080SC.DN02.jpg?l=en-US isExplicit: false - kind: station id: ra.1760030000 name: Celebrating Five Years of Taylor’s Lover headline: Apple Music Today subtitle: A Taylor Swift song that wasn’t an instant hit? url: >- https://music.apple.com/us/station/celebrating-five-years-of-taylors-lover/ra.1760030000 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Features211/v4/72/57/48/725748a2-9472-d574-c53c-0e0121523ebc/eefdf6a5-10ca-490c-80b5-110bd0c6752a.png/4320x1080bb.jpg isExplicit: false - kind: station id: ra.1760026191 name: “Shake It Off” Came Out 10 Years Ago Today headline: Apple Music Today subtitle: The song that announced her pop takeover. url: >- https://music.apple.com/us/station/shake-it-off-came-out-10-years-ago-today/ra.1760026191 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/Features221/v4/fa/ba/dc/fabadc0b-5343-fc3c-8431-b92e4c310cba/59543639-49b1-4cde-9edd-cc259acfbd4e.png/4320x1080bb.jpg isExplicit: false moreToSee: - kind: artist-uploaded-video id: '1844751770' name: Taylor Swift on The Life of a Showgirl headline: null subtitle: '11:22' url: https://music.apple.com/us/post/1844751770 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/FuseSocial211/v4/15/6d/81/156d814f-fe9e-10ad-554e-a8d9a3f69687/TN.jpg/1920x1080bb.jpg isExplicit: false - kind: artist-uploaded-video id: '1833367369' name: Taylor Swift announces Life of a Showgirl headline: null subtitle: '1:02' url: https://music.apple.com/us/post/1833367369 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/FuseSocial221/v4/a8/e9/f2/a8e9f27e-6d7b-bd0c-066e-df8ddd041dad/Album_reveal_and_initial_discussion_TEASER_VID.00_00_51_00.Still001.png/1920x1080bb.jpg isExplicit: false - kind: artist-uploaded-video id: '1833342370' name: Taylor Swift on Max Martin and Shellback headline: null subtitle: '1:27' url: https://music.apple.com/us/post/1833342370 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/FuseSocial211/v4/0d/12/4c/0d124c4f-7853-1eee-b0a1-a543963ef421/Working_with_Max_and_Shellback_TEASER_VID.00_01_07_06.Still001.png/1920x1080bb.jpg isExplicit: false similarArtists: - kind: artist id: '602767352' name: Lorde headline: null subtitle: null 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/2155x2155bb.jpg isExplicit: false - kind: artist id: '412778295' name: Ariana Grande headline: null subtitle: null url: >- https://music.apple.com/us/artist/ariana-grande/412778295 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/06/f0/41/06f0418f-97d3-34f8-f0a3-3acc37964d89/ami-identity-b7ce039aac2c803c4620ff4ff18920ca-2026-08-06T15-12-54.044Z_cropped.png/3750x3750bb.jpg isExplicit: false - kind: artist id: '280215834' name: Selena Gomez headline: null subtitle: null url: https://music.apple.com/us/artist/selena-gomez/280215834 artworkUrl: >- https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/47/79/63/47796327-5841-8691-ac9a-9e56e8e9d782/ami-identity-9dc79b57efd6f0e1ede00c6af8f8954c-2025-02-14T03-00-28.587Z_cropped.png/820x820bb.jpg isExplicit: false concerts: [] otherSections: [] fetchedAt: '2026-11-10T16:02:24.808Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: >- No artist with that id in that storefront (it may not exist or not be available there). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters (`id` or `url` is required). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: url is required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '503': description: >- Temporarily unavailable — retry after `Retry-After`. `error.code` tells you why: `UPSTREAM_BLOCKED` (the source blocked this request), `EXTRACTION_FAILED` (the source returned unexpected data), `PLATFORM_UNAVAILABLE` (the source is down), or `SERVICE_UNAVAILABLE` (we are at capacity). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source is temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.