YouTube Search

Search YouTube videos, Shorts, and creator channels with query and region parameters.

Browse every endpoint with request samples, parameters and its per-request price. One API key calls them all; account limits apply.

API reference Open in Playground

At a glance

Endpoint: POST https://api.serpbase.dev/youtube/search
Price: 1 credits / request
Authentication: X-API-Key
Result type: schemas.source_data

Endpoint and billing rules

POSThttps://api.serpbase.dev/youtube/search

Per-request cost

1 credits / request

Each customer request uses the fixed catalog price, not a per-page rate. Web Crawl and User Agent currently cost 1 credit per request each; User Agent is not free. Genuine not-found results confirmed by source and resource identity are charged. no_results, HTTP 404 or missing hydration/parsed data alone cannot prove absence. Executed failures may currently consume credits; refunds are not guaranteed for every failure. credits_charged reports the actual charge: 0 means reported zero; null or missing means unknown. charge_status UNKNOWN remains unknown even with a numeric charge. Check account records and contact support with request_id; never assume a refund or retry blindly.

Example request parameters

Samples are not the complete parameter list or required-field rules. Known fields are validated; additional parameters are allowed.

Example request parameters
Parameter	Example type	Example value
gl	string	"us"
q	string	"nextjs tutorial"

JSON

{
  "gl": "us",
  "q": "nextjs tutorial"
}

Samples are not the complete parameter list or required-field rules. Known fields are validated; additional parameters are allowed.
Alias	Parameter	Type
country	locale.country	string
cursor	pagination.cursor	string
device	options.device	string
gl	locale.country	string
hl	locale.language	string
html	include_html	boolean
language	locale.language	string
limit	pagination.limit	integer
markdown	include_markdown	boolean
mobile	options.device	boolean
num	pagination.limit	integer
page	pagination.page	integer
q	query	string
search_query	query	string
sp	attributes.sp	string

Supported devices: desktop; default: desktop.

Request examples

cURL

curl -X POST 'https://api.serpbase.dev/youtube/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"gl":"us","q":"nextjs tutorial"}'

JavaScript

const response = await fetch("https://api.serpbase.dev/youtube/search", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
  },
  "body": "{\"gl\":\"us\",\"q\":\"nextjs tutorial\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);

Response and API outcome

Responses are JSON. HTTP 200 is not proof of search success: inspect status and error. Fields depend on the product contract and upstream data.

View response documentation

Frequently asked questions

How much does the YouTube Search API cost?

Each request costs 1 credit. Credits come from prepaid packs or the monthly plan, and new accounts start with free credits.

How do I call the YouTube Search API?

Send a POST request to https://api.serpbase.dev/youtube/search with your API key in the X-API-Key header. The response is JSON; check status (0 means success).

Which devices does it support?

Supported devices: desktop. The default is desktop.

Is the YouTube Search API available now?

Yes. Any active API key can call it.