# Mixcloud Tag API Documentation

<p><strong>Mixcloud Tag API</strong> returns the popular or latest cloudcasts for one Mixcloud genre tag. Each item carries the cloudcast key, name, username, public url, play count, favorite count, and created time. Results are paginated with offset-based paging. A valid empty result is a successful response. An unknown tag returns a non-billable 404. Play and favorite counts are omitted for cloudcasts whose owner hides stats.</p>

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

## 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 |
| --- | --- | --- | --- |
| `tag` | string | Yes | Mixcloud genre tag. Example: techno or funk. |
| `sort` | string | No | Sort order: popular or latest. Defaults to popular. |
| `limit` | integer | No | Maximum number of results per page. Defaults to 20. |
| `offset` | integer | No | Result offset for paging. Defaults to 0. |

## Example response

```json
{
    "data": {
        "cloudcasts": [
            {
                "key": "/AK729/%E7%89%B9%E5%88%AB%E7%8B%AC%E5%AE%B6%E8%87%AA%E7%94%A8/",
                "url": "https://www.mixcloud.com/AK729/%E7%89%B9%E5%88%AB%E7%8B%AC%E5%AE%B6%E8%87%AA%E7%94%A8/",
                "name": "AK\u300a\u81ea\u7528\u4e32\u70e7Prv V6\u300b\u300a\u5f53\u8349\u6212\u6307\u9047\u4e0a\u9a97\u5b50\u4f1a\u64e6\u51fa\u4ec0\u4e48\u706b\u82b1\uff1f\u300b\u300a\u8349\u6212\u6307X\u9a97\u5b50 X Y Que FueX\u8ff7\u5e7b\u795e\u4ed9\u6c34 X \u5348\u591cDJX\u7535\u97f3\u4e4b\u738b X \u7b11\u67c4\u300b\u300a\u72ec\u5bb6\u4e32\u70e72026\u300b",
                "username": "AK729",
                "play_count": 23433,
                "created_time": "2026-05-25T19:52:38Z",
                "favorite_count": 1427
            },
            {
                "key": "/AK729/7726-prv-v3/",
                "url": "https://www.mixcloud.com/AK729/7726-prv-v3/",
                "name": "AK\u300a77\u00b2\u2076 PRV V3\u300b\u300a\u6b22\u8fce\u56de\u5230\u6cf0\u56fd\u7cfb\u5217 \u70ed\u70c8\u5f15\u7206\u0e1a\u0e31\u0e01\u0e04\u0e19\u0e0b\u0e31\u0e48\u0e27 - \u0e17\u0e34\u0e14\u0e41\u0e2d\u0e21\u300b\u300aABC LOVE X \u0e17\u0e34\u0e14\u0e41\u0e2d\u0e21 X Rak Ther Mai Mee\u300b\u300a\u72ec\u5bb6\u5feb\u6447\u4e32\u70e72026\u300b",
                "username": "AK729",
                "play_count": 19307,
                "created_time": "2026-07-15T18:10:51Z",
                "favorite_count": 1261
            }
        ],
        "pagination": {
            "limit": 2,
            "offset": 2,
            "has_more": true,
            "next_cursor": "2"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "tag"
    },
    "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 tag 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)