Search Mixcloud. type: 'cloudcast' (shows), 'user' or 'tag'.

Fetch any object by key or Mixcloud URL: show '/spartacus/party-time/', user '/spartacus/', tag '/genres/funk/', city '/genres/city:athens/'. metadata=True adds the list of available connections. authenticated=True sends the token so objects gain extra fields (e.g. 'following').

Get a show by key, e.g. '/spartacus/party-time/'.

Get a user profile by key, e.g. '/spartacus/'.

Get a tag/genre ('funk'), a city ('athens'), or both ('funk' + 'athens').

List a connection of an object, e.g. key='/spartacus/' with connection 'followers' | 'following' | 'favorites' | 'cloudcasts' | 'listens'. Use key='/me/' with authenticated=True for the token owner's own lists. since/until: Unix timestamp or 'YYYY-MM-DD HH:MM:SS' (UTC), for dated lists.

List a user's shows. key: '/spartacus/'.

Site-wide lists: popular, hot or new shows.

Shows of a tag/genre. Looks the list up in the tag's own connections (metadata=1), so list_name must be one the tag offers; the error lists them.

Embed code (HTML) for a show's player widget. color: 6-digit hex, no '#'.

oEmbed data for a Mixcloud show URL (https://www.mixcloud.com/...).

The authorized user's own profile (/me/).

Follow a user ('/spartacus/'); undo=True unfollows.

Favorite a show ('/spartacus/party-time/'); undo=True removes it from favorites.

Repost a show; undo=True removes the repost.

Add a show to Listen Later; undo=True removes it.

Upload a show. Files must be inside the upload directory (relative paths resolve there). mp3 up to 4 GB, picture up to 10 MB, description up to 1000 chars, up to 5 tags. sections: [{'chapter': 'Intro', 'start_time': 0}, {'artist': 'A', 'song': 'S', 'start_time': 10}]. unlisted defaults to True (private link only) for safety; set unlisted=False to publish publicly. publish_date (UTC, 2030-11-21T14:05:00Z), disable_comments, hide_stats and hosts (max 2 usernames) are Pro-only.

Edit one of your shows (key '/me-user/my-upload/'). Omitted fields stay unchanged, EXCEPT tags, sections and hosts, which are replaced wholesale: re-send the existing ones when adding. hosts=[] removes all hosts. visibility: 'unlisted' (private link), 'publish' (make public, also for drafts) or 'unpublish' (move to drafts); only one per request.

Step 1 of OAuth: URL the user must open in a browser to allow access. Without redirect_uri, Mixcloud shows the code on screen; with it, the code arrives as ?code=... on that URL. Then call exchange_code(code).

Step 2 of OAuth: exchange the code for an access token. The token is kept in this server (and saved to the env file); it is not shown to you.

Check that the current token works (calls /me/).

Forget the token in this server (and optionally delete it from the env file). This does not revoke it on Mixcloud: the API docs describe no revoke endpoint, the user revokes access on Mixcloud's side.