Mixcloud API

Music / OAuth Advanced HTTPS CORS
57 C
Measured Score 0 50 100 Speed 7/30 Consistency 20/20 Security 20/20 Browser access 10/15 Transparency 0/15 TESTED 2026-08-10

Overview

The Mixcloud API lets you access DJ mixes, radio shows, and podcast data from Mixcloud's platform. You can browse shows by artist, retrieve track listings, and manage user-uploaded audio content. It uses OAuth 2.0, so beginners should start with public endpoints before exploring authenticated features.

Beginner Tip

Start with public read endpoints (e.g., fetching a user's cloudcasts) without OAuth first, then add authentication when you need to act on behalf of a user.

Measurement Record

What actually happened when we called this API from our own infrastructure. Every value below was recorded by the request, not copied from the provider's documentation.

Request
GET https://api.mixcloud.com/NTSRadio/cloudcasts/?limit=5
Result
HTTP 200 · text/javascript · 22,252 bytes
Response time
473 ms (median of 3) · fastest 463 ms
Transport
TLSv1.3 · TLS_AES_256_GCM_SHA384 · certificate issued by Let's Encrypt
Browser CORS
Allowed — Access-Control-Allow-Origin: https://apisscore.com
Recorded
2026-08-10

Fields Returned

Top-level fields present in the response we captured, with the type and value we actually received.

Field Type Value received
key string /NTSRadio/tough-matter-w-myna-9th-august-2026/
url string (url) https://www.mixcloud.com/NTSRadio/tough-matte…
name string Tough Matter w/ MYNA - 9th August 2026
tags array [1 item]
created_time string (date) 2026-08-10T16:30:41Z
updated_time string (date) 2026-08-10T19:44:01Z
play_count integer 0
favorite_count integer 0
comment_count integer 0
listener_count integer 0
repost_count integer 0
pictures object {1 fields}
slug string tough-matter-w-myna-9th-august-2026
user object {1 fields}

Captured Response

Captured from a real request to https://api.mixcloud.com/NTSRadio/cloudcasts/?limit=5 on 2026-08-10. Long arrays and nested objects are truncated to keep the shape readable.

JSON Response · Captured
{
  "data": [
    {
      "key": "/NTSRadio/tough-matter-w-myna-9th-august-2026/",
      "url": "https://www.mixcloud.com/NTSRadio/tough-matter-w-myna-9th-august-2026/",
      "name": "Tough Matter w/ MYNA - 9th August 2026",
      "tags": [
        {
          "…": "(3 more fields)"
        }
      ],
      "created_time": "2026-08-10T16:30:41Z",
      "updated_time": "2026-08-10T19:44:01Z",
      "play_count": 0,
      "favorite_count": 0,
      "comment_count": 0,
      "listener_count": 0,
      "repost_count": 0,
      "pictures": {
        "…": "(10 more fields)"
      },
      "slug": "tough-matter-w-myna-9th-august-2026",
      "user": {
        "…": "(5 more fields)"
      },
      "…": "(3 more fields)"
    }
  ],
  "paging": {
    "next": "https://api.mixcloud.com/NTSRadio/cloudcasts/?limit=5&until=2026-08-10+16%3A04%3A11",
    "previous": "https://api.mixcloud.com/NTSRadio/cloudcasts/?limit=5&since=2026-08-10+16%3A30%3A41"
  },
  "name": "Mixcloud NTS Radio's Cloudcasts"
}

Field Reference

key Unique path identifier for the cloudcast, e.g. "/DJName/show-title/".
name Display title of the cloudcast or show.
url Full public URL to the cloudcast page on Mixcloud.
created_time Timestamp when the cloudcast was uploaded.
play_count Total number of times this cloudcast has been played.

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "https://api.mixcloud.com/NTSRadio/cloudcasts/?limit=5";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

How This API Fails

We deliberately sent this API a broken request and recorded exactly what came back on 2026-08-10. Knowing the shape of an error before you hit it makes error handling much easier to write.

HTTP 404 Requesting a path that does not exist text/javascript
{
  "error": {
    "type": "ResourceNotFoundException",
    "message": "Resource not found."
  }
}

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

401 Unauthorized Accessing a protected endpoint without a valid OAuth token.
Complete the OAuth 2.0 flow to obtain an access token and include it in the Authorization header.
429 Too Many Requests Exceeding the rate limit for the API.
Add delays between requests and cache responses locally to reduce the number of API calls.
Empty cloudcasts array The user has no public uploads or the username is misspelled.
Double-check the username slug in the URL; Mixcloud slugs are lowercase and hyphen-separated.

Measured Score Breakdown

Live HTTP request to the API endpoint

Speed 7/30
Consistency 20/20
Security 20/20
Browser access 10/15
Transparency 0/15
Endpoint Response Time 473ms

Fully tested on Aug 10, 2026

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS YES
Category Music
Difficulty Advanced
Endpoint last called: 2026-08-10

Related Tags

Similar APIs

View All →