Mixcloud API

Music / OAuth Advanced HTTPS CORS
Varies by plan (check documentation)

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.

Available Data

track name and artist
album metadata
audio preview URLs
popularity score
genre classification
Use case: Integrate music data into web and mobile applications

Example Response

JSON Response
{
  "name": "Bohemian Rhapsody",
  "artist": "Queen",
  "album": "A Night at the Opera",
  "duration_ms": 354000,
  "popularity": 92,
  "preview_url": "https://p.scdn.co/mp3-preview/..."
}

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.
audio_length Duration of the audio in seconds.

Implementation Example

const url = "https://www.mixcloud.com/developers/";
// 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.

Common Errors & Troubleshooting

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.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 8/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS YES
Category Music
Difficulty Advanced
Verified: 2026-04-04

Similar APIs

View All →