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.
hproxy.com/api/v1/scrape/youtube/channel-lookupYouTube 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. |
curl "https://hproxy.com/api/v1/scrape/youtube/channel-lookup?handle=MrBeast" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/youtube/channelYouTube 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. |
curl "https://hproxy.com/api/v1/scrape/youtube/channel?handle=MrBeast" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/youtube/channel-videosYouTube 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). |
curl "https://hproxy.com/api/v1/scrape/youtube/channel-videos?handle=MrBeast" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/youtube/channel-shortsYouTube 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). |
curl "https://hproxy.com/api/v1/scrape/youtube/channel-shorts?handle=MrBeast" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/youtube/videoYouTube 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. |
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"hproxy.com/api/v1/scrape/youtube/transcriptYouTube 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. |
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"hproxy.com/api/v1/scrape/youtube/searchYouTube 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). |
curl "https://hproxy.com/api/v1/scrape/youtube/search?query=coffee" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/youtube/trending-shortsYouTube 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. |
curl "https://hproxy.com/api/v1/scrape/youtube/trending-shorts" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/youtube/search-hashtagYouTube 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. |
curl "https://hproxy.com/api/v1/scrape/youtube/search-hashtag?hashtag=travel" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/youtube/comment-repliesYouTube 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. |
curl "https://hproxy.com/api/v1/scrape/youtube/comment-replies?continuationToken=value" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/youtube/playlistYouTube 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. |
curl "https://hproxy.com/api/v1/scrape/youtube/playlist?playlist_id=1234567890" \
-H "X-API-Key: hpx_your_key_here"hproxy.com/api/v1/scrape/youtube/community-postYouTube 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). |
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"Need a hand wiring this up? Email support@hproxy.com. A real person reads every message.
hproxy.com/api/v1/scrape/youtube/commentsYouTube 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.
POSTwith a JSON body works too.x-api-keyurlcontinuationTokenordertop,newest.