YouTube · Profiles

YouTube Channel Scraper API

The YouTube Channel endpoint is one API call: send either a channel ID, a handle or a URL with your HProxy key and get back a clean, structured JSON object. Pull a YouTube channel in full: about text, country, subscriber, view and video counts, every external link and its artwork. HProxy runs the proxies, sessions, anti-bot handling and parsing server-side, so there is no headless browser to babysit and no parser to keep fixing when YouTube changes its markup. You only ever touch the JSON.
  • 0.15¢ per call
  • $1.49 per 1,000
  • Takes either a channel ID, a handle or a URL
  • Errors and timeouts are not charged

The call

One GET, and the channel comes back as JSON.

Your key goes in one header. 1 required parameter, and the answer is the object below it.

The full reference
curl "https://hproxy.com/api/v1/scrape/youtube/channel-lookup?handle=MrBeast" \
  -H "X-API-Key: hpx_your_key_here"
Response200 OK · JSON
{
  "id": "UC...",
  "title": "Channel name",
  "about": "What the channel is about.",
  "subscriberCount": 412000,
  "videoCount": 318,
  "links": ["https://example.com"],
  "banner": "https://.../banner.jpg"
}

What comes back

The YouTube channel object.

about
Channel description and country.
subscriberCount
Subscriber total, plus view and video counts.
links[]
Every external link on the channel page.
avatar / banner
Channel artwork at full resolution.

What it takes

Parameters.

Send any one of channelId, handle, url. One of channelId, handle, or url is required

channelIdstring1234567890

Identifier from a previous response.

handlestringMrBeast

Account handle or @username.

urlurlhttps://www.youtube.com/watch?v=dQw4w9WgXcQ

Target URL (profile, post or video).

cache_max_agestring1d

Accept a cached result up to this old (1d, 3d, 7d, 14d or 30d) and pay nothing for it. Omit for a live scrape. Allowed values: `1d`, `3d`, `7d`, `14d`, `30d`.

How it works

Scraping YouTube channel, in three steps.

You write one line. Proxies, anti-bot walls, rendering and parsing happen on our side.

  1. 1

    Create a free account

    Sign up and top up any amount. The balance pays for every HProxy product.
  2. 2

    Grab your API key

    One key from the dashboard authenticates every scraper.
  3. 3

    Call the endpoint

    Send the GET you need and read the JSON. That is the entire integration.

What people build with it

Where the YouTube channel endpoint earns its keep.

  • Enrich a creator database with live channel stats.
  • Track subscriber growth across a roster.
  • Pull every external link a channel promotes.

YouTube channel questions

Answered before you ask.

The reference

Send one authenticated HTTPS request to the YouTube Channel endpoint with either a channel ID, a handle or a URL and your HProxy API key. Pull a YouTube channel in full: about text, country, subscriber, view and video counts, every external link and its artwork. No proxies, no headless browser and no parsing on your side. The response is ready-to-use JSON.

This endpoint is 0.15¢ per successful call, which is $1.49 per 1,000. It bills from your HProxy balance with no subscription and no monthly minimum. Errors are retried and never charged; a lookup whose target does not exist counts as a call.

The API only accesses publicly available YouTube data, the same pages anyone can open in a browser. You are responsible for using the data in line with applicable laws and YouTube's terms for your use case.

A structured JSON object with the full channel data YouTube exposes publicly. See the fields listed above. The schema is consistent across calls, so you integrate once and rely on it.

No. Every call runs on HProxy's own residential network behind the scenes, so requests look like real users. The proxy layer is already included in the per-call price.

More on the YouTube Channel API

What the YouTube Channel endpoint returns

Pull a YouTube channel in full: about text, country, subscriber, view and video counts, every external link and its artwork. The JSON object carries about, subscriberCount, links[] and avatar / banner. Nothing is summarised away on our side, so what you read in the response is what the YouTube channel page itself holds.

What you send to the YouTube Channel API

The call takes either a channel ID, a handle or a URL, and any one of channelId, handle and url satisfies it. Optional: channelId, handle, url and cache_max_age. Your key travels in the X-API-Key header, the response is JSON, and the call is billed at 0.15¢, $1.49 per 1,000.

Profiles on other platforms

The same profiles data is available on 18 other platforms: TikTok Profile, Facebook Profile, Instagram Profile, LinkedIn Profile, Twitter / X Profile, Reddit Subreddit Details, Threads Profile, Twitch Profile, Bluesky Profile, Spotify Artist, Truth Social Profile, Komi Page, Linkbio Page, Linkme Profile, Linktree Page, Pillar Page, Snapchat Profile and SoundCloud Artist. They share this endpoint's JSON shape, its per-call billing and your one API key, so moving from YouTube to another network is a change of URL rather than a second integration.

Is scraping YouTube channel allowed?

The endpoint reads publicly available YouTube data, the same pages anyone can open in a browser without logging in. It does not touch private accounts or anything behind a password. How you then use the data is yours to keep lawful, under the rules that apply to you and to YouTube.

Ready when you are.

Your dashboard is ten seconds away. No sales call, no subscription, no minimum.