Album

GET/v1/apple-music/album1 credit

Returns an album: title, artist, artwork, release information, every track with its duration, number and preview, and more albums by the artist.

01Query parameters

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

02Request

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

03Responses

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

GET /v1/apple-music/album?id=1468058165

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "1468058165",
  "kind": "album",
  "title": "Lover",
  "artist_name": "Taylor Swift",
  "artist_url": "https://music.apple.com/us/artist/taylor-swift/159260351",
  "url": "https://music.apple.com/us/album/lover/1468058165",
  "artwork": {
    "url": "https://is1-ssl.mzstatic.com/image/thumb/Music125/v4/49/3d/ab/493dab54-f920-9043-6181-80993b8116c9/19UMGIM53909.rgb.jpg/1200x1200bb.jpg",
    "width": 3900,
    "height": 3900,
    "bgColor": "fbcedd",
    "textColor1": "31251f",
    "textColor2": "223040",
    "textColor3": "5a4745",
    "textColor4": "4d4f60"
  },
  "track_count": 18,
  "release_info": "August 23, 2019\n18 songs, 1 hour 1 minute\n℗ 2019 Taylor Swift",
  "tracks": [
    {
      "id": "1468058169",
      "kind": "song",
      "title": "I Forgot That You Existed",
      "subtitle": null,
      "album": null,
      "url": "https://music.apple.com/us/album/i-forgot-that-you-existed/1468058165?i=1468058169",
      "artwork": {
        "url": "https://is1-ssl.mzstatic.com/image/thumb/Music125/v4/49/3d/ab/493dab54-f920-9043-6181-80993b8116c9/19UMGIM53909.rgb.jpg/1200x1200bb.jpg",
        "width": 3900,
        "height": 3900,
        "bgColor": "fbcedd",
        "textColor1": "31251f",
        "textColor2": "223040",
        "textColor3": "5a4745",
        "textColor4": "4d4f60"
      },
      "duration_ms": 170651,
      "track_number": 1,
      "disc_number": 1,
      "artist_name": "Taylor Swift",
      "explicit": false,
      "preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/9c/e2/97/9ce2976a-b1c8-aa80-3e94-f4562cbad53e/mzaf_13898706762824220632.plus.aac.ep.m4a",
      "track_count": null,
      "album_id": "1468058165"
    },
    {
      "id": "1468058171",
      "kind": "song",
      "title": "Cruel Summer",
      "subtitle": null,
      "album": null,
      "url": "https://music.apple.com/us/album/cruel-summer/1468058165?i=1468058171",
      "artwork": {
        "url": "https://is1-ssl.mzstatic.com/image/thumb/Music125/v4/49/3d/ab/493dab54-f920-9043-6181-80993b8116c9/19UMGIM53909.rgb.jpg/1200x1200bb.jpg",
        "width": 3900,
        "height": 3900,
        "bgColor": "fbcedd",
        "textColor1": "31251f",
        "textColor2": "223040",
        "textColor3": "5a4745",
        "textColor4": "4d4f60"
      },
      "duration_ms": 178426,
      "track_number": 2,
      "disc_number": 1,
      "artist_name": "Taylor Swift",
      "explicit": false,
      "preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/44/af/81/44af8168-9609-1b85-5048-ada08dceacf3/mzaf_5595361395314573470.plus.aac.ep.m4a",
      "track_count": null,
      "album_id": "1468058165"
    }
  ],
  "more_by_artist": [
    {
      "id": "1440933849",
      "kind": "album",
      "title": "reputation",
      "subtitle": "2017",
      "album": null,
      "url": "https://music.apple.com/us/album/reputation/1440933849",
      "artwork": {
        "url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/eb/e6/06/ebe606da-e00f-82d3-47f3-b79904eed541/17UM1IM24651.rgb.jpg/1200x1200bb.jpg",
        "width": 6000,
        "height": 6000,
        "bgColor": "ffffff",
        "textColor1": "010101",
        "textColor2": "222222",
        "textColor3": "343434",
        "textColor4": "4e4e4e"
      },
      "duration_ms": null,
      "track_number": null,
      "disc_number": null,
      "artist_name": null,
      "explicit": false,
      "preview_url": null,
      "track_count": 15
    },
    {
      "id": "1742057774",
      "kind": "album",
      "title": "THE TORTURED POETS DEPARTMENT: THE ANTHOLOGY",
      "subtitle": "2024",
      "album": null,
      "url": "https://music.apple.com/us/album/the-tortured-poets-department-the-anthology/1742057774",
      "artwork": {
        "url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a4/86/59/a486593a-53c9-1c2a-5122-8f25339f7359/24UMGIM44778.rgb.jpg/1200x1200bb.jpg",
        "width": 3000,
        "height": 3000,
        "bgColor": "302b27",
        "textColor1": "e8e2dd",
        "textColor2": "d5cfc8",
        "textColor3": "c3beb8",
        "textColor4": "b4aea8"
      },
      "duration_ms": null,
      "track_number": null,
      "disc_number": null,
      "artist_name": null,
      "explicit": true,
      "preview_url": null,
      "track_count": 31
    }
  ],
  "seo": {
    "title": null,
    "description": null,
    "canonical_url": "https://music.apple.com/us/album/lover/1468058165"
  }
}

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

`release_info` is the page's footer text (release date, song count and length, copyright, one per line). Every track carries the album's `artwork` and `album_id`. 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. An unknown id is a free 404; an id that is not digits, or a URL that is not an album 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.