YouTube search autocomplete

Get YouTube search query suggestions for a partial keyword.

← All YouTube endpoints · Capability overview

GET/v1/youtube/search-autocomplete

https://api.vee3.io/v1/youtube/search-autocomplete

8 tokens

Get YouTube search query suggestions for a partial keyword.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

youtube.search_autocomplete

Parameters3 fields

querystringRequired

Partial search keywords or phrase.

max length 512

languagestringOptional

Language code for localized suggestions (for example en).

Default: "en" · max length 10

locationstringOptional

Country code for localized suggestions (for example US).

Default: "US" · max length 10

Response2 fields

querystring

Normalized query echoed from the provider.

resultsstring[]

Suggested search phrases for the query.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_not_configured, youtube_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/search-autocomplete"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "query": "despacito"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample autocomplete suggestions for despacito.

despacito_suggestions.json

{
  "query": "despacito",
  "results": [
    "despacito",
    "despacito justin bieber",
    "despacito lyrics",
    "despacito song",
    "despacito remix",
    "despacito slowed",
    "despacito dance",
    "despacito english version",
    "despacito karaoke",
    "despacito luis fonsi",
    "despacito piano",
    "despacito cover",
    "despacito 1 hour",
    "despacito guitar"
  ]
}