# Mixcloud User API Documentation

<p><strong>Mixcloud User API</strong> returns the public profile of one Mixcloud user: username, name, biography in HTML and plain text, follower count, following count, cloudcast count, favorite count, listen count, Pro and Premium flags, city, country, public url, pictures and cover pictures (width, height and url), created time, and updated time. An unknown username returns a non-billable 404.</p>

- **Documentation:** [https://scrappa.co/docs/mixcloud-api/mixcloud_user](https://scrappa.co/docs/mixcloud-api/mixcloud_user)
- **API group:** Mixcloud API
- **Endpoint:** `GET https://scrappa.co/api/mixcloud/user`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `username` | string | Yes | Mixcloud username. Example: TechnoClubNet. |

## Example response

```json
{
    "data": {
        "user": {
            "url": "https://www.mixcloud.com/TechnoClubNet/",
            "city": "Luxembourg",
            "name": "techno-club.net",
            "is_pro": true,
            "country": "Luxembourg",
            "pictures": [
                {
                    "url": "https://thumbnailer.mixcloud.com/unsafe/25x25/profile/9/7/0/3/6ccc-2268-44b2-b58c-a15df83ff2b3",
                    "width": 25,
                    "height": 25
                },
                {
                    "url": "https://thumbnailer.mixcloud.com/unsafe/50x50/profile/9/7/0/3/6ccc-2268-44b2-b58c-a15df83ff2b3",
                    "width": 50,
                    "height": 50
                },
                {
                    "url": "https://thumbnailer.mixcloud.com/unsafe/80x80/profile/9/7/0/3/6ccc-2268-44b2-b58c-a15df83ff2b3",
                    "width": 80,
                    "height": 80
                }
            ],
            "username": "TechnoClubNet",
            "biography": "Live streaming every weekend @Mixcloud - https://www.mixcloud.com/live/TechnoClubNet/\nWe will be featuring the world's best Techno, Electro & House DJ's and LIve performances. \nNew shows every Friday & Saturday, check https://techno-club.net for latest schedules and flyers.",
            "is_premium": false,
            "created_time": "2020-05-10T07:07:26Z",
            "listen_count": 7,
            "updated_time": "2020-05-10T07:07:26Z",
            "cover_pictures": [
                {
                    "url": "https://thumbnailer.mixcloud.com/unsafe/835x120/profile_cover/7/2/0/f/e3e9-f3d0-4e1a-bfde-d83453a84271",
                    "width": 835,
                    "height": 120
                },
                {
                    "url": "https://thumbnailer.mixcloud.com/unsafe/1113x160/profile_cover/7/2/0/f/e3e9-f3d0-4e1a-bfde-d83453a84271",
                    "width": 1113,
                    "height": 160
                },
                {
                    "url": "https://thumbnailer.mixcloud.com/unsafe/1670x240/profile_cover/7/2/0/f/e3e9-f3d0-4e1a-bfde-d83453a84271",
                    "width": 1670,
                    "height": 240
                }
            ],
            "favorite_count": 6,
            "follower_count": 3361,
            "biography_plain": "Live streaming every weekend @Mixcloud - https://www.mixcloud.com/live/TechnoClubNet/\nWe will be featuring the world's best Techno, Electro & House DJ's and LIve performances. \nNew shows every Friday & Saturday, check https://techno-club.net for latest schedules and flyers.",
            "cloudcast_count": 1625,
            "following_count": 1667
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "user"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter is missing or a parameter failed validation. |
| 404 | Mixcloud Not Found | The requested Mixcloud user does not exist. |
| 503 | Mixcloud Upstream Unavailable | Mixcloud could not be reached within the full attempt budget. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)