# SoundCloud Playlist search API (soundcloud.search_playlists)

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

SoundCloud Playlist search looks up playlists and albums that match a `keyword`. Each result carries the title, description, genre, track count, total length, likes, reposts, artwork, publish time and link, plus the creator's name, profile link and verification. Use it to find playlists worth pitching a track to, to map the collections around a genre or mood, or to watch which sets gain traction.

`keyword` searches playlists only; tracks are found with SoundCloud Search and accounts with SoundCloud User search, even though all three take a keyword. `is_album` tells albums apart from ordinary playlists. `duration_sec` is the total length in seconds, not milliseconds as on some music platforms, and `text` is the description in full.

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Specifies the target query string used to discover tracks via search, artists via search_users, or sets via search_playlists. Although shared across endpoints, each action yields distinct entity types. On the playlist action, this parameter serves as a fallback search term only when a full /sets/ URL is missing, which does not guarantee an exact playlist match. |
| limit | integer (1–50) | no | 20 | The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## 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. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| url | Link to the record on the platform. |
| 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). |
| genre | platform-native meaning |
| track_count | platform-native meaning |
| duration_sec | platform-native meaning |
| duration_seconds | Duration in seconds. null for content that is not video or audio. |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| repost_count | Reposts (as distinct from quote posts). null means not disclosed. |
| is_album | platform-native meaning |
| artwork_url | platform-native meaning |
| artist_name | platform-native meaning |
| artist_url | platform-native meaning |
| artist_verified | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| 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": "soundcloud",
  "action": "search_playlists",
  "params": {
    "keyword": "coffee"
  }
}'
```

```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": "soundcloud",
        "action": "search_playlists",
        "params": {
            "keyword": "coffee",
        },
    },
    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; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "soundcloud",
  "action": "search_playlists",
  "results": [
    {
      "id": 1589968831,
      "title": "Coffee Jazz",
      "url": "https://soundcloud.com/relaxcafemusic/sets/coffee-jazz",
      "text": "Create a laid-back atmosphere with this playlist featuring mellow jazz tracks perfect for a weekend of relaxation and productivity.",
      "genre": "Jazz & Blues",
      "track_count": 432,
      "duration_sec": 73959,
      "like_count": 13217,
      "repost_count": 311,
      "is_album": false,
      "artwork_url": "https://i1.sndcdn.com/artworks-0VmDyPGZZtE1mpcz-t8vvBw-large.jpg",
      "artist_name": "Relax Cafe Music BGM",
      "artist_url": "https://soundcloud.com/relaxcafemusic",
      "artist_verified": false,
      "posted_at": "2023-03-24T18:42:10+00:00",
      "platform": "soundcloud"
    },
    {
      "id": 1725794754,
      "title": "Coffee shop music",
      "url": "https://soundcloud.com/relaxcafemusic/sets/coffee-shop-music",
      "text": "",
      "genre": "Jazz & Blues",
      "track_count": 387,
      "duration_sec": 73211,
      "like_count": 510,
      "repost_count": 13,
      "is_album": false,
      "artwork_url": "https://i1.sndcdn.com/artworks-yIaA9WRxh0HpIUyI-I0SbcQ-large.jpg",
      "artist_name": "Relax Cafe Music BGM",
      "artist_url": "https://soundcloud.com/relaxcafemusic",
      "artist_verified": false,
      "posted_at": "2023-11-21T15:19:05+00:00",
      "platform": "soundcloud"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### How do I tell albums from playlists?

Check `is_album`: true means the set is published as an album, false means it is a playlist. Pair it with `artist_verified` when you want official releases from verified artists rather than collections anyone can assemble.

### Who made a playlist, and how do I learn more about them?

`artist_name` and `artist_url` identify the account that published it, and `artist_verified` shows whether SoundCloud verified that account. Pass `artist_url` to SoundCloud Artist details to read the creator's followers, track count and location.

### How do I find the most popular playlists for a genre?

Search the genre or mood as `keyword`, then rank the rows by `like_count` and `repost_count`; a repost carries a playlist to the reposter's followers, so reposts show how far it spreads. `genre` gives each set's genre label, useful for dropping off-topic results.

## Also

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