YouTube Autocomplete Scraper: Keyword Suggestions

Get the phrases YouTube's search box suggests for any seed keyword, the same list a viewer sees while typing. Expand each seed with a-z, questions, prepositions, numbers or your own patterns, go one or two levels deeper for long-tail phrases, and get every phrase scored by how often and how high YouTube suggests it. Any language and country. No login, no API key.

What it does

Input	You get
Seed keyword	YouTube's suggestions for it, up to 14 per query
expandAlphabet, expandPrefixAlphabet, expandNumbers	Suggestions for coffee a … coffee z, a coffee … z coffee, coffee 0 … coffee 9
expandQuestions	Suggestions for how coffee, why coffee …, in English, Spanish, Portuguese, German, French or Italian
expandPrepositions	Suggestions for coffee for, coffee with, coffee vs …
customModifiers	Your own words or patterns such as best {seed} for beginners
depth	Every suggestion asked again, one or two levels down, for long-tail phrases

One row per suggestion. Channel suggestions (YouTube sometimes suggests a channel) come with the channel's name and id.

How It Works

Why this one

• A score, not just a list. A phrase that YouTube suggests under many queries, near the top, scores higher. Sort by score and the strongest ideas come first.
• Long tail on request. Depth 1 or 2 asks YouTube about its own suggestions, which is where specific video ideas are.
• Questions in six languages. The question words follow the language you pick.
• Channels as well as phrases. See which channels YouTube puts in front of searchers for your topic.
• Filters built in. Questions only, minimum word count, must contain the seed, excluded words, deduplication across seeds.
• $0.30 per 1,000 suggestions. No login, no API key, no proxy to set up.

Input

Field	Type	Description
keywords	string[]	Seed keywords.
language / country	string	Interface language (en, de, es, ja …) and country (US, GB, IN …). Default en / US.
expandAlphabet	boolean	A-Z after the seed. Default on.
expandPrefixAlphabet	boolean	A-Z before the seed.
expandNumbers	boolean	0-9 after the seed.
expandQuestions	boolean	Question words before the seed. Default on.
expandPrepositions	boolean	Prepositions after the seed.
customModifiers	string[]	Words added after the seed, or patterns with {seed}.
depth	integer	0 (default), 1 or 2.
includeChannels	boolean	Keep channel suggestions. Default on.
mustContainSeed, excludeTerms, onlyQuestions, minWords	filters	Applied before anything is returned or billed.
deduplicate	boolean	A phrase only once across seeds.
maxSuggestionsPerSeed / maxItems	integer	Best N per seed by score (0 shares the run cap equally between seeds); cap per run (default 1,000).

Example: video ideas for a channel

{
  "keywords": ["home workout", "meal prep"],
  "expandAlphabet": true,
  "expandQuestions": true,
  "depth": 1,
  "minWords": 3,
  "maxSuggestionsPerSeed": 200
}

Example: German market

{
  "keywords": ["kaffee"],
  "language": "de",
  "country": "DE",
  "expandQuestions": true,
  "expandPrepositions": true
}

Output

{
  "seed": "coffee",
  "suggestion": "why coffee is bad for you",
  "type": "query",
  "position": 6,
  "score": 3.167,
  "appearances": 5,
  "rankInFirstQuery": 1,
  "queryUsed": "why coffee",
  "expansion": "question",
  "depth": 0,
  "wordCount": 6,
  "isQuestion": true,
  "channelId": null,
  "channelName": null,
  "searchUrl": "https://www.youtube.com/results?search_query=why%20coffee%20is%20bad%20for%20you",
  "language": "en",
  "country": "US"
}

position is the rank within the seed by score. score adds 1 / rank for every query where the phrase appeared, so 1.0 is one appearance at the top. appearances is the number of queries that suggested it. A channel row also has channelId, channelName, channelHandle or channelSubtitle, and channelUrl.

Pricing

Pay per result: $0.30 per 1,000 suggestions, plus $0.005 per run start. Filtered-out suggestions are not returned and not billed. Set a maximum cost per run in the run options and the Actor stops there with what it has.

FAQ

Do I need a YouTube account or an API key? No. These are the suggestions YouTube's search box shows to anyone.

Is score a search volume? No. YouTube publishes no volumes. The score reflects how often and how high YouTube suggests a phrase, which tracks what people type. Use it to rank phrases against each other.

How many suggestions does one seed give? About 14 for the seed alone, 250 to 400 with a-z and questions on, and more with depth 1.

Why do some suggestions not contain my seed? YouTube suggests related phrases too. Turn on mustContainSeed to keep only those that contain it.

Do results change by country? Yes. country decides which searches the suggestions come from, language the language they are in.

🤖 For AI Agents & LLM Apps

Purpose: YouTube search-box suggestions for seed keywords, expanded and scored, as JSON.

Minimal input: {"keywords": ["coffee"]}

Output: one row per suggestion: seed, suggestion, type (query or channel), position, score, appearances, expansion, depth, wordCount, isQuestion, searchUrl, language, country.

Behaviors to know: filters run before billing. score is relative, not a volume. Free-plan runs take up to 3 seeds and return up to 100 suggestions.

⚠️ Disclaimer

This Actor reads YouTube's public search suggestions. It is not affiliated with, endorsed by, or sponsored by YouTube or Google LLC. You are responsible for using the data in line with applicable laws and YouTube's terms.

SEO Keywords

youtube autocomplete scraper, youtube keyword tool, youtube keyword research, youtube search suggestions, youtube suggest scraper, youtube keyword suggestions, youtube seo keywords, youtube video ideas, youtube long tail keywords, youtube search terms, youtube tags generator, youtube keyword finder, youtube autocomplete api