Skip to content
Scrappa Get API key
Mixcloud API 1 credit/request

Mixcloud User Uploads API Documentation

GET https://scrappa.co/api/mixcloud/user/uploads

Mixcloud User Uploads API returns the cloudcasts (shows/mixes) uploaded by one Mixcloud user. Each item carries the cloudcast key, name, username, public url, play count, favorite count, and created time. Results are paginated with date-cursor paging (default) or offset paging. A valid empty result is a successful response. An unknown username returns a non-billable 404. Play and favorite counts are omitted for cloudcasts whose owner hides stats.

Mixcloud User Uploads API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/mixcloud/user/uploads
Auth header
x-api-key
Cost
1 credit/request
username = example
Response preview
200 OK
{
    "data": {
        "cloudcasts": [
            {
                "key": "/TechnoClubNet/duckie-oct-3-2026-techno-clubnet/",
                "url": "https://www.mixcloud.com/TechnoClubNet/duckie-oct-3-2026-techno-clubnet/",
                "name": "'DUCKIE - Oct 3, 2026 - techno-club.net'",
                "username": "TechnoClubNet",
                "created_time": "2026-10-09T23:35:37Z"
            },
            {
                "key": "/TechnoClubNet/temudo-oct-3-2026-techno-clubnet/",
                "url": "https://www.mixcloud.com/TechnoClubNet/temudo-oct-3-2026-techno-clubnet/",
                "name": "'TEMUDO - Oct 3, 2026 - techno-club.net'",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

3 optional filters available.

username string Required

Mixcloud username. Example: TechnoClubNet.

Example value example
limit integer Optional

Maximum number of cloudcasts per page. Defaults to 20.

Example value 10
until string Optional

Date cursor for paging (ISO timestamp). Pass the next_cursor from the previous response.

Example value example
offset integer Optional

Offset for paging. Pass the next_cursor from the previous response.

Example value 10

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "cloudcasts": [
            {
                "key": "/TechnoClubNet/duckie-oct-3-2026-techno-clubnet/",
                "url": "https://www.mixcloud.com/TechnoClubNet/duckie-oct-3-2026-techno-clubnet/",
                "name": "'DUCKIE - Oct 3, 2026 - techno-club.net'",
                "username": "TechnoClubNet",
                "created_time": "2026-10-09T23:35:37Z"
            },
            {
                "key": "/TechnoClubNet/temudo-oct-3-2026-techno-clubnet/",
                "url": "https://www.mixcloud.com/TechnoClubNet/temudo-oct-3-2026-techno-clubnet/",
                "name": "'TEMUDO - Oct 3, 2026 - techno-club.net'",
                "username": "TechnoClubNet",
                "created_time": "2026-10-09T23:31:19Z"
            },
            {
                "key": "/TechnoClubNet/marco-bailey-oct-3-2026-techno-clubnet/",
                "url": "https://www.mixcloud.com/TechnoClubNet/marco-bailey-oct-3-2026-techno-clubnet/",
                "name": "'MARCO BAILEY - Oct 3, 2026 - techno-club.net'",
                "username": "TechnoClubNet",
                "created_time": "2026-10-09T23:29:32Z"
            }
        ],
        "pagination": {
            "limit": 3,
            "has_more": true,
            "next_cursor": "2026-10-09 23:29:32"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "user_uploads"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required parameter is missing or a parameter failed validation.

{
    "errors": {
        "username": [
            "The username field is required."
        ]
    },
    "message": "The request validation failed"
}
404

Mixcloud Not Found

The requested Mixcloud user does not exist.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "user_uploads"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "Mixcloud object not found."
    },
    "success": false
}
503

Mixcloud Upstream Unavailable

Mixcloud could not be reached within the full attempt budget.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "user_uploads"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "Mixcloud upstream is temporarily unavailable."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.