> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube Channel Details API

> YouTube channel details: subscribers, total views and videos, description, country, join date, verification and social links. By URL, @handle or search.

`POST /v1/data/youtube/channels/run`

**Pricing:** $0.0005 per channel ($0.5 per 1,000).

Look up YouTube channel profiles by channel URL, @handle, or keyword search.

## Ways to call it

* **Channel URL**: set `urls`
* **Search**: set `query`

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**urls** `string[]`

YouTube channel URLs (e.g. [https://www.youtube.com/@MrBeast](https://www.youtube.com/@MrBeast) or [https://www.youtube.com/channel/UC](https://www.youtube.com/channel/UC)...) or @handles.

**query** `string`

Keyword or phrase to search YouTube channels for (e.g. 'tech reviews' or 'cooking'). Returns the full channel profile for each matching channel.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/youtube/channels/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": [
      "https://www.youtube.com/@MrBeast"
    ]
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/youtube/channels/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "urls": [
        "https://www.youtube.com/@MrBeast"
    ]
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/youtube/channels/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "urls": [
    "https://www.youtube.com/@MrBeast"
  ]
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one channel, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `channelName` | Channel Name | text |
| `handle` | Handle | text |
| `channelId` | Channel ID | text |
| `channelUrl` | Channel URL | url |
| `subscribers` | Subscribers | number |
| `totalViews` | Total Views | number |
| `totalVideos` | Total Videos | number |
| `avgViewsPerVideo` | Avg Views per Video | number |
| `description` | Description | text |
| `country` | Country | text |
| `joinedDate` | Joined Date | text |
| `joinedYear` | Joined Year | number |
| `verified` | Verified | boolean |
| `hasVideos` | Has Videos | boolean |
| `avatarUrl` | Avatar URL | url |
| `bannerUrl` | Banner URL | url |
| `instagramUrl` | Instagram URL | url |
| `twitterXUrl` | Twitter / X URL | url |
| `tiktokUrl` | TikTok URL | url |
| `websiteUrl` | Website URL | url |
| `links` | Links | object\_array |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "youtube/channels",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "channelUrl": "https://www.youtube.com/channel/UCrM7B7SL_g1edFOnmj-SDKg",
      "websiteUrl": "https://www.bloomberg.com/btv/series/bloomberg-technology",
      "hasVideos": true,
      "totalViews": 178990368,
      "instagramUrl": null,
      "totalVideos": 14032,
      "joinedYear": 2016,
      "country": null,
      "joinedDate": "Sep 1, 2016",
      "avgViewsPerVideo": 12756,
      "bannerUrl": "https://yt3.googleusercontent.com/g6t81UxyHa0T3q-HT0Dw5OJsOUENAXKIL3WzWEymMPphLY9yG45Q_rX9LxV9XfyG1i4XDPIzei4=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-...",
      "twitterXUrl": "https://x.com/technology?lang=en",
      "description": "Welcome to the Bloomberg Tech YouTube channel. Subscribe to see the latest videos on game-changing technologies, profiles on innovators, live conversations w...",
      "channelName": "Bloomberg Tech",
      "subscribers": 736000,
      "links": [
        {
          "title": "Bloomberg Technology TV",
          "url": "https://www.bloomberg.com/btv/series/bloomberg-technology"
        },
        {
          "title": "Bloomberg Technology",
          "url": "https://www.bloomberg.com/technology"
        }
      ],
      "verified": false,
      "avatarUrl": "https://yt3.googleusercontent.com/JrVD7EseOyOiGrgN4-2HQjuP7m6LHL5Cb-XBo0SCRO020W0bQ4W8Sve522ellwQ77_A5JapEKQ=s68-c-k-c0x00ffffff-no-rj",
      "channelId": "UCrM7B7SL_g1edFOnmj-SDKg",
      "tiktokUrl": null,
      "handle": "BloombergTech"
    }
  ]
}
```

## Related APIs

For the channel's videos use [`youtube/videos`](https://docs.mindcase.co/apis/youtube/videos); for community tab posts use [`youtube/community-posts`](https://docs.mindcase.co/apis/youtube/community-posts).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.