YouTube scraper API

YouTube Search

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.

get/api/v1/scrape/youtube/search

Request

  • Base URL: https://hproxy.com
  • URL: https://hproxy.com/api/v1/scrape/youtube/search
  • Auth: API key in header X-API-Key

Query parameters

x-api-keystring required

Your HProxy API key with the scrape scope.

querystring required

Search term or keyword.

uploadDatestring

Filter by date, as YYYY-MM-DD. Allowed values: today, this_week, this_month, this_year.

sortBystring

Ordering to apply to the results. Allowed values: relevance, popular.

typestring

The type parameter. Allowed values: videos, shorts, channels, playlists.

durationstring

The duration parameter. Allowed values: under_3_min, between_3_and_20_min, over_20_min.

regionstring

Two-letter region/country code, e.g. US.

continuationTokenstring

Pagination token from the previous response.

includeExtrasboolean

Optional flag (true or false).

Response

Success

object required

Changes

No recorded changes to this operation across all 1 revision of this API.