Playlist

GET/v1/spotify/playlist1 credit

Returns a playlist's name, description, owner, follower count and images, with its tracks 50 per page and the total track count.

01Query parameters

Name	Type	Description
idoptional	string	The Spotify playlist id, e.g. `37i9dQZF1DX4UtSsGT1Sbe`. One of `id` or `url` is required; `id` wins when both are given.
urloptional	string	The open.spotify.com playlist URL. One of `id` or `url` is required.
cursoroptional	integer	The numeric `cursor` from the previous page (an offset such as `50`), passed back to get the next page. Starts at 0 when omitted.Default: `0`

02Request

curl "https://api.scrapesocial.ai/v1/spotify/playlist?id=37i9dQZF1DX4UtSsGT1Sbe" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

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
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Tracks come in `tracks`, 50 per page, with `totalCount`. Pass the answer's `cursor` (a number such as 50, then 100) back as `cursor` for the next page; it is null on the last page. A page past the end returns an empty list for 0 credits. Each track's `availableMarkets` is always null, and audio `previews` are filled only for the first 100 tracks. An unknown playlist is a free 404.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.