# Mixcloud Cloudcast API Documentation

<p><strong>Mixcloud Cloudcast API</strong> returns the full public record of one Mixcloud cloudcast (show/mix): name, description in HTML and plain text, username, duration in seconds, play count, favorite count, repost count, comment count, listener count, created time, public url, tags (slug and name), and pictures (width, height and url). Counts are omitted when the owner hides stats. Stream and audio download URLs are never returned. An unknown cloudcast key returns a non-billable 404.</p>

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

## 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 |
| --- | --- | --- | --- |
| `key` | string | Yes | Mixcloud cloudcast key in /user/slug/ format. Example: /spartacus/party-time/. |

## Example response

```json
{
    "data": {
        "cloudcast": {
            "key": "/spartacus/party-time/",
            "url": "https://www.mixcloud.com/spartacus/party-time/",
            "name": "Party Time",
            "tags": [
                {
                    "name": "Funky house",
                    "slug": "funky-house"
                },
                {
                    "name": "Funk",
                    "slug": "funk"
                },
                {
                    "name": "Soul",
                    "slug": "soul"
                }
            ],
            "pictures": [
                {
                    "url": "https://thumbnailer.mixcloud.com/unsafe/25x25/extaudio/6/1/a/1/279f-e3c0-4871-aa8e-c4cf5466edb8.png",
                    "width": 25,
                    "height": 25
                },
                {
                    "url": "https://thumbnailer.mixcloud.com/unsafe/50x50/extaudio/6/1/a/1/279f-e3c0-4871-aa8e-c4cf5466edb8.png",
                    "width": 50,
                    "height": 50
                },
                {
                    "url": "https://thumbnailer.mixcloud.com/unsafe/80x80/extaudio/6/1/a/1/279f-e3c0-4871-aa8e-c4cf5466edb8.png",
                    "width": 80,
                    "height": 80
                }
            ],
            "username": "spartacus",
            "play_count": 9756,
            "description": "Given I'm on the Mixcloud team, I thought I really should have something up here.  Here's an hour's worth of funky music to get you ready for partying, enjoy the music and ignore the quality (or lack thereof) of the DJ!",
            "created_time": "2009-08-02T16:55:01Z",
            "repost_count": 9,
            "comment_count": 5,
            "favorite_count": 39,
            "listener_count": 303,
            "duration_seconds": 3361,
            "description_plain": "Given I'm on the Mixcloud team, I thought I really should have something up here.  Here's an hour's worth of funky music to get you ready for partying, enjoy the music and ignore the quality (or lack thereof) of the DJ!"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "cloudcast"
    },
    "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 cloudcast 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)