Mixcloud

About Mixcloud

The Mixcloud API provides read access to shows, users, tags and city objects without authentication, and OAuth 2.0-authorized write access for actions such as following users, favoriting or reposting shows, adding shows to Listen Later, uploading and editing shows, and acting on behalf of a logged-in listener. Objects are addressed by converting their mixcloud.com URL to an api.mixcloud.com URL, and responses are returned as JSON with CORS support (JSONP is also available via a callback parameter). The API includes search across shows, users and tags, connection metadata for discovering related resources, and paging support using limit/offset or date-based since/until parameters.

Authentication for write operations follows a browser-based OAuth 2.0 flow: an application is registered to obtain a client_id and client_secret, the user is redirected to an authorize endpoint, and the returned code is exchanged for an access token. The documentation covers rate limits, audio streams, deep linking, and a separate Widget JavaScript API for controlling an embedded player rather than calling the REST API directly.

This is intended for developers building applications or integrations that read Mixcloud content (shows, users, tags) or perform actions on behalf of a Mixcloud user, such as uploading shows, managing follows/favorites/reposts, or embedding playback.

Key features

• REST API to read shows, users, tags and cities with no authentication required
• OAuth 2.0 authorization for write actions performed on behalf of a listener
• Follow, favorite, repost and Listen Later endpoints for users and shows
• Search endpoint for shows, users and tags via /search/
• Upload and edit shows through the API
• Embeddable widget with a separate JavaScript API for player control

Frequently asked questions