Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hasdata.com/llms.txt

Use this file to discover all available pages before exploring further.

The YouTube Search API provides real-time access to structured YouTube search results.

​
Get Your API Key

Sign in at hasdata.com, go to your account settings, and copy your API key. All requests must include your key in the x-api-key header.

​
Request Cost and API Credits

Each request to the YouTube Search API consumes API Credits from your account balance.
  • Cost per request: 10 API Credits
  • Credits are deducted only for successful requests.
  • Your total available credits depend on your active plan.
You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.
Unused credits do not roll over. Any remaining credits expire at the end of the current billing period.
To monitor your credit usage and remaining balance, sign in to your account dashboard at app.hasdata.com.

​
Make Your First Request

curl --request GET -G \
  --url 'https://api.hasdata.com/scrape/youtube/search' \
  --data-urlencode 'q=BMW' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'

​
API Parameters

ParameterDefault ValueRequiredDescription
qBMWYesThe search query.
gl-NoThe two-letter country code for the country you want to limit the search to.
hl-NoThe two-letter language code for the language you want to use for the search.
deviceType-NoDevice type for the request.
sp-NoRaw YouTube sp filter parameter.
sortBy-NoSort order of results.
date-NoFilter by upload date.
videoType-NoFilter by content type.
length-NoFilter by video duration.
filters[]-NoAn array of feature filters to apply. Can include any combination of the supported values.
paginationToken-NoToken returned in the previous response to fetch the next page.