YouTube Channel Stats Scraper

Get YouTube channel statistics as structured JSON. Subscribers, total views, video count, description, verified status, join date and social links — no login, no YouTube Data API key, no quota.

What it does

Takes one YouTube channel URL and returns one dataset row of channel metadata. No pagination — one input, one record.

Accepts any channel URL form: youtube.com/@handle, youtube.com/channel/UC…, youtube.com/c/Name.

Input

Field	Type	Required	Default	Description
url	string	yes	—	Channel URL or @handle

{ "url": "https://www.youtube.com/@mkbhd" }

Output

One row.

{
  "id": "UCBJycsmduvYEL83R_U4JriQ",
  "handle": "@mkbhd",
  "url": "https://www.youtube.com/@mkbhd",
  "title": "Marques Brownlee",
  "description": "Quality Tech Videos…",
  "counts": { "subscribers": 20100000, "videos": 1682, "totalViews": 4600000000 },
  "verified": true,
  "joinedAt": "2008-03-21T00:00:00.000Z",
  "socialLinks": ["https://x.com/mkbhd", "https://www.instagram.com/mkbhd"],
  "avatarUrl": "https://yt3.googleusercontent.com/…"
}

Field	Type	Notes
id	string	Channel id (UC…)
handle	string	Channel @handle
url	string	Canonical channel URL
title	string	Channel display name
description	string	Channel description
counts	object	subscribers, videos, totalViews
verified	boolean	Verified badge
joinedAt	string	ISO 8601 channel creation date
socialLinks	array	Links listed on the channel page
avatarUrl	string	Channel avatar URL

Freshness

Channel figures are cached for up to 24 hours. Subscriber and view counts move over days, not minutes, so a day-old figure is still a correct answer — and re-fetching hourly would cost you money for noise.

What it does not do

• No video list. Use the YouTube Channel Videos Scraper for uploads.
• Subscriber counts are rounded by YouTube itself above 1,000. A channel showing "20.1M" genuinely does not publish a finer number; anything claiming an exact figure is inventing precision.
• One channel per run.
• No demographics or revenue. YouTube publishes neither.

Pricing

Charged per channel. One run, one charge. Failed runs charge nothing.

Errors

Code	Meaning
BAD_REQUEST	Input missing, malformed, or not a URL this actor serves
NOT_FOUND	The target is private, removed, or does not exist
UNSUPPORTED_OPERATION	The URL resolved to a platform this actor does not serve
UPSTREAM_FAILED	Every upstream source failed — retry shortly
RATE_LIMITED	Too many requests; back off and retry
TIMEOUT	The source took longer than the actor's budget
UNAUTHORIZED	The actor's API credentials are invalid — contact the author
INSUFFICIENT_CREDITS	The account behind this actor is out of credits — contact the author
INTERNAL_ERROR	Unexpected failure

UNAUTHORIZED and INSUFFICIENT_CREDITS are on us, not you. If you see either, the actor is misconfigured on our side.

How it works

Three independent upstream sources serve this operation. If one is down or returns nothing usable, the next is tried inside the same run — no double charge, no retry on your side.

FAQ

Do I need a YouTube API key? No.

How fresh are subscriber counts? Up to 24 hours old. See Freshness above.

Why is the subscriber count rounded? YouTube itself rounds public counts above 1,000.

Can I pass a video URL? No — pass the channel. Use the YouTube Video Data Scraper for videos.

Can I get the channel's videos? Yes, with the YouTube Channel Videos Scraper.