Şarkı

GET/v1/apple-music/track1 kredi

Tek bir şarkıyı döndürür: başlık, albüm, sanatçı, görsel; albüm URL'sinden okunduğunda ayrıca süresi, şarkı ve disk numarası ve önizlemesi.

01Sorgu parametreleri

Ad	Tür	Açıklama
idisteğe bağlı	string	Apple Music şarkı kimliği, örneğin `1833328840` (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 şarkı URL'si, örneğin `https://music.apple.com/us/album/lover/1468058165?i=1468058172`. `?i=<şarkı kimliği>` içeren bir albüm URL'si albümdeki bir şarkıyı gösterir; `/song/` URL'si de kabul edilir. URL'deki mağaza (`us`, `gb`, `tr`, …) okunur.

02İstek

curl "https://api.scrapesocial.ai/v1/apple-music/track?url=https%3A%2F%2Fmusic.apple.com%2Fus%2Falbum%2Flover%2F1468058165%3Fi%3D1468058169" \
  -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/track?url=https%3A%2F%2Fmusic.apple.com%2Fus%2Falbum%2Flover%2F1468058165%3Fi%3D1468058169

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "1468058169",
  "kind": "song",
  "title": "I Forgot That You Existed",
  "subtitle": null,
  "album": "Lover",
  "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,
  "seo": {
    "title": null,
    "description": null,
    "canonical_url": "https://music.apple.com/us/album/i-forgot-that-you-existed/1468058165?i=1468058169"
  }
}

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

`id` ya da `/song/` URL'si ile şarkı sayfası okunur; bu sayfada süre, şarkı ve disk numarası ve önizleme yoktur (null döner). `?i=` içeren bir albüm URL'si ile albüm sayfasındaki satır okunur; bunların hepsi oradadır. Öğ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. Bilinmeyen bir kimlik ya da o albümde olmayan bir `?i=` ücretsiz bir 404; `?i=` içermeyen bir albüm URL'si ya da başka türde 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.