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
| Parameters | Required | Description |
|---|---|---|
query | Required | The start of a search to complete, up to 100 characters. |
language | Optional | Language code for the suggestions, such as en, es or pt-BR. Defaults to en. |
region | Optional | Two-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.
- POST {"query": "iphone 17"} to /v1/youtube/search-suggestions, adding language and region for another market.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
Beyond the YouTube Search Suggestions API, use these APIs when you need a different type of public YouTube data.
- YouTube Channel Videos API — Collect regular public videos from channel URLs, excluding Shorts and live streams.
- YouTube Comments API — Collect public comments, authors, engagement, source videos, and conversation context.
- YouTube Search API — Search public regular videos by keyword with supported metadata filters.
- YouTube Hashtag Search API — Find public videos from hashtag feeds with all-content or Shorts-only collection.
- YouTube Channel Search API — Find channels by keyword, with names, subscriber counts, avatars, and description snippets.
- YouTube Shorts Search API — Search Shorts by keyword, with links, captions, view counts, and vertical thumbnails.
- YouTube Transcripts API
- YouTube Channels API
- YouTube Videos API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Email Finder API
- YouTube Trending Videos API