YouTube Channel Details API
Fetch YouTube profile data — follower counts, bio, verification, and stats.
GET request to /v1/youtube/channel-details that responds with clean JSON, costs 1 credit, and is cached for 24 hours (repeat calls are free). Start with 100 free credits — no credit card.What is the YouTube Channel Details API?
The YouTube Channel Details API lets you fetch profile/channel details and audience stats from YouTube with a single REST call. No OAuth, no scraping infrastructure, and no platform SDKs — send the URL, get clean structured JSON back. Results are cached for 24 hours, so repeat lookups are instant and free.
What you get
- Display name, handle, bio, and avatar
- Follower / subscriber and content counts
- Verification status and external links
- Aggregate engagement signals
Try it
Fill in the parameters below and copy a ready-to-run request in your language of choice.
Parameters
curl "https://api.captapi.com/v1/youtube/channel-details?url=https%3A%2F%2Fwww.youtube.com%2F%40MrBeast" \
-H "Authorization: Bearer capt_live_..."Edit the parameters and the code updates instantly. Switch languages and hit copy.
Example response
{
"success": true,
"data": {
"url": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
"id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"name": "MrBeast",
"handle": "MrBeast",
"description": "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\nTerms & Conditions of Current Sweepstakes: \nhttps://mrb.gg/bow-and-arrow\nhttps://bit.ly/MrB_Birthday_YT\nhttps://bit.ly/MrB_Cash_Giveaway",
"subscriberCount": 506000000,
"videoCount": 990,
"viewCount": 132105462901,
"thumbnailUrl": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s68-c-k-c0x00ffffff-no-rj",
"bannerUrl": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
"country": "United States",
"joinedDate": "Feb 19, 2012",
"verified": true,
"links": [
{
"text": "Follow",
"url": "https://www.instagram.com/mrbeast/"
},
{
"text": "Twitter",
"url": "https://twitter.com/MrBeast"
},
{
"text": "Facebook",
"url": "https://facebook.com/mrbeast/"
}
]
}
}Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.
Response structure
A successful call returns success, cached, creditsUsed, and a data object with the following fields:
Profile
handleProfile / channel handle.nameDisplay name.bioProfile bio or description.verifiedWhether the account is verified.
Stats
followersFollower / subscriber count.postsTotal number of posts / videos.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | YouTube channel URL, @handle, bare handle, or UC... channel ID, e.g. https://youtube.com/@handle or @mkbhd. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble. |
Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 1 credit. Repeat calls for the same request are served from cache for free.
youtube_channel_details via @captapi/mcp. Set it up →How it works
- 1. Sign up — get 100 free credits, no card required.
- 2. Create a key from your dashboard.
- 3. Send one request to
/v1/youtube/channel-detailsand parse the JSON response.
Use cases
Influencer Discovery
Find and vet creators by audience size.
CRM Enrichment
Add social stats to your contact profiles.
Competitive Analysis
Track follower growth and posting cadence.
Outreach
Qualify partnership and sponsorship targets.
Frequently asked questions
What does the YouTube Channel Details API do?+
The YouTube Channel Details API lets you fetch profile/channel details and audience stats from a public YouTube profile using one GET request to /v1/youtube/channel-details. It returns clean JSON — no OAuth or scraping setup required.
How many credits does the YouTube Channel Details API cost?+
Each successful call costs 1 credit. Responses are cached for 24 hours, and cached results cost 0 credits. Failed or empty results are never charged.
Do I need a YouTube API key or OAuth?+
No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, and Rumble. We handle proxies, rate limits, retries, and authentication for you.
Is the YouTube Channel Details API suitable for production use?+
Yes. It is a stable REST endpoint with predictable JSON, automatic retries, and a shared 24-hour cache. Use it for RAG pipelines, analytics, monitoring, and content automation.
More YouTube APIs
Ready to use the YouTube Channel Details API?
Sign up, grab your key, and make your first call in 60 seconds.