# Mixcloud DJ Mixes and Radio Shows API

> Mixcloud: search DJ mixes, radio shows and creators, and a creator's uploads with plays and tags

- Vendor: `mixclouddjmixesandradioshowsap` · version 1.0 · category Music · tags mixcloud api, dj mixes api, radio shows api, podcasts api, music creators api, mixes search api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/mixclouddjmixesandradioshowsap
- This document: https://apiclay.com/docs/mixclouddjmixesandradioshowsap.md
- OpenAPI 3.1: https://apiclay.com/api/mixclouddjmixesandradioshowsap/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `mixclouddjmixesandradioshowsap`
- Updated: 2026-11-18

## About

## Mixcloud DJ Mixes and Radio Shows API

The public API of Mixcloud, the platform for DJ mixes and radio shows: search uploads (cloudcasts), creators or tags by keyword, each upload with name, creator, tags, length, play, favourite and repost counts, dates and artwork; and a creator's uploads newest first, paged by date.

Data comes from **mixcloud.com** (https://www.mixcloud.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/search?q=house&amp;type=cloudcast&amp;limit=10`, then `/uploads?user=&amp;limit=10`.

### Routes

#### GET `/search` - Search
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | yes | Keywords, e.g. `house`. |
| type | query | string | yes | `cloudcast`, `user` or `tag`. |
| limit | query | number | no | Results per page, up to 100. |
| offset | query | number | no | Results to skip. |

Returns: `data`: uploads with `key`, `url`, `name`, `user` (`username`, `name`), `tags`, `audio_length`, `play_count`, `favorite_count`, `repost_count`, `created_time`, `updated_time`, `pictures`; `paging.next`.

#### GET `/uploads` - Creator uploads
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| user | path | string | yes | Creator `username`, e.g. `spartacus`. |
| limit | query | number | no | Uploads per page. |
| until | query | string | no | Date from `paging.next`, for the next page. |

Returns: `data` as in `/search`, `paging` (`next`, `previous`), `name`.

### Caveats

- Creators are listed by their public username and display name.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by mixcloud.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Search
- Gateway: `GET https://api.apiclay.com/v1/api/mixclouddjmixesandradioshowsap/search`
- Public query params: `q` (string, required), `type` (string, required), `limit` (number), `offset` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /uploads — Creator uploads
- Gateway: `GET https://api.apiclay.com/v1/api/mixclouddjmixesandradioshowsap/uploads`
- Public query params: `limit` (number), `until` (string), `user` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/mixclouddjmixesandradioshowsap/search?q=<q>&type=<type>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
