Çalma Listesi

GET/v1/spotify/playlist1 kredi

Bir çalma listesinin adını, açıklamasını, sahibini, takipçi sayısını ve görsellerini; şarkılarını sayfa başına 50 adet ve toplam şarkı sayısıyla birlikte döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
idisteğe bağlı	string	Spotify çalma listesi kimliği, örneğin `37i9dQZF1DX4UtSsGT1Sbe`. `id` ya da `url` parametrelerinden biri zorunludur; ikisi birden verilirse `id` kullanılır.
urlisteğe bağlı	string	open.spotify.com çalma listesi URL'si. `id` ya da `url` parametrelerinden biri zorunludur.
cursoristeğe bağlı	integer	Bir önceki sayfanın sayısal `cursor` değeri (`50` gibi bir konum); sonraki sayfayı almak için geri gönderilir. Verilmezse 0'dan başlar.Varsayılan: `0`

02İstek

curl "https://api.scrapesocial.ai/v1/spotify/playlist?id=37i9dQZF1DX4UtSsGT1Sbe" \
  -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/playlist?id=37i9dQZF1DX4UtSsGT1Sbe

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "37i9dQZF1DX4UtSsGT1Sbe",
  "uri": "spotify:playlist:37i9dQZF1DX4UtSsGT1Sbe",
  "__typename": "Playlist",
  "description": "The biggest songs of the 1980s. Cover: Michael Jackson",
  "followers": 12058430,
  "images": [
    {
      "sources": [
        {
          "height": null,
          "url": "https://i.scdn.co/image/ab67706f000000028c767aab2034bb8fafd33124",
          "width": null
        }
      ]
    }
  ],
  "name": "All Out 80s",
  "ownerV2": {
    "__typename": "User",
    "avatar": {
      "sources": [
        {
          "height": 64,
          "url": "https://i.scdn.co/image/ab67757000003b8255c25988a6ac314394d3fbf5",
          "width": 64
        },
        {
          "height": 300,
          "url": "https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5",
          "width": 300
        }
      ]
    },
    "name": "Spotify",
    "uri": "spotify:user:spotify",
    "username": "spotify"
  },
  "tracks": [
    {
      "id": "2LlQb7Uoj1kKyGhlkBf9aC",
      "__typename": "Track",
      "albumOfTrack": {
        "coverArt": {
          "sources": [
            {
              "height": 300,
              "url": "https://i.scdn.co/image/ab67616d00001e0232a7d87248d1b75463483df5",
              "width": 300
            },
            {
              "height": 64,
              "url": "https://i.scdn.co/image/ab67616d0000485132a7d87248d1b75463483df5",
              "width": 64
            }
          ]
        },
        "name": "Thriller",
        "uri": "spotify:album:2ANVost0y2y52ema1E9xAZ"
      },
      "artists": [
        {
          "profile": {
            "name": "Michael Jackson"
          },
          "uri": "spotify:artist:3fMbdgg4jU18AjLCKBhRSm"
        }
      ],
      "availableMarkets": null,
      "contentRating": {
        "label": "NONE"
      },
      "discNumber": 1,
      "duration": {
        "totalMilliseconds": 358807
      },
      "name": "Thriller",
      "playability": {
        "playable": true
      },
      "playcount": 1094230500,
      "previews": {
        "audioPreviews": [
          {
            "url": "https://p.scdn.co/mp3-preview/8b324c9265b3d58a815b9e405fd93238a740152d"
          }
        ]
      },
      "trackNumber": 4,
      "uri": "spotify:track:2LlQb7Uoj1kKyGhlkBf9aC"
    },
    {
      "id": "2WfaOiMkCvy7F5fcp2zZ8L",
      "__typename": "Track",
      "albumOfTrack": {
        "coverArt": {
          "sources": [
            {
              "height": 300,
              "url": "https://i.scdn.co/image/ab67616d00001e02e8dd4db47e7177c63b0b7d53",
              "width": 300
            },
            {
              "height": 64,
              "url": "https://i.scdn.co/image/ab67616d00004851e8dd4db47e7177c63b0b7d53",
              "width": 64
            }
          ]
        },
        "name": "Hunting High and Low",
        "uri": "spotify:album:1ER3B6zev5JEAaqhnyyfbf"
      },
      "artists": [
        {
          "profile": {
            "name": "a-ha"
          },
          "uri": "spotify:artist:2jzc5TC5TVFLXQlBNiIUzE"
        }
      ],
      "availableMarkets": null,
      "contentRating": {
        "label": "NONE"
      },
      "discNumber": 1,
      "duration": {
        "totalMilliseconds": 225280
      },
      "name": "Take on Me",
      "playability": {
        "playable": true
      },
      "playcount": 2973514799,
      "previews": {
        "audioPreviews": [
          {
            "url": "https://p.scdn.co/mp3-preview/d1427dd0a300eeccfc53b99a2ebf3c664a67414a"
          }
        ]
      },
      "trackNumber": 1,
      "uri": "spotify:track:2WfaOiMkCvy7F5fcp2zZ8L"
    }
  ],
  "cursor": 50,
  "totalCount": 150
}

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

Şarkılar `tracks` içinde, sayfa başına 50 adet ve `totalCount` ile gelir. Sonraki sayfa için yanıttaki `cursor` değerini (50, sonra 100 gibi bir sayı) `cursor` parametresiyle geri gönderin; son sayfada null olur. Sonun ötesindeki bir sayfa boş bir liste döndürür, 0 kredi düşer. Her şarkının `availableMarkets` alanı her zaman null'dır; ses `previews` yalnızca ilk 100 şarkı için doldurulur. Bulunamayan bir çalma listesi ü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.