YouTube scraper API

Every YouTube scraper endpoint: 13 actions returning structured JSON from $0.003 per call. No proxies, no captchas, no infrastructure.

All 13 YouTube endpoints, from $0.003 per call. Each is callable as GET https://hproxy.com/api/v1/scrape/youtube/{action} (or POST with a JSON body) using a key with the scrape scope. No proxies, captchas or parsing to manage, it is all included in the price, and failed calls are never billed. See the full catalog for every platform, or the YouTube landing page for examples and use cases.

GEThproxy.com/api/v1/scrape/youtube/channel-lookupkey

curl "https://hproxy.com/api/v1/scrape/youtube/channel-lookup?handle=MrBeast" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Channel

Returns structured JSON for YouTube Channel. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.
`channelId`	string (query)	required	Identifier from a previous response. Send this or `handle` or `url`.
`handle`	string (query)	required	Account handle or @username. Send this or `channelId` or `url`.
`url`	url (query)	required	Target URL (profile, post or video). Send this or `channelId` or `handle`.
`cache_max_age`	string (query)	optional	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`.

GEThproxy.com/api/v1/scrape/youtube/channelkey

curl "https://hproxy.com/api/v1/scrape/youtube/channel?handle=MrBeast" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Channel

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.
`channelId`	string (query)	required	Identifier from a previous response. Send this or `handle` or `url`.
`handle`	string (query)	required	Account handle or @username. Send this or `channelId` or `url`.
`url`	url (query)	required	Target URL (profile, post or video). Send this or `channelId` or `handle`.
`cache_max_age`	string (query)	optional	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`.

GEThproxy.com/api/v1/scrape/youtube/channel-videoskey

curl "https://hproxy.com/api/v1/scrape/youtube/channel-videos?handle=MrBeast" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Channel Videos

Returns structured JSON for YouTube Channel Videos. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.
`channelId`	string (query)	required	Identifier from a previous response. Send this or `handle`.
`handle`	string (query)	required	Account handle or @username. Send this or `channelId`.
`sort`	string (query)	optional	Ordering to apply to the results. Allowed values: `latest`, `popular`.
`continuationToken`	string (query)	optional	Pagination token from the previous response.
`includeExtras`	boolean (query)	optional	Optional flag (true or false).
`is_paid_promotions`	boolean (query)	optional	Optional flag (true or false).

GEThproxy.com/api/v1/scrape/youtube/channel-shortskey

curl "https://hproxy.com/api/v1/scrape/youtube/channel-shorts?handle=MrBeast" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Channel Shorts

Returns structured JSON for YouTube Channel Shorts. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.
`channelId`	string (query)	required	Identifier from a previous response. Send this or `handle`.
`handle`	string (query)	required	Account handle or @username. Send this or `channelId`.
`sort`	string (query)	optional	Ordering to apply to the results. Allowed values: `newest`, `popular`.
`continuationToken`	string (query)	optional	Pagination token from the previous response.
`includeExtras`	boolean (query)	optional	Optional flag (true or false).

GEThproxy.com/api/v1/scrape/youtube/videokey

curl "https://hproxy.com/api/v1/scrape/youtube/video?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Video

Returns structured JSON for YouTube Video. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.
`url`	url (query)	required	Target URL (profile, post or video).
`language`	string (query)	optional	Two-letter language code, e.g. en.
`cache_max_age`	string (query)	optional	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`.

GEThproxy.com/api/v1/scrape/youtube/transcriptkey

curl "https://hproxy.com/api/v1/scrape/youtube/transcript?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Video Transcript

Returns structured JSON for YouTube Video Transcript. Billed $0.030 per successful call ($30.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.
`url`	url (query)	required	Target URL (profile, post or video).
`language`	string (query)	optional	Two-letter language code, e.g. en.
`cache_max_age`	string (query)	optional	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`.

GEThproxy.com/api/v1/scrape/youtube/searchkey

curl "https://hproxy.com/api/v1/scrape/youtube/search?query=coffee" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Search

Returns structured JSON for YouTube Search. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.
`query`	string (query)	required	Search term or keyword.
`uploadDate`	string (query)	optional	Filter by date, as YYYY-MM-DD. Allowed values: `today`, `this_week`, `this_month`, `this_year`.
`sortBy`	string (query)	optional	Ordering to apply to the results. Allowed values: `relevance`, `popular`.
`type`	string (query)	optional	The type parameter. Allowed values: `videos`, `shorts`, `channels`, `playlists`.
`duration`	string (query)	optional	The duration parameter. Allowed values: `under_3_min`, `between_3_and_20_min`, `over_20_min`.
`region`	string (query)	optional	Two-letter region/country code, e.g. US.
`continuationToken`	string (query)	optional	Pagination token from the previous response.
`includeExtras`	boolean (query)	optional	Optional flag (true or false).

GEThproxy.com/api/v1/scrape/youtube/commentskey

curl "https://hproxy.com/api/v1/scrape/youtube/comments?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Video Comments

Returns structured JSON for YouTube Video Comments. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.
`url`	url (query)	required	Target URL (profile, post or video).
`continuationToken`	string (query)	optional	Pagination token from the previous response.
`order`	string (query)	optional	The order parameter. Allowed values: `top`, `newest`.

GEThproxy.com/api/v1/scrape/youtube/trending-shortskey

curl "https://hproxy.com/api/v1/scrape/youtube/trending-shorts" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Trending Shorts

Returns structured JSON for YouTube Trending Shorts. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.

GEThproxy.com/api/v1/scrape/youtube/search-hashtagkey

curl "https://hproxy.com/api/v1/scrape/youtube/search-hashtag?hashtag=travel" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Hashtag Search

Returns structured JSON for YouTube Hashtag Search. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.
`hashtag`	string (query)	required	Hashtag to look up, without the # sign.
`continuationToken`	string (query)	optional	Pagination token from the previous response.
`type`	string (query)	optional	The type parameter. Allowed values: `all`, `shorts`.

GEThproxy.com/api/v1/scrape/youtube/comment-replieskey

curl "https://hproxy.com/api/v1/scrape/youtube/comment-replies?continuationToken=value" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Comment Replies

Returns structured JSON for YouTube Comment Replies. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.
`continuationToken`	string (query)	required	Pagination token from the previous response.

GEThproxy.com/api/v1/scrape/youtube/playlistkey

curl "https://hproxy.com/api/v1/scrape/youtube/playlist?playlist_id=1234567890" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Playlist

Returns structured JSON for YouTube Playlist. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.
`playlist_id`	string (query)	required	Identifier from a previous response.

GEThproxy.com/api/v1/scrape/youtube/community-postkey

curl "https://hproxy.com/api/v1/scrape/youtube/community-post?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ" \
  -H "X-API-Key: hpx_your_key_here"

YouTube Community Post

Returns structured JSON for YouTube Community Post. Billed $0.003 per successful call ($3.00 per 1,000); failed calls, timeouts and rate-limited calls are never charged. POST with a JSON body works too.

Parameter	Type	Required	Description
`x-api-key`	string (header)	required	Your HProxy API key with the scrape scope.
`url`	url (query)	required	Target URL (profile, post or video).
`trim`	boolean (query)	optional	Return a slimmed-down payload (drops verbose fields).

← Previous

TikTok

Twitter / X

Need a hand wiring this up? Email support@hproxy.com. A real person reads every message.