youtube/
search-suggestions

The YouTube Search Suggestions API gets the autocomplete suggestions YouTube's search box offers for a partial query, ranked as viewers see them, for the language and region you choose.

YouTube Search Suggestions API

Autocomplete
Language and region
Flat price per request
0.5 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

YouTube Search Suggestions

Search suggestions are the completions YouTube's search box proposes while a viewer is still typing, ranked for the viewer's language and country. They expose the real phrasing of demand around a seed term, which makes them a direct source for keyword research, video titles, tags and content ideas.

YouTube Search Suggestions API Features

  • The order viewers seerank records each suggestion's position in the dropdown, starting at 1 for the top completion.
  • Choose the marketlanguage and region switch the suggestions to another market, for example es and MX for Mexican Spanish searches.
  • A search link for each phraseEvery suggestion comes with the YouTube results URL for that phrase, alongside the seed query and market it was requested with.

YouTube Search Suggestions API Parameters

ParametersRequiredDescription
queryRequiredThe start of a search to complete, up to 100 characters.
languageOptionalLanguage code for the suggestions, such as en, es or pt-BR. Defaults to en.
regionOptionalTwo-letter country code of the search market, such as US or GB. Defaults to US.

How to Use the YouTube Search Suggestions API

Send the start of a search to the YouTube Search Suggestions API and read back the ranked completions.

  1. POST {"query": "iphone 17"} to /v1/youtube/search-suggestions, adding language and region for another market.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the suggestions from results.items in rank order; follow results.next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"iphone 17"}'

# Each item is one suggestion: keyword, rank, language and region.

YouTube Search Suggestions API Use Cases

  • Expanding a seed keyword: Collect the completions for a product or topic name to find the longer phrases viewers actually search.
  • Writing titles that match search: Pick wording from top-ranked suggestions so a video title mirrors how people type the query.
  • Comparing demand across markets: Run the same seed with different language and region values to see how intent shifts from one country to another.

YouTube Search Suggestions API Pro Tips

  • Add a letter after the seed, such as iphone 17 a, to pull completions that continue with that letter.
  • Keep language and region consistent when you track a seed over time, since each market returns its own list.

Beyond the YouTube Search Suggestions API, use these APIs when you need a different type of public YouTube data.

Explore other platforms

Combine YouTube data with public data from other supported social platforms.

YouTube Search Suggestions API — FAQ

YouTube Search Suggestions API is a programmatic interface for retrieving YouTube's search autocomplete suggestions for a partial query in a chosen language and region. It returns each suggested phrase with its rank.

Yes. The suggestions are the completions YouTube's search box shows as you type, returned in the same order.

As many as YouTube offers for that query, typically around a dozen.

The official Data API has no autocomplete or typeahead endpoint. This endpoint returns the suggestions YouTube's search box shows, ranked for the language and region you choose.

Each YouTube Search Suggestions API request costs a flat 0.5 credits, however many suggestions it returns.