SocialScrape
Get early access
Docs menu

Get started

Guides

API reference

Resources

Apple Music artist

Beta GET /v1/apple-music/artist

GET /v1/apple-music/artist

Bio, origin, genres, top songs and albums. Apple Music shows no follower or listener counts, so stats is empty. region is the storefront (default us); a URL carries its own.

  • Cost: 1 credit
  • Status: Beta. Built and tested against recorded responses; the shape may still gain fields.
  • Cache: Results are kept up to 30 days; send max_age_days to reuse them for free.
  • Timeout: A request still running after about 25 seconds answers 202 with a job to poll (Batch and jobs).

Parameters#

NameTypeRequiredDescription
urlURLone ofApple Music artist URL. Accepted hosts: music.apple.com.
idstringone ofApple Music artist id.

Send at least one of url, id. If you send several, the first listed is used and the rest are ignored.

Every request also accepts:

  • region: two-letter country code for results that vary by country. Changing it restarts the cursor chain.
  • trim: true for a smaller response without null fields and extra.
  • raw: true to also get the platform's original object as raw.
  • max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).

Example request#

Set your key in the environment first (see Authentication).

curl
curl -G "https://api.socialscrape.io/v1/apple-music/artist" \
  -H "x-api-key: $SOCIALSCRAPE_API_KEY" \
  --data-urlencode "url=https://music.apple.com/us/artist/taylor-swift/159260351"
Python
import os
import requests

params = {
    "url": "https://music.apple.com/us/artist/taylor-swift/159260351",
}
res = requests.get(
    "https://api.socialscrape.io/v1/apple-music/artist",
    headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},
    params=params,
)
body = res.json()

if body["ok"]:
    print(body["data"])
else:
    print(body["error"]["code"], body["error"]["message"])
TypeScript
const url = new URL("https://api.socialscrape.io/v1/apple-music/artist");
url.search = new URLSearchParams({
  "url": "https://music.apple.com/us/artist/taylor-swift/159260351"
}).toString();
const res = await fetch(url, {
  headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },
});
const body = await res.json();

if (body.ok) {
  console.log(body.data);
} else {
  console.error(body.error.code, body.error.message);
}
n8n
{
  "nodes": [
    {
      "name": "SocialScrape Apple Music artist",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        0,
        0
      ],
      "parameters": {
        "method": "GET",
        "url": "https://api.socialscrape.io/v1/apple-music/artist",
        "sendQuery": true,
        "queryParameters": {
          "parameters": [
            {
              "name": "url",
              "value": "https://music.apple.com/us/artist/taylor-swift/159260351"
            }
          ]
        },
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "x-api-key",
              "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"
            }
          ]
        }
      }
    }
  ],
  "connections": {}
}

Example response#

This is a sample from a recorded response, lists and long text are shortened. Status 200.

{
  "ok": true,
  "credits_charged": 1,
  "credits_remaining": 4999,
  "cached": false,
  "cached_at": null,
  "request_id": "req_e96f2f41c789fb5c9aa99adc",
  "data": {
    "object": "profile",
    "platform": "apple_music",
    "id": "159260351",
    "handle": null,
    "name": "Taylor Swift",
    "headline": null,
    "url": "https://music.apple.com/us/artist/taylor-swift/159260351",
    "kind": "artist",
    "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 fr...",
    "avatar_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",
    "banner_url": null,
    "verified": null,
    "is_private": null,
    "external_url": null,
    "links": null,
    "location": "West Reading, PA, United States",
    "category": "Pop",
    "created_at": null,
    "stats": {
      "followers": null,
      "following": null,
      "posts": null,
      "likes": null,
      "views": null
    },
    "extra": {
      "album_ids": [
        "1440933849",
        "1468058165",
        "1742057774"
      ],
      "albums": [
        {
          "content_rating": "explicit",
          "cover_url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/1200x1200bb.jpg",
          "genres": [
            "Pop",
            "Music"
          ],
          "id": "6814997249",
          "is_compilation": false,
          "is_single": false,
          "label": "Taylor Swift",
          "release_date": "2026-09-24",
          "title": "The Life of a Showgirl: The Encore",
          "track_count": 16,
          "url": "https://music.apple.com/us/album/the-life-of-a-showgirl-the-encore/6814997249"
        },
        {
          "cover_url": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/47/8a/b8/478ab8ac-d134-bad3-f700-364c83323bc6/26UMGIM11621.rgb.jpg/1200x1200bb.jpg",
          "genres": [
            "Pop",
            "Music"
          ],
          "id": "1875381397",
          "is_compilation": false,
          "is_single": true,
          "label": "Taylor Swift",
          "release_date": "2026-02-13",
          "title": "Opalite (Official Music Video Extended Versions) - Single",
          "track_count": 4,
          "url": "https://music.apple.com/us/album/opalite-official-music-video-extended-versions-single/1875381397"
        },
        {
          "content_rating": "explicit",
          "cover_url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/0e/e5/c7/0ee5c717-114f-f4e8-9f7c-e92dd6eb9152/25UM1IM74420.rgb.jpg/1200x1200bb.jpg",
          "genres": [
            "Pop",
            "Music"
          ],
          "id": "1850496031",
          "is_compilation": false,
          "is_single": false,
          "label": "Taylor Swift",
          "release_date": "2025-11-07",
          "title": "The Life of a Showgirl + Acoustic Collection",
          "track_count": 19,
          "url": "https://music.apple.com/us/album/the-life-of-a-showgirl-acoustic-collection/1850496031"
        }
      ],
      "born_or_formed": "December 13, 1989",
      "editorial_notes": {
        "short": "Favorite Taylor’s artist page for updates on The Life of a Showgirl."
      },
      "genres": [
        "Pop"
      ],
      "latest_release": {
        "cover_url": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/89/98/98/8998984f-9a80-c3e1-d59d-e6a6db859e0c/26UM1IM31403.rgb.jpg/1200x1200bb.jpg",
        "genres": [
          "Pop",
          "Music"
        ],
        "id": "6821937445",
        "is_compilation": false,
        "is_single": false,
        "label": "Taylor Swift",
        "release_date": "2026-10-16",
        "title": "Patient Zero - Single",
        "track_count": 3,
        "url": "https://music.apple.com/us/album/patient-zero-single/6821937445"
      },
      "next_albums": "/v1/catalog/us/artists/159260351/albums?offset=25",
      "top_songs": [
        {
          "album": "The Life of a Showgirl: The Encore",
          "artists": [
            "Taylor Swift"
          ],
          "cover_url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/a0/dd/fd/a0ddfd72-ee9e-f046-6466-a5dbefc696fa/26UM1IM21436.rgb.jpg/1200x1200bb.jpg",
          "duration_seconds": 225.868,
          "explicit": false,
          "id": "6814997425",
          "isrc": "USUG12602391",
          "preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/ec/c8/21/ecc821bd-1252-51fe-08f0-f3d548dcc91b/mzaf_6909590374062866776.plus.aac.ep.m4a",
          "released_at": "2026-09-24",
          "title": "Patient Zero",
          "url": "https://music.apple.com/us/album/patient-zero/6814997249?i=6814997425"
        },
        {
          "album": "Fearless",
          "artists": [
            "Taylor Swift"
          ],
          "cover_url": "https://is1-ssl.mzstatic.com/image/thumb/Music221/v4/cb/6e/a7/cb6ea70a-6cb8-89a0-4da7-91e2d04a7bba/08PNDIM05386.rgb.jpg/900x900bb.jpg",
          "duration_seconds": 231.133,
          "explicit": false,
          "id": "1440925035",
          "isrc": "USCJY0803328",
          "preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview211/v4/2c/6e/b8/2c6eb87b-a89c-98b0-f4c3-94846613b36b/mzaf_2293961516155991593.plus.aac.ep.m4a",
          "released_at": "2008-11-11",
          "title": "You Belong With Me",
          "url": "https://music.apple.com/us/album/you-belong-with-me/1440924803?i=1440925035"
        },
        {
          "album": "The Life of a Showgirl",
          "artists": [
            "Taylor Swift"
          ],
          "cover_url": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/2d/46/e0/2d46e0bc-8ab9-85dd-4b56-ee6951351034/25UM1IM19577.rgb.jpg/1200x1200bb.jpg",
          "duration_seconds": 226.074,
          "explicit": false,
          "id": "1833328840",
          "isrc": "USUG12506436",
          "preview_url": "https://audio-ssl.itunes.apple.com/itunes-assets/AudioPreview221/v4/4b/07/28/4b07285f-b50c-7aff-cb40-2d732256b703/mzaf_14590041634085649439.plus.aac.ep.m4a",
          "released_at": "2025-10-03",
          "title": "The Fate of Ophelia",
          "url": "https://music.apple.com/us/album/the-fate-of-ophelia/1833328839?i=1833328840"
        }
      ]
    }
  },
  "cursor": null,
  "has_more": null
}

Response#

A Profile object in data.

See Data models for every field. The envelope around data is described in Responses.

Errors#

Failures are free: credits_charged is 0. Branch on error.code, never on the message.

CodeHTTPRetryMeaning
invalid_params400noA parameter is missing, unknown or has the wrong type.
unsupported_url400noThe URL is not one this endpoint accepts (wrong platform or form).
not_found404noThe platform says this profile, post or item does not exist.

Every request can also fail with the account and platform errors listed on the Errors page.

Example error:

{
  "ok": false,
  "error": {
    "code": "not_found",
    "message": "The platform says this profile, post or item does not exist.",
    "retryable": false
  },
  "credits_charged": 0,
  "request_id": "req_0996220df8a376d6de6ffd3f"
}