Albüm
GET/v1/apple-music/album1 kredi
Bir albümü döndürür: başlık, sanatçı, görsel, yayın bilgisi, süresi, numarası ve önizlemesiyle her şarkı ve sanatçının diğer albümleri.
01Sorgu parametreleri
| Ad | Tür | Açıklama |
|---|---|---|
| idisteğe bağlı | string | Apple Music albüm kimliği, örneğin `1468058165` (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 albüm URL'si, örneğin `https://music.apple.com/us/album/lover/1468058165`. URL'deki mağaza (`us`, `gb`, `tr`, …) okunur. |
02İstek
curl "https://api.scrapesocial.ai/v1/apple-music/album?id=1468058165" \ -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/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"
}
}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
`release_info` sayfanın alt bilgi metnidir (yayın tarihi, şarkı sayısı ve süre, telif; her biri ayrı satırda). Her şarkı albümün `artwork` ve `album_id` alanlarını taşı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 ücretsiz bir 404; rakamlardan oluşmayan bir kimlik ya da albüm 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.