# Spotify Playlist API (spotify.playlist)

- Canonical page: [https://everyinfra.com/en/spotify-api/playlist](https://everyinfra.com/en/spotify-api/playlist?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "spotify", "action": "playlist", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=spotify&action=playlist

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | Specifies the target open.spotify.com link, spotify:type:ID URI, or raw entity ID corresponding to the chosen action (artist, track, album, or playlist). Input types must match the endpoint action and cannot be interchanged. Legacy profile endpoints accept full Spotify links to return album and single streaming metadata rather than user profile account details. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| name | Name of the object itself, for account, product and business capabilities. |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| owner_name | platform-native meaning |
| save_count | platform-native meaning |
| follower_count | Followers. null means not disclosed, not 0. |
| track_count | platform-native meaning |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| tracks | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "spotify",
  "action": "playlist",
  "params": {
    "url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "spotify",
        "action": "playlist",
        "params": {
            "url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "spotify",
  "action": "playlist",
  "results": {
    "id": "37i9dQZF1DXcBWIGoYBM5M",
    "url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M",
    "name": "Today’s Top Hits",
    "text": "The hottest 50. Cover: ADÉLA",
    "owner_name": "•••",
    "save_count": 33769619,
    "track_count": 50,
    "image_url": "https://i.scdn.co/image/ab67706f0000000209dec89719704eea4f218966",
    "tracks": [
      {
        "id": "70cHKK8bHAfJrOGVnfRG9J",
        "url": "https://open.spotify.com/track/70cHKK8bHAfJrOGVnfRG9J",
        "name": "Nicole Kidman",
        "artists": [
          "ADÉLA"
        ],
        "album_name": "PRIMA",
        "duration_ms": 181270,
        "play_count": 58825168,
        "is_explicit": true,
        "added_at": "2026-09-11T04:01:53.033000+00:00",
        "platform": "spotify"
      },
      {
        "id": "11hcBLPtbMp4aQI6zGQLub",
        "url": "https://open.spotify.com/track/11hcBLPtbMp4aQI6zGQLub",
        "name": "Patient Zero",
        "artists": [
          "Taylor Swift"
        ],
        "album_name": "The Life of a Showgirl: The Encore",
        "duration_ms": 225868,
        "play_count": 0,
        "is_explicit": false,
        "added_at": "2026-09-25T04:02:48.872000+00:00",
        "platform": "spotify"
      },
      {
        "id": "3h5T5JypYU7huFiVYhv1dr",
        "url": "https://open.spotify.com/track/3h5T5JypYU7huFiVYhv1dr",
        "name": "BbY WOW",
        "artists": [
          "KAROL G",
          "Judeline",
          "rusowsky"
        ],
        "album_name": "NO ME ARREPIENTO DE SENTIR TANTO",
        "duration_ms": 225834,
        "play_count": 211190334,
        "is_explicit": false,
        "added_at": "2026-08-21T04:01:49.587000+00:00",
        "platform": "spotify"
      }
    ],
    "platform": "spotify"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=spotify
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
