Spotify

Playlist

per_call

Resolves any public Spotify playlist into its metadata and contents: owner, description, follower count, artwork, total track count and each track with artist, album, duration and added-at date. Results are paginated with a cursor so large editorial playlists can be walked end to end. Made for playlist research and pitching workflows.

Endpoint

GET /v1/spotify/playlist

Price

$1.50

per 1,000 calls · $0.0015 per call

Cost per call

1 credit

Failed calls never charged

Parameters

optional

string

The Spotify playlist ID. Required unless `url` is supplied.

url

optional

string

The public Spotify playlist URL. Required unless `id` is supplied.

cursor

optional

string

Pagination cursor returned by a previous response.

Example request

Sandbox calls return deterministic sample data in the live payload shape.

curl

curl "https://api.fastfetchz.com/v1/spotify/playlist?id=37i9dQZF1DXcBWIGoYBM5M" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json

{
  "success": true,
  "service": {
    "platform": "Spotify",
    "name": "Playlist",
    "slug": "playlist"
  },
  "credits_charged": 1,
  "credits_remaining": 99,
  "latency_ms": 214,
  "data": {
    "playlist": {
      "id": "37i9dQZF1DXcBWIGoYBM5M",
      "name": "Today's Top Hits",
      "description": "The hottest tracks right now.",
      "owner": {
        "id": "spotify",
        "display_name": "Spotify"
      },
      "followers": 35412908,
      "total_tracks": 50,
      "image_url": "https://cdn.example.com/spotify/playlist/todaystophits.jpg",
      "external_url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M"
    },
    "tracks": [
      {
        "position": 1,
        "id": "2plbrEY59IikOBgBGLjaoe",
        "name": "Die With A Smile",
        "artists": [
          "Lady Gaga",
          "Bruno Mars"
        ],
        "album": "Die With A Smile",
        "duration_ms": 251000,
        "added_at": "2026-08-04T10:35:44.704Z"
      },
      {
        "position": 2,
        "id": "6dOtVTDdiauQNfQ2Cf7lnc",
        "name": "APT.",
        "artists": [
          "ROSÉ",
          "Bruno Mars"
        ],
        "album": "APT.",
        "duration_ms": 169000,
        "added_at": "2026-08-11T10:35:44.704Z"
      }
    ],
    "paging": {
      "has_more": true,
      "next_cursor": "cursor_50"
    },
    "requested": "nasa"
  }
}

Error codes

StatusCodeMeaning

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.

402insufficient_creditsYour balance is below the cost of the call. Top up to continue.

403account_suspended / key_revokedThe account is suspended or the key was revoked.

429rate_limitedThe key exceeded its monthly cap or the burst limit. Retry later.

500upstream_errorUnexpected failure while fulfilling the request. Not charged.