Sanatçı

GET/v1/apple-music/artist1 kredi

Bir sanatçının Apple Music sayfasını döndürür: ad, görsel ve biyografi, en popüler şarkılar, albümler, klipler, çalma listeleri ve sayfadaki diğer tüm raflar (single'lar, canlı albümler, yer aldığı albümler, benzer sanatçılar, …).

01Sorgu parametreleri

Ad	Tür	Açıklama
idisteğe bağlı	string	Apple Music sanatçı kimliği, örneğin `159260351` (ABD mağazası). `id` ya da `url` parametrelerinden biri zorunludur; ikisi birden verilirse `url` kullanılır.
urlisteğe bağlı	string	music.apple.com sanatçı URL'si, örneğin `https://music.apple.com/us/artist/taylor-swift/159260351`. URL'deki mağaza (`us`, `gb`, `tr`, …) okunur.

02İstek

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

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

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"
  }
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

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

04Notlar

`top_songs`, `albums`, `music_videos` ve `playlists` sayfadaki aynı adlı raflardır (sayfada yoksa boş liste); `sections` her rafı `id`, `title` ve `items` ile listeler. Öğelerin hepsi aynı yapıdadır: `id`, `kind`, `title`, `subtitle`, `album`, `url`, `artwork` (1200×1200 URL, boyut, renkler), `duration_ms`, `track_number`, `disc_number`, `artist_name`, `explicit`, `preview_url`, `track_count`; sayfanın vermediği bir değer null döner. Sanatçının kendi raflarında `artist_name` sanatçının adıdır; başkalarının raflarında (çalma listeleri, derlemeler, yer aldığı albümler) satır bir sanatçıya bağlanmıyorsa null döner. Bilinmeyen bir kimlik ücretsiz bir 404; rakamlardan oluşmayan bir kimlik ya da sanatçı sayfası olmayan bir URL ücretsiz bir 400 hatası verir.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.