Artist

GET/v1/apple-music/artist1 credit

Returns an artist's Apple Music page: name, artwork and biography, top songs, albums, music videos, playlists and every other shelf of the page (singles, live albums, appears on, similar artists, …).

01Query parameters

Name	Type	Description
idoptional	string	The Apple Music artist id, e.g. `159260351` (US storefront). One of `id` or `url` is required; `url` wins when both are given.
urloptional	string	The music.apple.com artist URL, e.g. `https://music.apple.com/us/artist/taylor-swift/159260351`. The storefront in the URL (`us`, `gb`, `tr`, …) is the one read.

02Request

curl "https://api.scrapesocial.ai/v1/apple-music/artist?id=159260351" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/apple-music/artist?id=159260351

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "159260351",
  "kind": "artist",
  "name": "Taylor Swift",
  "url": "https://music.apple.com/us/artist/taylor-swift/159260351",
  "artwork": {
    "url": "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/1200x1200bb.jpg",
    "width": 1640,
    "height": 1640,
    "bgColor": "070706",
    "textColor1": "e2ac8d",
    "textColor2": "cf9e85",
    "textColor3": "b68b72",
    "textColor4": "a7806c"
  },
  "editorial_notes": "The country world feigned surprise when, after three albums of Music Row-indebted songcraft, Taylor Swift formally embraced pop on 2012’s <i>Red</i>. 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.\n\nHer early, youthful love songs heralded 2010’s newly self-possessed <…",
  "top_songs": [
    {
      "id": "6814997425",
      "kind": "song",
      "title": "Patient Zero",
      "subtitle": "The Life of a Showgirl: The Encore · 2026",
      "album": null,
      "url": "https://music.apple.com/us/album/patient-zero/6814997249?i=6814997425",
      "artwork": {
        "url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/1200x1200bb.jpg",
        "width": 3000,
        "height": 3000,
        "bgColor": "2b080c",
        "textColor1": "e2a971",
        "textColor2": "e5693c",
        "textColor3": "bd895d",
        "textColor4": "c05532"
      },
      "duration_ms": 225868,
      "track_number": null,
      "disc_number": null,
      "artist_name": "Taylor Swift",
      "explicit": false,
      "preview_url": null,
      "track_count": null
    },
    {
      "id": "1856301587",
      "kind": "song",
      "title": "The Fate of Ophelia",
      "subtitle": "The Fate of Ophelia (The Chainsmokers Remix) - Single · 2025",
      "album": null,
      "url": "https://music.apple.com/us/album/the-fate-of-ophelia/1856301585?i=1856301587",
      "artwork": {
        "url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a3/f4/e8/a3f4e86d-b574-ae74-7b92-fe582ceefc73/25UM1IM98397.rgb.jpg/1200x1200bb.jpg",
        "width": 3000,
        "height": 3000,
        "bgColor": "ffffff",
        "textColor1": "1f1a15",
        "textColor2": "2b241e",
        "textColor3": "4c4844",
        "textColor4": "55504b"
      },
      "duration_ms": 226074,
      "track_number": null,
      "disc_number": null,
      "artist_name": "Taylor Swift",
      "explicit": false,
      "preview_url": null,
      "track_count": null
    }
  ],
  "albums": [
    {
      "id": "6814997249",
      "kind": "album",
      "title": "The Life of a Showgirl: The Encore",
      "subtitle": "2026",
      "album": null,
      "url": "https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249",
      "artwork": {
        "url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/1200x1200bb.jpg",
        "width": 3000,
        "height": 3000,
        "bgColor": "2b080c",
        "textColor1": "e2a971",
        "textColor2": "e5693c",
        "textColor3": "bd895d",
        "textColor4": "c05532"
      },
      "duration_ms": null,
      "track_number": null,
      "disc_number": null,
      "artist_name": "Taylor Swift",
      "explicit": true,
      "preview_url": null,
      "track_count": null
    },
    {
      "id": "1875381397",
      "kind": "album",
      "title": "Opalite (Official Music Video Extended Versions) - Single",
      "subtitle": "2026",
      "album": null,
      "url": "https://music.apple.com/us/album/opalite-official-music-video-extended-versions-single/1875381397",
      "artwork": {
        "url": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/47/8a/b8/478ab8ac-d134-bad3-f700-364c83323bc6/26UMGIM11621.rgb.jpg/1200x1200bb.jpg",
        "width": 3000,
        "height": 3000,
        "bgColor": "101723",
        "textColor1": "d9cbc9",
        "textColor2": "cec1c4",
        "textColor3": "b1a7a7",
        "textColor4": "a89fa4"
      },
      "duration_ms": null,
      "track_number": null,
      "disc_number": null,
      "artist_name": "Taylor Swift",
      "explicit": false,
      "preview_url": null,
      "track_count": null
    }
  ],
  "music_videos": [
    {
      "id": "6816241368",
      "kind": "musicVideo",
      "title": "Patient Zero",
      "subtitle": "2026",
      "album": null,
      "url": "https://music.apple.com/us/music-video/patient-zero/6816241368",
      "artwork": {
        "url": "https://is1-ssl.mzstatic.com/image/thumb/Video221/v4/02/21/39/022139aa-083d-21c1-f0b9-cb7dc630dc98/26UM1IM22083.crop.jpg/1200x1200bb.jpg",
        "width": 3701,
        "height": 1912,
        "bgColor": "0e1110",
        "textColor1": "cde3e9",
        "textColor2": "b1c4b3",
        "textColor3": "a6b9bd",
        "textColor4": "90a092"
      },
      "duration_ms": null,
      "track_number": null,
      "disc_number": null,
      "artist_name": "Taylor Swift",
      "explicit": false,
      "preview_url": null,
      "track_count": null
    },
    {
      "id": "6818017941",
      "kind": "musicVideo",
      "title": "Patient Zero",
      "subtitle": "2026",
      "album": null,
      "url": "https://music.apple.com/us/music-video/patient-zero/6818017941",
      "artwork": {
        "url": "https://is1-ssl.mzstatic.com/image/thumb/Video211/v4/19/2e/ca/192ecabc-b8d2-a613-06af-d608c1037642/26UM1IM22083.crop.jpg/1200x1200bb.jpg",
        "width": 3701,
        "height": 1912,
        "bgColor": "0e1110",
        "textColor1": "cde3e9",
        "textColor2": "b1c4b3",
        "textColor3": "a6b9bd",
        "textColor4": "90a092"
      },
      "duration_ms": null,
      "track_number": null,
      "disc_number": null,
      "artist_name": "Taylor Swift",
      "explicit": false,
      "preview_url": null,
      "track_count": null
    }
  ],
  "playlists": [
    {
      "id": "pl.3950454ced8c45a3b0cc693c2a7db97b",
      "kind": "playlist",
      "title": "Taylor Swift Essentials",
      "subtitle": "Apple Music Pop",
      "album": null,
      "url": "https://music.apple.com/us/playlist/taylor-swift-essentials/pl.3950454ced8c45a3b0cc693c2a7db97b",
      "artwork": {
        "url": "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/1200x1200SC.FPESS05.jpg?l=en-US",
        "width": 1080,
        "height": 1080,
        "bgColor": "070706",
        "textColor1": "e2ac8d",
        "textColor2": "cf9e85",
        "textColor3": "b68b72",
        "textColor4": "a7806c"
      },
      "duration_ms": null,
      "track_number": null,
      "disc_number": null,
      "artist_name": null,
      "explicit": false,
      "preview_url": null,
      "track_count": null
    },
    {
      "id": "pl.6929cc16ba9e48878fcabb6af6412d0a",
      "kind": "playlist",
      "title": "Taylor Swift Video Essentials",
      "subtitle": "Apple Music Pop",
      "album": null,
      "url": "https://music.apple.com/us/playlist/taylor-swift-video-essentials/pl.6929cc16ba9e48878fcabb6af6412d0a",
      "artwork": {
        "url": "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/1200x1200SC.MVESS05.jpg?l=en-US",
        "width": 1080,
        "height": 1080,
        "bgColor": "070706",
        "textColor1": "e2ac8d",
        "textColor2": "cf9e85",
        "textColor3": "b68b72",
        "textColor4": "a7806c"
      },
      "duration_ms": null,
      "track_number": null,
      "disc_number": null,
      "artist_name": null,
      "explicit": false,
      "preview_url": null,
      "track_count": null
    }
  ],
  "sections": [
    {
      "id": "artists_159260351_default.marker.shelfgroup.FeaturedContent.TopSongs-ArtistFeaturedContentAndTracks",
      "title": "Top Songs",
      "items": [
        {
          "id": "6814997425",
          "kind": "song",
          "title": "Patient Zero",
          "subtitle": "The Life of a Showgirl: The Encore · 2026",
          "album": null,
          "url": "https://music.apple.com/us/album/patient-zero/6814997249?i=6814997425",
          "artwork": {
            "url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/1200x1200bb.jpg",
            "width": 3000,
            "height": 3000,
            "bgColor": "2b080c",
            "textColor1": "e2a971",
            "textColor2": "e5693c",
            "textColor3": "bd895d",
            "textColor4": "c05532"
          },
          "duration_ms": 225868,
          "track_number": null,
          "disc_number": null,
          "artist_name": "Taylor Swift",
          "explicit": false,
          "preview_url": null,
          "track_count": null
        },
        {
          "id": "1856301587",
          "kind": "song",
          "title": "The Fate of Ophelia",
          "subtitle": "The Fate of Ophelia (The Chainsmokers Remix) - Single · 2025",
          "album": null,
          "url": "https://music.apple.com/us/album/the-fate-of-ophelia/1856301585?i=1856301587",
          "artwork": {
            "url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a3/f4/e8/a3f4e86d-b574-ae74-7b92-fe582ceefc73/25UM1IM98397.rgb.jpg/1200x1200bb.jpg",
            "width": 3000,
            "height": 3000,
            "bgColor": "ffffff",
            "textColor1": "1f1a15",
            "textColor2": "2b241e",
            "textColor3": "4c4844",
            "textColor4": "55504b"
          },
          "duration_ms": 226074,
          "track_number": null,
          "disc_number": null,
          "artist_name": "Taylor Swift",
          "explicit": false,
          "preview_url": null,
          "track_count": null
        }
      ]
    },
    {
      "id": "artists_159260351_default.marker.Essentials-AdaptiveHorizontalSquareLockupSection",
      "title": "Essential Albums",
      "items": [
        {
          "id": "1528112358",
          "kind": "album",
          "title": "folklore (deluxe version)",
          "subtitle": "Taylor has one more folklore surprise: a bonus track, “the lakes.”",
          "album": null,
          "url": "https://music.apple.com/us/album/folklore-deluxe-version/1528112358",
          "artwork": {
            "url": "https://is1-ssl.mzstatic.com/image/thumb/Music115/v4/b5/80/dc/b580dca0-349d-036b-e09b-bd849f6affd8/20UMGIM64216.rgb.jpg/1200x1200bb.jpg",
            "width": 3000,
            "height": 3000,
            "bgColor": "c6c6c6",
            "textColor1": "090909",
            "textColor2": "0d0d0d",
            "textColor3": "2f2f2f",
            "textColor4": "323232"
          },
          "duration_ms": null,
          "track_number": null,
          "disc_number": null,
          "artist_name": "Taylor Swift",
          "explicit": true,
          "preview_url": null,
          "track_count": null
        },
        {
          "id": "1440935467",
          "kind": "album",
          "title": "1989",
          "subtitle": "Leaving country behind for pop, Taylor uses nostalgia to move forward.",
          "album": null,
          "url": "https://music.apple.com/us/album/1989/1440935467",
          "artwork": {
            "url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/89/4a/4a/894a4ab9-b0b0-9ea5-ca41-8da0b9b79453/14UMDIM03405.rgb.jpg/1200x1200bb.jpg",
            "width": 1400,
            "height": 1400,
            "bgColor": "d2b9a4",
            "textColor1": "0d0806",
            "textColor2": "0b090b",
            "textColor3": "342c26",
            "textColor4": "332c29"
          },
          "duration_ms": null,
          "track_number": null,
          "disc_number": null,
          "artist_name": "Taylor Swift",
          "explicit": false,
          "preview_url": null,
          "track_count": null
        }
      ]
    }
  ],
  "seo": {
    "title": "Taylor Swift - Apple Music",
    "description": null,
    "canonical_url": "https://music.apple.com/us/artist/taylor-swift/159260351"
  }
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

`top_songs`, `albums`, `music_videos` and `playlists` are the page's shelves of those names (an empty list when the page has none); `sections` lists every shelf with its `id`, `title` and `items`. Items share one shape: `id`, `kind`, `title`, `subtitle`, `album`, `url`, `artwork` (1200×1200 URL, size, colours), `duration_ms`, `track_number`, `disc_number`, `artist_name`, `explicit`, `preview_url`, `track_count`; a value the page does not give is null. On the artist's own shelves `artist_name` is the artist; on other people's shelves (playlists, compilations, appears on) it is null unless the row links an artist. An unknown id is a free 404; an id that is not digits, or a URL that is not an artist page, is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.