# Mixcloud

> Read public Mixcloud data on DJ mixes, radio shows and podcasts: shows with their tags and players, user profiles, favorites, listening history, followers, playlists and comments. Search, browse by tag, city or category, and start a workflow when a user uploads a show or a new show appears under a tag. No account or API key required.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/mixcloud

## Actions

### Discover shows

Find Mixcloud shows with a tag, from a city, or both (such as funk from London), most played of all time or newest first.

**Inputs**

- Tag (`tag`, text): Only shows with this tag, usually a genre, like 'Funk'. Give a tag, a city, or both.
- City (`city`, text): Only shows from this city, like 'London' or 'New York'. Give a tag, a city, or both.
- Order (`sort`, text): Most played of all time, or newest first. Defaults to most played. One of: `popular` (Most played of all time), `latest` (Newest first). Default: `popular`.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `city` (text): The city's slug, e.g. 'new-york', when given.
- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `page_url` (text): The same list's page on mixcloud.com.
- `shows` (list): The shows.
- `sort` (text): The order: popular or latest.
- `tag` (text): The tag's slug, when one was given.

**Example output**

```json
{
  "city": "london",
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "page_url": "https://www.mixcloud.com/genres/funk+city:london/",
  "shows": [
    {
      "audio_length_seconds": 3119,
      "comment_count": 163,
      "created_time": "2015-06-23T05:50:58Z",
      "duration": "51:59",
      "favorite_count": 6036,
      "hosts": [],
      "key": "/DJVadim/vadim-dj-mix-may-2015/",
      "listener_count": 60695,
      "name": "Deep In My Soul Mixtape",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/extaudio/0/6/e/c/fd24-c875-4006-bb64-21b7f5c78ea3.jpg",
      "play_count": 160205,
      "repost_count": 903,
      "slug": "vadim-dj-mix-may-2015",
      "stats_hidden": false,
      "tags": [
        {
          "name": "Soul",
          "slug": "soul",
          "url": "https://www.mixcloud.com/genres/soul/"
        },
        {
          "name": "Funk",
          "slug": "funk",
          "url": "https://www.mixcloud.com/genres/funk/"
        },
        {
          "name": "Electro soul",
          "slug": "electro-soul",
          "url": "https://www.mixcloud.com/genres/electro-soul/"
        },
        {
          "name": "Future sexy",
          "slug": "future-sexy",
          "url": "https://www.mixcloud.com/genres/future-sexy/"
        },
        {
          "name": "DJ Vadim",
          "slug": "dj-vadim",
          "url": "https://www.mixcloud.com/genres/dj-vadim/"
        }
      ],
      "updated_time": "2026-10-20T06:10:30Z",
      "url": "https://www.mixcloud.com/DJVadim/vadim-dj-mix-may-2015/",
      "user_name": "DJ Vadim",
      "user_url": "https://www.mixcloud.com/DJVadim/",
      "username": "DJVadim"
    }
  ],
  "sort": "popular",
  "tag": "funk"
}
```

### Get embed code

Get the HTML that puts a Mixcloud show's player on a web page or in a newsletter, at the size you choose, and the player's own address.

**Inputs**

- Show (`show`, text, required): The show's address on mixcloud.com, like https://www.mixcloud.com/spartacus/party-time/, or its key from an earlier step, like /spartacus/party-time/.
- Width (pixels) (`width`, number): How wide the player is, 100 to 2000 pixels. Leave empty for the full width of the page. From 100 to 2000.
- Height (pixels) (`height`, number): How tall the player is, 60 to 1000 pixels. Leave empty for 120, the standard player. From 60 to 1000.

**Outputs**

- `height` (text): The player's height in pixels, e.g. '120'.
- `html` (text): The iframe HTML to paste into a web page.
- `show` (text): The key of the show the list is for.
- `show_url` (text): The show's page on mixcloud.com.
- `widget_url` (text): The player's own address, the iframe's src.
- `width` (text): The player's width, e.g. '480' or '100%'.

**Example output**

```json
{
  "height": "120",
  "html": "<iframe width=\"100%\" height=\"120\" src=\"https://www.mixcloud.com/widget/iframe/?feed=https%3A%2F%2Fwww.mixcloud.com%2Fspartacus%2Fparty-time%2F&amp;hide_cover=1&amp;light=1\" frameborder=\"0\" allow=\"encrypted-media; fullscreen; autoplay; idle-detection; speaker-selection; web-share;\"></iframe>",
  "show": "/spartacus/party-time/",
  "show_url": "https://www.mixcloud.com/spartacus/party-time/",
  "widget_url": "https://www.mixcloud.com/widget/iframe/?feed=https%3A%2F%2Fwww.mixcloud.com%2Fspartacus%2Fparty-time%2F&hide_cover=1&light=1",
  "width": "100%"
}
```

### Get show

Get a Mixcloud show: its title, description, uploader, hosts, tags, length, play and favorite counts, cover picture, and its tracklist when the uploader shares one through the API.

**Inputs**

- Show (`show`, text, required): The show's address on mixcloud.com, like https://www.mixcloud.com/spartacus/party-time/, or its key from an earlier step, like /spartacus/party-time/.

**Outputs**

- `audio_length_seconds` (number): How long it is, in seconds.
- `comment_count` (number): How many comments it has.
- `created_time` (text): When it was uploaded, ISO 8601 in UTC, e.g. '2026-10-19T21:38:50Z'.
- `description` (text): What the uploader wrote about the show.
- `duration` (text): How long it is, e.g. '56:01' or '1:58:20'.
- `favorite_count` (number): How many people favorited it.
- `hosts` (list): Other accounts tagged as hosts of the show.
- `key` (text): Mixcloud's key for the show, e.g. '/spartacus/party-time/'. Every show field takes it.
- `listener_count` (number): How many people listened to it.
- `name` (text): The show's title.
- `picture_url` (text): The show's cover picture, 600 by 600 pixels.
- `play_count` (number): How many times it was played.
- `repost_count` (number): How many reposted it.
- `slug` (text): The last part of its address, e.g. 'party-time'.
- `stats_hidden` (true/false): True when the uploader hides its counts, which then read 0.
- `tags` (list): The show's tags, usually genres, at most 5.
- `tracklist` (list): The tracks and chapters, when the uploader shares them through the API. Most shows keep their tracklist on mixcloud.com only, so this is often empty.
- `updated_time` (text): When it last changed, ISO 8601 in UTC, e.g. '2026-10-19T21:38:50Z'.
- `url` (text): The show's page.
- `user_name` (text): The name of who uploaded it.
- `user_url` (text): The uploader's profile page.
- `username` (text): The username of who uploaded it.

**Example output**

```json
{
  "audio_length_seconds": 3361,
  "comment_count": 5,
  "created_time": "2009-08-02T16:55:01Z",
  "description": "Given I'm on the Mixcloud team, I thought I really should have something up here.  Here's an hour's worth of funky music to get you ready for partying, enjoy the music and ignore the quality (or lack thereof) of the DJ!",
  "duration": "56:01",
  "favorite_count": 39,
  "hosts": [],
  "key": "/spartacus/party-time/",
  "listener_count": 303,
  "name": "Party Time",
  "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/extaudio/6/1/a/1/279f-e3c0-4871-aa8e-c4cf5466edb8.png",
  "play_count": 9772,
  "repost_count": 9,
  "slug": "party-time",
  "stats_hidden": false,
  "tags": [
    {
      "name": "Funky house",
      "slug": "funky-house",
      "url": "https://www.mixcloud.com/genres/funky-house/"
    },
    {
      "name": "Funk",
      "slug": "funk",
      "url": "https://www.mixcloud.com/genres/funk/"
    },
    {
      "name": "Soul",
      "slug": "soul",
      "url": "https://www.mixcloud.com/genres/soul/"
    }
  ],
  "tracklist": [],
  "updated_time": "2026-10-18T20:26:26Z",
  "url": "https://www.mixcloud.com/spartacus/party-time/",
  "user_name": "Spartacus",
  "user_url": "https://www.mixcloud.com/spartacus/",
  "username": "spartacus"
}
```

### Get user

Get a Mixcloud user's public profile: name, bio, city and country, how many shows they uploaded, their followers and following counts, and their pictures.

**Inputs**

- User (`user`, text, required): The Mixcloud username, like 'NTSRadio', or the profile's address, like https://www.mixcloud.com/NTSRadio/.

**Outputs**

- `bio` (text): What they wrote about themselves.
- `city` (text): Their city, if given.
- `country` (text): Their country, if given.
- `cover_picture_url` (text): The wide banner on their profile, when they set one.
- `created_time` (text): When they joined Mixcloud, ISO 8601 in UTC, e.g. '2026-10-19T21:38:50Z'.
- `favorite_count` (number): How many shows they favorited.
- `follower_count` (number): How many follow them.
- `following_count` (number): How many they follow.
- `is_premium` (true/false): True for a Mixcloud Premium listener account.
- `is_pro` (true/false): True for a Mixcloud Pro creator account.
- `key` (text): Mixcloud's key for the user, e.g. '/spartacus/'.
- `listen_count` (number): How many shows they listened to.
- `name` (text): The name they show on Mixcloud, e.g. 'Spartacus'.
- `picture_url` (text): Their profile picture, 600 by 600 pixels.
- `show_count` (number): How many shows they uploaded.
- `url` (text): Their profile page on mixcloud.com.
- `username` (text): The user's Mixcloud username, as in their address, e.g. 'spartacus'.

**Example output**

```json
{
  "bio": "Part of the Mixcloud team - since Mixcloud was just a good idea.",
  "city": "London",
  "country": "United Kingdom",
  "cover_picture_url": "https://thumbnailer.mixcloud.com/unsafe/1670x240/profile_cover/d/b/9/0/4328-5114-4c10-adcb-613d0c92337f.jpg",
  "created_time": "2009-03-10T07:32:56Z",
  "favorite_count": 74,
  "follower_count": 772,
  "following_count": 102,
  "is_premium": true,
  "is_pro": true,
  "key": "/spartacus/",
  "listen_count": 2507,
  "name": "Spartacus",
  "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/profile/2/7/9/e/c70a-cdba-4fb6-a57d-c16f5520fdc9",
  "show_count": 5,
  "url": "https://www.mixcloud.com/spartacus/",
  "username": "spartacus"
}
```

### List categories

List Mixcloud's categories, such as House, Techno, Comedy or News, each marked music or talk.

**Inputs**

- Kind (`category_type`, text): Only music or only talk categories. Leave empty for both. One of: `music`, `talk`.

**Outputs**

- `categories` (list): The categories.
- `count` (number): How many came back.

**Example output**

```json
{
  "categories": [
    {
      "kind": "music",
      "name": "Ambient",
      "slug": "ambient",
      "url": "https://www.mixcloud.com/categories/ambient/"
    },
    {
      "kind": "music",
      "name": "Bass",
      "slug": "bass",
      "url": "https://www.mixcloud.com/categories/bass/"
    }
  ],
  "count": 2
}
```

### List category creators

List the creators Mixcloud features in a category, most recently featured first.

**Inputs**

- Category (`category`, text, required): The Mixcloud category. Pick one, or type its name like 'Deep House'.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `category` (text): The category's slug.
- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `users` (list): The featured creators, most recent first.

**Example output**

```json
{
  "category": "house",
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "users": [
    {
      "featured_time": "2025-10-01T11:12:11Z",
      "key": "/MelomaniacsCollective/",
      "name": "Melomaniacs",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/profile/a/8/9/9/4140-f501-43c5-ad06-e2122a9ea4d4",
      "url": "https://www.mixcloud.com/MelomaniacsCollective/",
      "username": "MelomaniacsCollective"
    }
  ]
}
```

### List category shows

List the newest shows Mixcloud files under a category. Mixcloud keeps about the latest 40.

**Inputs**

- Category (`category`, text, required): The Mixcloud category. Pick one, or type its name like 'Deep House'.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `category` (text): The category's slug.
- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `shows` (list): The shows, newest first.

**Example output**

```json
{
  "category": "house",
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "shows": [
    {
      "audio_length_seconds": 9041,
      "comment_count": 0,
      "created_time": "2026-10-20T05:18:58Z",
      "duration": "2:30:41",
      "favorite_count": 3,
      "hosts": [],
      "key": "/GrahamGold/graham-gold-live-at-bluerama-koh-phangan-sat-october-17-2026/",
      "listener_count": 9,
      "name": "Graham Gold Live at Bluerama Koh Phangan Sat October 17 2026",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/profile/b/f/9/4/82af-7cb4-4e58-bb25-def201c0508c",
      "play_count": 14,
      "repost_count": 2,
      "slug": "graham-gold-live-at-bluerama-koh-phangan-sat-october-17-2026",
      "stats_hidden": false,
      "tags": [
        {
          "name": "House",
          "slug": "house",
          "url": "https://www.mixcloud.com/genres/house/"
        },
        {
          "name": "Progressive house",
          "slug": "progressive-house",
          "url": "https://www.mixcloud.com/genres/progressive-house/"
        },
        {
          "name": "Electro house",
          "slug": "electro-house",
          "url": "https://www.mixcloud.com/genres/electro-house/"
        },
        {
          "name": "Deep house",
          "slug": "deep-house",
          "url": "https://www.mixcloud.com/genres/deep-house/"
        },
        {
          "name": "Melodic house",
          "slug": "melodic-house",
          "url": "https://www.mixcloud.com/genres/melodic-house/"
        }
      ],
      "updated_time": "2026-10-20T07:54:22Z",
      "url": "https://www.mixcloud.com/GrahamGold/graham-gold-live-at-bluerama-koh-phangan-sat-october-17-2026/",
      "user_name": "GrahamGold",
      "user_url": "https://www.mixcloud.com/GrahamGold/",
      "username": "GrahamGold"
    }
  ]
}
```

### List followers

List the people who follow a Mixcloud user, most recent followers first.

**Inputs**

- User (`user`, text, required): The Mixcloud username, like 'NTSRadio', or the profile's address, like https://www.mixcloud.com/NTSRadio/.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `user` (text): The username the list is for.
- `users` (list): The followers, most recent first.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "user": "spartacus",
  "users": [
    {
      "key": "/integrationsmixcloud/",
      "name": "integrationsmixcloud",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/defaults/users/v2/5.png",
      "url": "https://www.mixcloud.com/integrationsmixcloud/",
      "username": "integrationsmixcloud"
    }
  ]
}
```

### List following

List the people a Mixcloud user follows, most recently followed first.

**Inputs**

- User (`user`, text, required): The Mixcloud username, like 'NTSRadio', or the profile's address, like https://www.mixcloud.com/NTSRadio/.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `user` (text): The username the list is for.
- `users` (list): The users followed, most recent first.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "user": "spartacus",
  "users": [
    {
      "key": "/SuburbanArchitecture/",
      "name": "Suburban Architecture",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/profile/9/8/a/d/bb97-e592-4ec7-80a0-093bbe8602d0",
      "url": "https://www.mixcloud.com/SuburbanArchitecture/",
      "username": "SuburbanArchitecture"
    }
  ]
}
```

### List playlist shows

List the shows in a Mixcloud playlist, in its order.

**Inputs**

- Playlist (`playlist`, text, required): The playlist's address on mixcloud.com, like https://www.mixcloud.com/spartacus/playlists/jazz/, or its key from List user's playlists.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `playlist` (text): The playlist's key, e.g. '/spartacus/playlists/jazz/'.
- `playlist_url` (text): The playlist's page on mixcloud.com.
- `shows` (list): The shows, in the playlist's order.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "playlist": "/spartacus/playlists/jazz/",
  "playlist_url": "https://www.mixcloud.com/spartacus/playlists/jazz/",
  "shows": [
    {
      "audio_length_seconds": 3713,
      "comment_count": 83,
      "created_time": "2014-02-23T16:11:31Z",
      "duration": "1:01:53",
      "favorite_count": 1812,
      "hosts": [],
      "key": "/lowlight/quintessential-jazz/",
      "listener_count": 15465,
      "name": "Quintessential Jazz",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/extaudio/e/3/9/2/fdec-4b7e-496f-af32-fe8b821e7091.jpg",
      "play_count": 39397,
      "repost_count": 128,
      "slug": "quintessential-jazz",
      "stats_hidden": false,
      "tags": [
        {
          "name": "Jazz",
          "slug": "jazz",
          "url": "https://www.mixcloud.com/genres/jazz/"
        },
        {
          "name": "Chill",
          "slug": "chill",
          "url": "https://www.mixcloud.com/genres/chill/"
        },
        {
          "name": "Classic",
          "slug": "classic",
          "url": "https://www.mixcloud.com/genres/classic/"
        },
        {
          "name": "Miles Davis",
          "slug": "miles-davis",
          "url": "https://www.mixcloud.com/genres/miles-davis/"
        },
        {
          "name": "Chillout",
          "slug": "chillout",
          "url": "https://www.mixcloud.com/genres/chillout/"
        }
      ],
      "updated_time": "2026-10-17T16:20:52Z",
      "url": "https://www.mixcloud.com/lowlight/quintessential-jazz/",
      "user_name": "low light mixes",
      "user_url": "https://www.mixcloud.com/lowlight/",
      "username": "lowlight"
    }
  ]
}
```

### List show comments

List the comments on a Mixcloud show, newest first, with who wrote each and when.

**Inputs**

- Show (`show`, text, required): The show's address on mixcloud.com, like https://www.mixcloud.com/spartacus/party-time/, or its key from an earlier step, like /spartacus/party-time/.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `comments` (list): The comments, newest first.
- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `show` (text): The key of the show the list is for.

**Example output**

```json
{
  "comments": [
    {
      "comment": "Hey ho!",
      "key": "/comments/cr/64/1766/c26549605/",
      "submitted_time": "2024-01-18T11:17:57Z",
      "url": "https://www.mixcloud.com/spartacus/party-time/?commentId=Q29tbWVudDoyNjU0OTYwNQ==",
      "user_name": "integrationsmixcloud",
      "user_url": "https://www.mixcloud.com/integrationsmixcloud/",
      "username": "integrationsmixcloud"
    }
  ],
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "show": "/spartacus/party-time/"
}
```

### List show listeners

List the people who listened to a Mixcloud show, most recent first, with when they listened. Listeners who keep their listening private are left out.

**Inputs**

- Show (`show`, text, required): The show's address on mixcloud.com, like https://www.mixcloud.com/spartacus/party-time/, or its key from an earlier step, like /spartacus/party-time/.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `show` (text): The key of the show the list is for.
- `users` (list): The listeners, most recent first.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "show": "/spartacus/party-time/",
  "users": [
    {
      "key": "/integrationsmixcloud/",
      "listened_time": "2025-01-24T08:00:53Z",
      "name": "integrationsmixcloud",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/defaults/users/v2/6.png",
      "url": "https://www.mixcloud.com/integrationsmixcloud/",
      "username": "integrationsmixcloud"
    }
  ]
}
```

### List similar shows

List shows Mixcloud finds similar to a show, for recommendations.

**Inputs**

- Show (`show`, text, required): The show's address on mixcloud.com, like https://www.mixcloud.com/spartacus/party-time/, or its key from an earlier step, like /spartacus/party-time/.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `show` (text): The key of the show the list is for.
- `shows` (list): The similar shows.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "show": "/spartacus/party-time/",
  "shows": [
    {
      "audio_length_seconds": 11630,
      "comment_count": 31,
      "created_time": "2021-04-08T12:52:41Z",
      "duration": "3:13:50",
      "favorite_count": 0,
      "hosts": [
        {
          "name": "Gilles Peterson Worldwide",
          "url": "https://www.mixcloud.com/gillespeterson/",
          "username": "gillespeterson"
        }
      ],
      "key": "/worldwidefm/gilles-peterson-the-20-nu-jazz-08-04-21/",
      "listener_count": 0,
      "name": "Gilles Peterson: The 20 - Nu Jazz // 08-04-21",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/extaudio/e/9/7/2/6b0e-bc71-4f76-80cf-bac2d003c5a5",
      "play_count": 0,
      "repost_count": 0,
      "slug": "gilles-peterson-the-20-nu-jazz-08-04-21",
      "stats_hidden": true,
      "tags": [
        {
          "name": "Jazz",
          "slug": "jazz",
          "url": "https://www.mixcloud.com/genres/jazz/"
        },
        {
          "name": "Nu jazz",
          "slug": "nu-jazz",
          "url": "https://www.mixcloud.com/genres/nu-jazz/"
        },
        {
          "name": "Broken beat",
          "slug": "broken-beat",
          "url": "https://www.mixcloud.com/genres/broken-beat/"
        },
        {
          "name": "House",
          "slug": "house",
          "url": "https://www.mixcloud.com/genres/house/"
        },
        {
          "name": "WorldWide FM",
          "slug": "worldwide-fm",
          "url": "https://www.mixcloud.com/genres/worldwide-fm/"
        }
      ],
      "updated_time": "2026-10-19T07:46:09Z",
      "url": "https://www.mixcloud.com/worldwidefm/gilles-peterson-the-20-nu-jazz-08-04-21/",
      "user_name": "Worldwide FM",
      "user_url": "https://www.mixcloud.com/worldwidefm/",
      "username": "worldwidefm"
    }
  ]
}
```

### List tag shows

List a Mixcloud tag's shows, usually a genre's: the most played of recent weeks, the ones getting the most plays in the last few days, or the newest.

**Inputs**

- Tag (`tag`, text, required): The tag, usually a genre: its name like 'Deep House', or its page address like https://www.mixcloud.com/genres/deep-house/.
- Which shows (`sort`, text): Popular, hot or newest shows. Defaults to popular. One of: `popular` (Popular: the most played shows of recent weeks), `hot` (Hot: shows from the last few days getting the most plays), `new` (New: the newest shows first). Default: `popular`.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `shows` (list): The shows.
- `sort` (text): Which shows: popular, hot or new.
- `tag` (text): The tag's slug, e.g. 'deep-house'.
- `tag_url` (text): The tag's page on mixcloud.com.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "shows": [
    {
      "audio_length_seconds": 4442,
      "comment_count": 56,
      "created_time": "2026-09-26T06:24:22Z",
      "duration": "1:14:02",
      "favorite_count": 225,
      "hosts": [
        {
          "name": "2theBeat",
          "url": "https://www.mixcloud.com/Bobbythrust/",
          "username": "Bobbythrust"
        }
      ],
      "key": "/MonkeyShoulder/2thebeat-monkey-shoulder-mix/",
      "listener_count": 3444,
      "name": "2TheBeat -Monkey Shoulder Mix",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/extaudio/e/9/3/6/8bcf-1bfa-4e1d-9b3f-d5269d6b12db",
      "play_count": 8833,
      "repost_count": 24,
      "slug": "2thebeat-monkey-shoulder-mix",
      "stats_hidden": false,
      "tags": [
        {
          "name": "Drum and bass",
          "slug": "drum-and-bass",
          "url": "https://www.mixcloud.com/genres/drum-and-bass/"
        },
        {
          "name": "Funk",
          "slug": "funk",
          "url": "https://www.mixcloud.com/genres/funk/"
        },
        {
          "name": "Breaks",
          "slug": "breaks",
          "url": "https://www.mixcloud.com/genres/breaks/"
        },
        {
          "name": "Reggae",
          "slug": "reggae",
          "url": "https://www.mixcloud.com/genres/reggae/"
        },
        {
          "name": "Open Format",
          "slug": "open-format",
          "url": "https://www.mixcloud.com/genres/open-format/"
        }
      ],
      "updated_time": "2026-10-20T07:57:47Z",
      "url": "https://www.mixcloud.com/MonkeyShoulder/2thebeat-monkey-shoulder-mix/",
      "user_name": "Monkey Shoulder",
      "user_url": "https://www.mixcloud.com/MonkeyShoulder/",
      "username": "MonkeyShoulder"
    }
  ],
  "sort": "popular",
  "tag": "funk",
  "tag_url": "https://www.mixcloud.com/genres/funk/"
}
```

### List user's favorites

List the shows a Mixcloud user favorited, most recently favorited first.

**Inputs**

- User (`user`, text, required): The Mixcloud username, like 'NTSRadio', or the profile's address, like https://www.mixcloud.com/NTSRadio/.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `shows` (list): The favorited shows, most recent first.
- `user` (text): The username the list is for.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "shows": [
    {
      "audio_length_seconds": 2733,
      "comment_count": 3,
      "created_time": "2026-10-02T20:55:30Z",
      "duration": "45:33",
      "favorite_count": 14,
      "hosts": [],
      "key": "/sindicat-del-pop/jazz-session-10-new-york-afternoon/",
      "listener_count": 71,
      "name": "Jazz Session #10 - New York Afternoon",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/extaudio/a/0/e/4/6e4b-36dc-4e06-902b-a294a3618105",
      "play_count": 144,
      "repost_count": 4,
      "slug": "jazz-session-10-new-york-afternoon",
      "stats_hidden": false,
      "tags": [
        {
          "name": "Jazz",
          "slug": "jazz",
          "url": "https://www.mixcloud.com/genres/jazz/"
        },
        {
          "name": "Jazz dance",
          "slug": "jazz-dance",
          "url": "https://www.mixcloud.com/genres/jazz-dance/"
        },
        {
          "name": "Vocal jazz",
          "slug": "vocal-jazz",
          "url": "https://www.mixcloud.com/genres/vocal-jazz/"
        },
        {
          "name": "Jazz-funk",
          "slug": "jazz-funk",
          "url": "https://www.mixcloud.com/genres/jazz-funk/"
        }
      ],
      "updated_time": "2026-10-20T05:45:02Z",
      "url": "https://www.mixcloud.com/sindicat-del-pop/jazz-session-10-new-york-afternoon/",
      "user_name": "Gen\u00eds Worksong",
      "user_url": "https://www.mixcloud.com/sindicat-del-pop/",
      "username": "sindicat-del-pop"
    }
  ],
  "user": "maxvibes"
}
```

### List user's listens

List the shows a Mixcloud user listened to, most recent first, with when they listened, optionally between two moments. Comes back empty for a user who keeps their listening private.

**Inputs**

- User (`user`, text, required): The Mixcloud username, like 'NTSRadio', or the profile's address, like https://www.mixcloud.com/NTSRadio/.
- Listened after (`listened_after`, date and time): Only listens after this moment.
- Listened before (`listened_before`, date and time): Only listens before this moment.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `shows` (list): The shows listened to, most recent first.
- `user` (text): The username the list is for.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "shows": [
    {
      "audio_length_seconds": 7291,
      "comment_count": 0,
      "created_time": "2025-04-23T07:30:56Z",
      "duration": "2:01:31",
      "favorite_count": 1,
      "hosts": [],
      "key": "/FullMoonRadioLive/dj-graham-gold-fullmoonradiolive-2342025/",
      "listened_time": "2025-04-23T14:50:41Z",
      "listener_count": 10,
      "name": "Dj Graham gold - FullMoonRadio.live 23.4.2025",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/profile/5/e/0/a/4285-d70c-4e99-8d3e-2eb67f50dd63",
      "play_count": 30,
      "repost_count": 0,
      "slug": "dj-graham-gold-fullmoonradiolive-2342025",
      "stats_hidden": false,
      "tags": [
        {
          "name": "Melodic house",
          "slug": "melodic-house",
          "url": "https://www.mixcloud.com/genres/melodic-house/"
        },
        {
          "name": "Progressive house",
          "slug": "progressive-house",
          "url": "https://www.mixcloud.com/genres/progressive-house/"
        },
        {
          "name": "Progressive techno",
          "slug": "progressive-techno",
          "url": "https://www.mixcloud.com/genres/progressive-techno/"
        }
      ],
      "updated_time": "2026-09-14T00:55:47Z",
      "url": "https://www.mixcloud.com/FullMoonRadioLive/dj-graham-gold-fullmoonradiolive-2342025/",
      "user_name": "FullMoonRadio.Live",
      "user_url": "https://www.mixcloud.com/FullMoonRadioLive/",
      "username": "FullMoonRadioLive"
    }
  ],
  "user": "GrahamGold"
}
```

### List user's playlists

List a Mixcloud user's playlists, with each one's key for List playlist shows.

**Inputs**

- User (`user`, text, required): The Mixcloud username, like 'NTSRadio', or the profile's address, like https://www.mixcloud.com/NTSRadio/.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `playlists` (list): The playlists.
- `user` (text): The username the list is for.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "playlists": [
    {
      "key": "/spartacus/playlists/jazz/",
      "name": "Jazz",
      "slug": "jazz",
      "url": "https://www.mixcloud.com/spartacus/playlists/jazz/",
      "user_name": "Spartacus",
      "username": "spartacus"
    }
  ],
  "user": "spartacus"
}
```

### List user's shows

List the shows a Mixcloud user uploaded, newest first, optionally only those uploaded between two moments, with each show's length, tags, play counts and address.

**Inputs**

- User (`user`, text, required): The Mixcloud username, like 'NTSRadio', or the profile's address, like https://www.mixcloud.com/NTSRadio/.
- Uploaded after (`uploaded_after`, date and time): Only shows uploaded after this moment.
- Uploaded before (`uploaded_before`, date and time): Only shows uploaded before this moment.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `shows` (list): The shows, newest first.
- `user` (text): The username the list is for.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "shows": [
    {
      "audio_length_seconds": 2631,
      "comment_count": 1,
      "created_time": "2014-09-10T14:42:03Z",
      "duration": "43:51",
      "favorite_count": 48,
      "hosts": [],
      "key": "/spartacus/cinematic-soundscapes/",
      "listener_count": 385,
      "name": "Cinematic Soundscapes",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/extaudio/1/a/6/1/eaa7-151a-48a9-96f6-12df7773a25d.jpg",
      "play_count": 1475,
      "repost_count": 10,
      "slug": "cinematic-soundscapes",
      "stats_hidden": false,
      "tags": [
        {
          "name": "Chillout",
          "slug": "chillout",
          "url": "https://www.mixcloud.com/genres/chillout/"
        },
        {
          "name": "Soundtrack",
          "slug": "soundtrack",
          "url": "https://www.mixcloud.com/genres/soundtrack/"
        },
        {
          "name": "Modern classical",
          "slug": "modern-classical",
          "url": "https://www.mixcloud.com/genres/modern-classical/"
        }
      ],
      "updated_time": "2026-10-14T22:33:56Z",
      "url": "https://www.mixcloud.com/spartacus/cinematic-soundscapes/",
      "user_name": "Spartacus",
      "user_url": "https://www.mixcloud.com/spartacus/",
      "username": "spartacus"
    }
  ],
  "user": "spartacus"
}
```

### List who favorited a show

List the people who favorited a Mixcloud show, most recent first.

**Inputs**

- Show (`show`, text, required): The show's address on mixcloud.com, like https://www.mixcloud.com/spartacus/party-time/, or its key from an earlier step, like /spartacus/party-time/.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `show` (text): The key of the show the list is for.
- `users` (list): The users who favorited it, most recent first.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "show": "/spartacus/party-time/",
  "users": [
    {
      "key": "/integrationsmixcloud/",
      "name": "integrationsmixcloud",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/defaults/users/v2/5.png",
      "url": "https://www.mixcloud.com/integrationsmixcloud/",
      "username": "integrationsmixcloud"
    }
  ]
}
```

### Search

Search Mixcloud for shows, users or tags by words. Shows come back in 'shows', users in 'users' and tags in 'tags'.

**Inputs**

- Search words (`query`, text, required): What to search for, like a show title, a DJ or a genre.
- Look for (`search_type`, text): Shows, users or tags. Defaults to shows. One of: `cloudcast` (Shows), `user` (Users), `tag` (Tags). Default: `cloudcast`.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the previous step. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many came back.
- `has_more` (true/false): True when Mixcloud has more after these.
- `next_offset` (number): What to put in Skip to get the next page, or empty on the last.
- `query` (text): The words searched for.
- `search_type` (text): What was searched: cloudcast, user or tag.
- `shows` (list): The shows found, for a show search.
- `tags` (list): The tags found, for a tag search.
- `users` (list): The users found, for a user search.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_offset": 1,
  "query": "party time",
  "search_type": "cloudcast",
  "shows": [
    {
      "audio_length_seconds": 14215,
      "comment_count": 0,
      "created_time": "2022-12-23T21:31:58Z",
      "duration": "3:56:55",
      "favorite_count": 11,
      "hosts": [],
      "key": "/pete-maxwell/23rd-december-2022-xmas-party-time-part-1/",
      "listener_count": 15,
      "name": "23rd December 2022 - XMAS PARTY TIME (Part 1)",
      "picture_url": "https://thumbnailer.mixcloud.com/unsafe/600x600/extaudio/4/b/7/0/912a-08c0-4b81-bf97-3c87841aef22",
      "play_count": 44,
      "repost_count": 4,
      "slug": "23rd-december-2022-xmas-party-time-part-1",
      "stats_hidden": false,
      "tags": [
        {
          "name": "Party",
          "slug": "party",
          "url": "https://www.mixcloud.com/genres/party/"
        },
        {
          "name": "Disco",
          "slug": "disco",
          "url": "https://www.mixcloud.com/genres/disco/"
        },
        {
          "name": "Christmas",
          "slug": "christmas",
          "url": "https://www.mixcloud.com/genres/christmas/"
        },
        {
          "name": "Oldies",
          "slug": "oldies",
          "url": "https://www.mixcloud.com/genres/oldies/"
        }
      ],
      "updated_time": "2025-12-15T10:15:43Z",
      "url": "https://www.mixcloud.com/pete-maxwell/23rd-december-2022-xmas-party-time-part-1/",
      "user_name": "DJ Pete Maxwell (UK)",
      "user_url": "https://www.mixcloud.com/pete-maxwell/",
      "username": "pete-maxwell"
    }
  ],
  "tags": [],
  "users": []
}
```
