Skip to content
truescrape
Free key

Contents

Site

YouTube Channel API

Open in ChatGPTOpen in ClaudeOpen in Gemini

Public details for a YouTube channel: subscribers, video count, description, links. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.

Try it

Prefilled with the request that produced the example below. No key yet? Get a free key.

Request

GET/v1/youtube/channel
ParameterTypeRequiredDescription
handlestringyesHandle (@mrbeast), channel id (UC...), or full URL

Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).

curl
curl "$API/v1/youtube/channel?handle=%40MrBeast&cache_max_age=7d" \
  -H "x-api-key: $KEY"
JavaScript
const query = new URLSearchParams({
  handle: '@MrBeast',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/youtube/channel?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);
Python
import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/youtube/channel",
    params={
        "handle": "@MrBeast",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Example response

Captured on , with raw removed and lists cut to two items. A live call returns current data.

response
{
  "success": true,
  "data": {
    "platform": "youtube",
    "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
    "handle": "MrBeast",
    "displayName": "MrBeast",
    "bio": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000,000 Trees\n- Removed 30,000,000 pounds of trash from the ocean\n- Helped 2,000 people walk again\n- Helped 1,000 blind people see\n- Helped 1,000 deaf people hear\n- Built wells in Africa\n- Built and gave away 100 houses\n- Adopted every dog in a shelter (twice)\n- Given millions to charity\n- Started my own snack company Feastables\n- Started my own software company Viewstats\n- Gave away a private island (twice)\n- Gave away 1 million meals\n- I counted to 100k\n- Ran a marathon in the world's largest shoes\n- Survived 50 hours in Antarctica\n- Recreated Squid Game in real life\n- Created the largest competition show with 1000 people (Beast Games)\n- Gave $5,000,000 to one person\n- Raised $40,000,000 To Bring Clean Water To Millions Of People\n- Granted 100+ Dream Wishes for Kids Fighting Cancer\n- Gave Away Another $5,000,000 On Beast Games S2\n",
    "avatarUrl": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj",
    "bannerUrl": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
    "url": "http://www.youtube.com/@MrBeast",
    "verified": true,
    "followerCount": 522000000,
    "followingCount": null,
    "postCount": 1008,
    "viewCount": 143605351979,
    "isPrivate": false,
    "isBusiness": null,
    "category": null,
    "location": "United States",
    "externalLinks": [
      "https://www.themostdangerousgames.com/",
      "https://www.instagram.com/mrbeast/"
    ],
    "createdAt": "2012-02-19T00:00:00.000Z",
    "fetchedAt": "2026-10-21T01:55:24.237Z"
  },
  "meta": {
    "platform": "youtube",
    "endpoint": "youtube.channel",
    "creditsCharged": 1,
    "cached": false,
    "cacheAgeSeconds": null,
    "durationMs": 284,
    "requestId": "req_pcfyk5dg1yu89of6f6r1"
  }
}

Returns

Returns one Creator.

Cost and behaviour

Credits1 per live request, 0 on a cache hit
Cacheableyes: cache_max_age accepts a cached copy
Batchableyes: usable as a target in POST /v1/jobs/batch
Subscribableyes: as often as every 3600 seconds, firing a webhook only on a change

Other YouTube endpoints

All YouTube endpointsThe unified schema