YouTube Search — API reference
/youtube/searchYouTube Search
Search YouTube videos, Shorts, and creator channels with query and region parameters.
Search YouTube videos, Shorts, and creator channels with query and region parameters.
glstringCatalog sample; the API validates required fields.
sample: "us"
qstringCatalog sample; the API validates required fields.
sample: "nextjs tutorial"
countrystringoptional
Public alias for locale.country. Use one spelling at a time; the API validates the parameters and values supported by this product.
cursorstringoptional
Public alias for pagination.cursor. Use one spelling at a time; the API validates the parameters and values supported by this product.
devicestringoptional
Public alias for options.device. Use one spelling at a time; the API validates the parameters and values supported by this product.
hlstringoptional
Public alias for locale.language. Use one spelling at a time; the API validates the parameters and values supported by this product.
htmlbooleanoptional
Public alias for include_html. Use one spelling at a time; the API validates the parameters and values supported by this product.
languagestringoptional
Public alias for locale.language. Use one spelling at a time; the API validates the parameters and values supported by this product.
limitintegeroptional
Public alias for pagination.limit. Use one spelling at a time; the API validates the parameters and values supported by this product.
markdownbooleanoptional
Public alias for include_markdown. Use one spelling at a time; the API validates the parameters and values supported by this product.
mobilebooleanoptional
Public alias for options.device. Use one spelling at a time; the API validates the parameters and values supported by this product.
numintegeroptional
Public alias for pagination.limit. Use one spelling at a time; the API validates the parameters and values supported by this product.
pageintegeroptional
Public alias for pagination.page. Use one spelling at a time; the API validates the parameters and values supported by this product.
search_querystringoptional
Public alias for query. Use one spelling at a time; the API validates the parameters and values supported by this product.
spstringoptional
Public alias for attributes.sp. Use one spelling at a time; the API validates the parameters and values supported by this product.
{
"gl": "us",
"q": "nextjs tutorial"
}The response follows this product's contract; no recorded response example is published yet.schemas.source_data
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"}'Use the catalog sample to get started, then inspect the actual JSON response.
The sample shows example parameters, not the complete request contract. Known fields are validated by the API; additional parameters are allowed.