Şarkı
GET/v1/spotify/track1 kredi
Bir şarkıyı döndürür: ad, süre, dinlenme sayısı, albümdeki sırası, içerik derecelendirmesi, çalınabilirlik durumu, albümü ve sanatçıları.
01Sorgu parametreleri
| Ad | Tür | Açıklama |
|---|---|---|
| idisteğe bağlı | string | Spotify şarkı kimliği, örneğin `3n3Ppam7vgaVa1iaRUc9Lp`. `id` ya da `url` parametrelerinden biri zorunludur; ikisi birden verilirse `id` kullanılır. |
| urlisteğe bağlı | string | open.spotify.com şarkı URL'si. `id` ya da `url` parametrelerinden biri zorunludur. |
02İstek
curl "https://api.scrapesocial.ai/v1/spotify/track?id=3n3Ppam7vgaVa1iaRUc9Lp" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Yanıtlar
API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.
GET /v1/spotify/track?id=3n3Ppam7vgaVa1iaRUc9Lp
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"__typename": "Track",
"associationsV3": {
"audioAssociations": [],
"videoAssociations": {
"totalCount": 1
}
},
"contentRating": {
"label": "NONE"
},
"duration": {
"totalMilliseconds": 222200
},
"id": "3n3Ppam7vgaVa1iaRUc9Lp",
"mediaType": "AUDIO",
"name": "Mr. Brightside",
"playability": {
"playable": true,
"reason": "PLAYABLE"
},
"playcount": 3556322774,
"saved": false,
"sharingInfo": {
"shareId": "38jAFC9FRhOKGcx1vpcYqQ",
"shareUrl": "https://open.spotify.com/track/3n3Ppam7vgaVa1iaRUc9Lp?si=38jAFC9FRhOKGcx1vpcYqQ"
},
"trackNumber": 2,
"uri": "spotify:track:3n3Ppam7vgaVa1iaRUc9Lp",
"albumOfTrack": {
"copyright": [
{
"text": "© 2005 The Island Def Jam Music Group, under exclusive license to Mercury Records Limited. Licensed courtesy of LK Records Limited",
"type": "C"
},
{
"text": "℗ 2005 The Island Def Jam Music Group, under exclusive license to Mercury Records Limited. Licensed courtesy of LK Records Limited",
"type": "P"
}
],
"courtesyLine": "",
"id": "4OHNH3sDzIxnmUADXzv2kT",
"date": {
"isoString": "2004-06-15T00:00:00Z",
"precision": "DAY",
"year": 2004
},
"name": "Hot Fuss",
"playability": {
"playable": true
},
"sharingInfo": {
"shareId": "X7aSHIYWQbyEsAt8wEgytA",
"shareUrl": "https://open.spotify.com/album/4OHNH3sDzIxnmUADXzv2kT?si=X7aSHIYWQbyEsAt8wEgytA"
},
"tracks": [
{
"track": {
"trackNumber": 1,
"uri": "spotify:track:3sj8vanUG3a2leRLXwmtuo"
}
},
{
"track": {
"trackNumber": 2,
"uri": "spotify:track:3n3Ppam7vgaVa1iaRUc9Lp"
}
}
],
"type": "ALBUM",
"uri": "spotify:album:4OHNH3sDzIxnmUADXzv2kT",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#1868A8"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e029c284a6855f4945dc5a3cd73",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d000048519c284a6855f4945dc5a3cd73",
"width": 64
}
]
}
},
"firstArtist": [
{
"discography": {
"albums": [
{
"date": {
"isoString": "2022-03-25T00:00:00Z",
"precision": "DAY",
"year": 2022
},
"name": "Pressure Machine (Deluxe)",
"playability": {
"playable": true
},
"sharingInfo": {
"shareId": "KDdMjgSWQhO5f98jwiKFng",
"shareUrl": "https://open.spotify.com/album/01Go8OwdhESlkxPwrx6515?si=KDdMjgSWQhO5f98jwiKFng"
},
"tracks": [
{
"track": {
"trackNumber": 1,
"uri": "spotify:track:4DfK3WIqrFbj4j0V70eMGf"
}
},
{
"track": {
"trackNumber": 2,
"uri": "spotify:track:6SJ9bSz0xZUeYEi3kqdGyX"
}
}
],
"type": "ALBUM",
"uri": "spotify:album:01Go8OwdhESlkxPwrx6515",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#689890"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02fbb8ee906c7e5d610553c701",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d00004851fbb8ee906c7e5d610553c701",
"width": 64
}
]
}
},
{
"date": {
"isoString": "2021-08-13T00:00:00Z",
"precision": "DAY",
"year": 2021
},
"name": "Pressure Machine",
"playability": {
"playable": true
},
"sharingInfo": {
"shareId": "aZI613pwSCmPI1KHrhoJ6A",
"shareUrl": "https://open.spotify.com/album/1qMFjBarjO2xD15BwXZguD?si=aZI613pwSCmPI1KHrhoJ6A"
},
"tracks": [
{
"track": {
"trackNumber": 1,
"uri": "spotify:track:5hiZJE6Fg14Wao6EJ0KUC8"
}
},
{
"track": {
"trackNumber": 2,
"uri": "spotify:track:3d21GqE75Ule4pXPmGw1fy"
}
}
],
"type": "ALBUM",
"uri": "spotify:album:1qMFjBarjO2xD15BwXZguD",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#F0F0F0"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02821b4532e68c92632277838b",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d00004851821b4532e68c92632277838b",
"width": 64
}
]
}
}
],
"popularReleasesAlbums": [
{
"date": {
"isoString": "2006-09-27T00:00:00Z",
"precision": "DAY",
"year": 2006
},
"name": "Sam's Town",
"playability": {
"playable": true
},
"sharingInfo": {
"shareId": "qE8DKDrDQD6LqbUN6oEo3A",
"shareUrl": "https://open.spotify.com/album/4o3RJndRhHxkieQzQGhmbw?si=qE8DKDrDQD6LqbUN6oEo3A"
},
"tracks": [
{
"track": {
"trackNumber": 1,
"uri": "spotify:track:77Kh98jRHI40rIAKnBs7cl"
}
},
{
"track": {
"trackNumber": 2,
"uri": "spotify:track:4pTvgNra8siMoIT8u3epTr"
}
}
],
"type": "ALBUM",
"uri": "spotify:album:4o3RJndRhHxkieQzQGhmbw",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#C01020"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e024f87f14089217e3f70a5f39e",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d000048514f87f14089217e3f70a5f39e",
"width": 64
}
]
}
},
{
"date": {
"isoString": "2008-11-18T00:00:00Z",
"precision": "DAY",
"year": 2008
},
"name": "Day & Age (Bonus Tracks)",
"playability": {
"playable": true
},
"sharingInfo": {
"shareId": "ivWID28_RJin-0qXycg_lw",
"shareUrl": "https://open.spotify.com/album/0Ug5scDXUIgGN8yanDBLQw?si=ivWID28_RJin-0qXycg_lw"
},
"tracks": [
{
"track": {
"trackNumber": 1,
"uri": "spotify:track:4gsOR9hEmZqJF8BSLKuHUA"
}
},
{
"track": {
"trackNumber": 2,
"uri": "spotify:track:1sTsuZTdANkiFd7T34H3nb"
}
}
],
"type": "ALBUM",
"uri": "spotify:album:0Ug5scDXUIgGN8yanDBLQw",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#503870"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02a43cd43ef4f3b2d5413b17f9",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d00004851a43cd43ef4f3b2d5413b17f9",
"width": 64
}
]
}
}
],
"singles": [
{
"date": {
"isoString": "2025-07-11T00:00:00Z",
"precision": "DAY",
"year": 2025
},
"name": "Encore At The Garden",
"playability": {
"playable": true
},
"sharingInfo": {
"shareId": "bgRo3LnJSPCsGY0J7MvFwA",
"shareUrl": "https://open.spotify.com/album/0smcKd2SpZQYsUBXGyJNKS?si=bgRo3LnJSPCsGY0J7MvFwA"
},
"tracks": [
{
"track": {
"trackNumber": 1,
"uri": "spotify:track:43DsRbowKGEcfWpsTgCPAa"
}
},
{
"track": {
"trackNumber": 2,
"uri": "spotify:track:5xwoPYlLOUJSIP0brWKhX8"
}
}
],
"type": "SINGLE",
"uri": "spotify:album:0smcKd2SpZQYsUBXGyJNKS",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#F8B050"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02a8c9b6b5f7c9004a07f1381e",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d00004851a8c9b6b5f7c9004a07f1381e",
"width": 64
}
]
}
},
{
"date": {
"isoString": "2024-08-09T00:00:00Z",
"precision": "DAY",
"year": 2024
},
"name": "Bright Lights",
"playability": {
"playable": true
},
"sharingInfo": {
"shareId": "xVhfx_uzQ4a_gEzyNHRQGg",
"shareUrl": "https://open.spotify.com/album/5tXjEtdOSXA0DHyt6doeJ4?si=xVhfx_uzQ4a_gEzyNHRQGg"
},
"tracks": [
{
"track": {
"trackNumber": 1,
"uri": "spotify:track:6Nd4WPRscBW9wGi2l7K1Ot"
}
}
],
"type": "SINGLE",
"uri": "spotify:album:5tXjEtdOSXA0DHyt6doeJ4",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#981818"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e027019e697187ebca73a6f10d4",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d000048517019e697187ebca73a6f10d4",
"width": 64
}
]
}
}
],
"topTracks": [
{
"track": {
"albumOfTrack": {
"name": "Hot Fuss",
"uri": "spotify:album:4piJq7R3gjUOxnYs6lDCTg",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#2860A0"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02ccdddd46119a4ff53eaf1f5d",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d00004851ccdddd46119a4ff53eaf1f5d",
"width": 64
}
]
}
},
"artists": [
{
"profile": {
"name": "The Killers"
},
"uri": "spotify:artist:0C0XlULifJtAgn6ZNCW2eu"
}
],
"associationsV3": {
"audioAssociations": [],
"videoAssociations": {
"totalCount": 1
}
},
"contentRating": {
"label": "NONE"
},
"duration": {
"totalMilliseconds": 222973
},
"id": "003vvx7Niy0yvhvHt4a68B",
"mediaType": "AUDIO",
"name": "Mr. Brightside",
"playability": {
"playable": true
},
"playcount": 3556322774,
"previews": {
"audioPreviews": [
{
"url": "https://p.scdn.co/mp3-preview/848b1bd5544e82f62f9cfcec65362d0f5369781f"
}
]
},
"uri": "spotify:track:003vvx7Niy0yvhvHt4a68B"
}
},
{
"track": {
"albumOfTrack": {
"name": "Hot Fuss",
"uri": "spotify:album:4piJq7R3gjUOxnYs6lDCTg",
"coverArt": {
"extractedColors": {
"colorRaw": {
"hex": "#2860A0"
}
},
"sources": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02ccdddd46119a4ff53eaf1f5d",
"width": 300
},
{
"height": 64,
"url": "https://i.scdn.co/image/ab67616d00004851ccdddd46119a4ff53eaf1f5d",
"width": 64
}
]
}
},
"artists": [
{
"profile": {
"name": "The Killers"
},
"uri": "spotify:artist:0C0XlULifJtAgn6ZNCW2eu"
}
],
"associationsV3": {
"audioAssociations": [],
"videoAssociations": {
"totalCount": 1
}
},
"contentRating": {
"label": "NONE"
},
"duration": {
"totalMilliseconds": 197200
},
"id": "6PwjJ58I4t7Mae9xfZ9l9v",
"mediaType": "AUDIO",
"name": "Somebody Told Me",
"playability": {
"playable": true
},
"playcount": 1320229966,
"previews": {
"audioPreviews": [
{
"url": "https://p.scdn.co/mp3-preview/9d5dccc54383f11aace0193ad05d28f6573be190"
}
]
},
"uri": "spotify:track:6PwjJ58I4t7Mae9xfZ9l9v"
}
}
]
},
"id": "0C0XlULifJtAgn6ZNCW2eu",
"profile": {
"name": "The Killers"
},
"relatedContent": {
"relatedArtists": [
{
"id": "7oPftvlwr6VrsViSDV7fJY",
"profile": {
"name": "Green Day"
},
"uri": "spotify:artist:7oPftvlwr6VrsViSDV7fJY",
"visuals": {
"avatarImage": {
"sources": [
{
"height": 640,
"url": "https://i.scdn.co/image/ab6761610000e5eb6ff0cd5ef2ecf733804984bb",
"width": 640
},
{
"height": 160,
"url": "https://i.scdn.co/image/ab6761610000f1786ff0cd5ef2ecf733804984bb",
"width": 160
}
]
}
}
},
{
"id": "0SwO7SWeDHJijQ3XNS7xEE",
"profile": {
"name": "MGMT"
},
"uri": "spotify:artist:0SwO7SWeDHJijQ3XNS7xEE",
"visuals": {
"avatarImage": {
"sources": [
{
"height": 640,
"url": "https://i.scdn.co/image/ab6761610000e5eb9dccdc8f4087cbe2bdedc9d3",
"width": 640
},
{
"height": 160,
"url": "https://i.scdn.co/image/ab6761610000f1789dccdc8f4087cbe2bdedc9d3",
"width": 160
}
]
}
}
}
]
},
"uri": "spotify:artist:0C0XlULifJtAgn6ZNCW2eu",
"visuals": {
"avatarImage": {
"sources": [
{
"height": 640,
"url": "https://i.scdn.co/image/ab6761610000e5eb207b21f3ed0ee96adce3166a",
"width": 640
},
{
"height": 160,
"url": "https://i.scdn.co/image/ab6761610000f178207b21f3ed0ee96adce3166a",
"width": 160
}
]
}
}
}
],
"otherArtists": [],
"popularity": 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
`playcount` sayısal bir değerdir. `popularity` her zaman null döner. Bulunamayan bir şarkı ücretsiz bir 404 döndürür.
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.