Arama

GET/v1/apple-music/search1 kredi

Apple Music'te (ABD mağazası) arama yapar ve sonuç bölümlerini döndürür: en iyi sonuçlar, sanatçılar, albümler, şarkılar, çalma listeleri, radyo bölümleri, istasyonlar, klipler, ek videolar ve kategoriler, her birinde en fazla 20 öğe; `type` verilirse tek bir bölüm döner.

01Sorgu parametreleri

Ad	Tür	Açıklama
queryzorunlu	string	Aranacak ifade.
typeisteğe bağlı	string	Yalnızca tek bir bölüm. `all` (ya da hiç verilmemesi) tüm bölümleri döndürür.Varsayılan: `all`Kabul edilen değerler:`allsongalbumartistplayliststationmusic_videoradio_episodetopvideo_extracategory`

02İstek

curl "https://api.scrapesocial.ai/v1/apple-music/search?query=radiohead" \
  -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/search?query=radiohead

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "query": "radiohead",
  "type": "all",
  "sections": [
    {
      "id": "top-search-section - top",
      "title": "Top Results",
      "items": [
        {
          "id": "657515",
          "kind": "artist",
          "title": "Radiohead",
          "subtitle": "Artist",
          "album": null,
          "url": "https://music.apple.com/us/artist/radiohead/657515",
          "artwork": {
            "url": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/8a/49/84/8a498443-718e-40c0-404e-d1380c2352b7/ami-identity-531db02daa273271c643ba631a46b9d5-2026-09-07T07-12-12.872Z_cropped.png/1200x1200bb.jpg",
            "width": 1050,
            "height": 1050,
            "bgColor": "131313",
            "textColor1": "eba140",
            "textColor2": "e29438",
            "textColor3": "c08437",
            "textColor4": "b87a31"
          },
          "duration_ms": null,
          "track_number": null,
          "disc_number": null,
          "artist_name": null,
          "explicit": false,
          "preview_url": null,
          "track_count": null
        },
        {
          "id": "1097862231",
          "kind": "song",
          "title": "Creep",
          "subtitle": "Song · Radiohead",
          "album": null,
          "url": "https://music.apple.com/us/album/creep/1097862062?i=1097862231",
          "artwork": {
            "url": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/78/a4/ec/78a4ec7b-c6d6-c9c8-441b-660486e56a89/634904077969.png/1200x1200bb.jpg",
            "width": 4000,
            "height": 4000,
            "bgColor": "ded9d2",
            "textColor1": "0e0a03",
            "textColor2": "3e2217",
            "textColor3": "38332c",
            "textColor4": "5e473c"
          },
          "duration_ms": null,
          "track_number": null,
          "disc_number": null,
          "artist_name": null,
          "explicit": true,
          "preview_url": null,
          "track_count": null
        }
      ]
    },
    {
      "id": "bubble-section - artist",
      "title": "Artists",
      "items": [
        {
          "id": "657515",
          "kind": "artist",
          "title": "Radiohead",
          "subtitle": null,
          "album": null,
          "url": "https://music.apple.com/us/artist/radiohead/657515",
          "artwork": {
            "url": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages211/v4/8a/49/84/8a498443-718e-40c0-404e-d1380c2352b7/ami-identity-531db02daa273271c643ba631a46b9d5-2026-09-07T07-12-12.872Z_cropped.png/1200x1200bb.jpg",
            "width": 1050,
            "height": 1050,
            "bgColor": "131313",
            "textColor1": "eba140",
            "textColor2": "e29438",
            "textColor3": "c08437",
            "textColor4": "b87a31"
          },
          "duration_ms": null,
          "track_number": null,
          "disc_number": null,
          "artist_name": null,
          "explicit": false,
          "preview_url": null,
          "track_count": null
        },
        {
          "id": "156334706",
          "kind": "artist",
          "title": "Ed O'Brien",
          "subtitle": null,
          "album": null,
          "url": "https://music.apple.com/us/artist/ed-obrien/156334706",
          "artwork": {
            "url": "https://is1-ssl.mzstatic.com/image/thumb/AMCArtistImages221/v4/3e/1c/8d/3e1c8ddf-90c9-bba3-e0e5-d0020666f239/ami_U003aidentity_U003aedd7ff071086cf77813db2cc769437ab-2026-10-05T16-03-39.015Z_cropped.png/1200x1200bb.jpg",
            "width": 1120,
            "height": 1120,
            "bgColor": "00167a",
            "textColor1": "dbb799",
            "textColor2": "cfa687",
            "textColor3": "af9793",
            "textColor4": "a68984"
          },
          "duration_ms": null,
          "track_number": null,
          "disc_number": null,
          "artist_name": null,
          "explicit": false,
          "preview_url": null,
          "track_count": null
        }
      ]
    }
  ]
}

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

`type` olmadan (ya da `all` ile) yanıt `query`, `type` ve `sections` alanlarından oluşur (`id`, `title`, `items`; sayfadaki sırayla). Bir `type` ile yanıt `query`, `type`, `results` (o bölümün öğeleri) ve `section` alanlarıdır (bölümün kendisi; sayfada yoksa null ve 0 kredi karşılığında boş liste). Öğ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. Sayfalama yoktur. Hiçbir bölüm bulamayan bir arama 200 ve boş liste döndürür, 0 kredi düşer; bilinmeyen bir `type` ü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.