Skip to main content
POST
YouTube Search Suggestions API

YouTube Search Suggestions

Send the start of a search and get back the completions YouTube’s search box proposes, ranked the way viewers see them. Switch language and region to watch the same seed branch out differently in another market — useful for keyword research, video titles and tag ideas.
query is required. language (default en) and region (default US) choose the market the suggestions come from. Each request is billed once, whatever the number of suggestions.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

query is required. language defaults to en and region to US.

query
string
required

The partial search text to complete.

Required string length: 1 - 100
callback_url
string<uri>
language
string
default:en

Language code for the suggestions, such as en, es or pt-BR.

Minimum string length: 1
Pattern: ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})?$
region
string
default:US

Two-letter country code of the search market, such as US or GB.

Minimum string length: 1
Pattern: ^[A-Za-z]{2}$

Response

Task accepted

code
integer
data
object