HProxy YouTube scraper API
The YouTube scraper API API from HProxy — 13 operation(s) for youtube scraper api.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/hproxy-com:hproxy-com-youtube-scraper-api-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: HProxy YouTube scraper API
version: 1.0.0
description: 'Buy and manage proxies from a prepaid wallet, run the Scraper API, or use the free no-key APIs: a live proxy list, a proxy checker and an IP lookup. JSON in, JSON out. Money is always integer cents (120 = $1.20), never floats.'
contact:
url: https://hproxy.com/contact
license:
name: Proprietary
servers:
- url: https://hproxy.com
description: Production
security:
- ApiKeyAuth: []
tags:
- name: YouTube scraper API
paths:
/api/v1/scrape/youtube/channel-lookup:
get:
operationId: channel-lookup
summary: YouTube Channel
description: Returns structured JSON for **YouTube Channel**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: channelId
in: query
required: true
description: Identifier from a previous response. Send this **or** `handle` or `url`.
schema:
type: string
- name: handle
in: query
required: true
description: Account handle or @username. Send this **or** `channelId` or `url`.
schema:
type: string
- name: url
in: query
required: true
description: Target URL (profile, post or video). Send this **or** `channelId` or `handle`.
schema:
type: string
- name: cache_max_age
in: query
required: false
description: '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`.'
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/youtube/channel:
get:
operationId: channel
summary: YouTube Channel
description: Returns structured JSON for **YouTube Channel**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: channelId
in: query
required: true
description: Identifier from a previous response. Send this **or** `handle` or `url`.
schema:
type: string
- name: handle
in: query
required: true
description: Account handle or @username. Send this **or** `channelId` or `url`.
schema:
type: string
- name: url
in: query
required: true
description: Target URL (profile, post or video). Send this **or** `channelId` or `handle`.
schema:
type: string
- name: cache_max_age
in: query
required: false
description: '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`.'
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/youtube/channel-videos:
get:
operationId: channel-videos
summary: YouTube Channel Videos
description: Returns structured JSON for **YouTube Channel Videos**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: channelId
in: query
required: true
description: Identifier from a previous response. Send this **or** `handle`.
schema:
type: string
- name: handle
in: query
required: true
description: Account handle or @username. Send this **or** `channelId`.
schema:
type: string
- name: sort
in: query
required: false
description: 'Ordering to apply to the results. Allowed values: `latest`, `popular`.'
schema:
type: string
- name: continuationToken
in: query
required: false
description: Pagination token from the previous response.
schema:
type: string
- name: includeExtras
in: query
required: false
description: Optional flag (true or false).
schema:
type: boolean
- name: is_paid_promotions
in: query
required: false
description: Optional flag (true or false).
schema:
type: boolean
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/youtube/channel-shorts:
get:
operationId: channel-shorts
summary: YouTube Channel Shorts
description: Returns structured JSON for **YouTube Channel Shorts**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: channelId
in: query
required: true
description: Identifier from a previous response. Send this **or** `handle`.
schema:
type: string
- name: handle
in: query
required: true
description: Account handle or @username. Send this **or** `channelId`.
schema:
type: string
- name: sort
in: query
required: false
description: 'Ordering to apply to the results. Allowed values: `newest`, `popular`.'
schema:
type: string
- name: continuationToken
in: query
required: false
description: Pagination token from the previous response.
schema:
type: string
- name: includeExtras
in: query
required: false
description: Optional flag (true or false).
schema:
type: boolean
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/youtube/video:
get:
operationId: scrapeYoutubeVideo
summary: YouTube Video
description: Returns structured JSON for **YouTube Video**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: url
in: query
required: true
description: Target URL (profile, post or video).
schema:
type: string
- name: language
in: query
required: false
description: Two-letter language code, e.g. en.
schema:
type: string
- name: cache_max_age
in: query
required: false
description: '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`.'
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/youtube/transcript:
get:
operationId: scrapeYoutubeTranscript
summary: YouTube Video Transcript
description: Returns structured JSON for **YouTube Video Transcript**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: url
in: query
required: true
description: Target URL (profile, post or video).
schema:
type: string
- name: language
in: query
required: false
description: Two-letter language code, e.g. en.
schema:
type: string
- name: cache_max_age
in: query
required: false
description: '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`.'
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/youtube/search:
get:
operationId: scrapeYoutubeSearch
summary: YouTube Search
description: Returns structured JSON for **YouTube Search**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: query
in: query
required: true
description: Search term or keyword.
schema:
type: string
- name: uploadDate
in: query
required: false
description: 'Filter by date, as YYYY-MM-DD. Allowed values: `today`, `this_week`, `this_month`, `this_year`.'
schema:
type: string
- name: sortBy
in: query
required: false
description: 'Ordering to apply to the results. Allowed values: `relevance`, `popular`.'
schema:
type: string
- name: type
in: query
required: false
description: 'The type parameter. Allowed values: `videos`, `shorts`, `channels`, `playlists`.'
schema:
type: string
- name: duration
in: query
required: false
description: 'The duration parameter. Allowed values: `under_3_min`, `between_3_and_20_min`, `over_20_min`.'
schema:
type: string
- name: region
in: query
required: false
description: Two-letter region/country code, e.g. US.
schema:
type: string
- name: continuationToken
in: query
required: false
description: Pagination token from the previous response.
schema:
type: string
- name: includeExtras
in: query
required: false
description: Optional flag (true or false).
schema:
type: boolean
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/youtube/comments:
get:
operationId: scrapeYoutubeComments
summary: YouTube Video Comments
description: Returns structured JSON for **YouTube Video Comments**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: url
in: query
required: true
description: Target URL (profile, post or video).
schema:
type: string
- name: continuationToken
in: query
required: false
description: Pagination token from the previous response.
schema:
type: string
- name: order
in: query
required: false
description: 'The order parameter. Allowed values: `top`, `newest`.'
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/youtube/trending-shorts:
get:
operationId: trending-shorts
summary: YouTube Trending Shorts
description: Returns structured JSON for **YouTube Trending Shorts**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/youtube/search-hashtag:
get:
operationId: scrapeYoutubeSearchHashtag
summary: YouTube Hashtag Search
description: Returns structured JSON for **YouTube Hashtag Search**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: hashtag
in: query
required: true
description: 'Hashtag to look up, without the # sign.'
schema:
type: string
- name: continuationToken
in: query
required: false
description: Pagination token from the previous response.
schema:
type: string
- name: type
in: query
required: false
description: 'The type parameter. Allowed values: `all`, `shorts`.'
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/youtube/comment-replies:
get:
operationId: scrapeYoutubeCommentReplies
summary: YouTube Comment Replies
description: Returns structured JSON for **YouTube Comment Replies**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: continuationToken
in: query
required: true
description: Pagination token from the previous response.
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/youtube/playlist:
get:
operationId: playlist
summary: YouTube Playlist
description: Returns structured JSON for **YouTube Playlist**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: playlist_id
in: query
required: true
description: Identifier from a previous response.
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
/api/v1/scrape/youtube/community-post:
get:
operationId: community-post
summary: YouTube Community Post
description: Returns structured JSON for **YouTube Community Post**. Billed **$0.00149 per successful call** ($1.49 per 1,000); errors, timeouts and rate limits are never charged, while a lookup whose target does not exist is billed like a successful call because the platform was queried. `POST` with a JSON body works too.
tags:
- YouTube scraper API
parameters:
- name: x-api-key
in: query
required: true
description: Your HProxy API key with the scrape scope.
schema:
type: string
- name: url
in: query
required: true
description: Target URL (profile, post or video).
schema:
type: string
- name: trim
in: query
required: false
description: Return a slimmed-down payload (drops verbose fields).
schema:
type: boolean
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Invalid input. The body names the field and the accepted set.
'401':
description: Missing or invalid API key.
'429':
description: Rate limited. Retry after the delay in the response.
security:
- ApiKeyAuth: []
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Your API key. Free keyless endpoints ignore it.
x-endpoint-count: 163
x-generated-from: https://hproxy.com/docs
x-llms: https://hproxy.com/llms-full.txt