Google Keyword Suggestions Scraper

Find public Google autocomplete suggestions for one or more seed phrases. Choose how Google expands each seed, filter and limit the suggestions, and optionally add visible results from Google Search.

Quick start

Enter a seed phrase and choose a country and language. For a small run, set the expansion mode to exact and limit the generated requests and dataset rows:

{
  "keywords": ["python tutorial"],
  "mode": "exact",
  "country": "US",
  "language": "en",
  "maxPages": 1,
  "maxItems": 10
}

Input

Input	Description
keywords	Seed phrases to expand (up to 100). The aliases queries, query, and searchQuery are also accepted.
mode	exact or all requests the seed phrase. questions, prepositions, comparisons, and alphabet generate related phrase variations.
country / language	Google country (gl) and language (hl) settings. Use ALL for country to omit the country setting.
minLength / maxLength	Keep suggestions within a character-count range.
containsKeyword	Keep suggestions containing this text. Prefix it with ! to exclude matches.
maxItemsPerKeyword	Maximum unique suggestions kept for each seed (default 200; maximum 500).
page / maxPages	Starting position and request limit in the generated expansion list for each seed. These control expansion requests, not Google Search result pages.
maxItems	Maximum dataset rows across all seeds (default 25; maximum 500).
outputFormat	flat returns one row per suggestion; tree returns one row per seed with its suggestions nested.
includeSearchResults	Add public Google Search results for eligible suggestions. Off by default.
maxSearchResultRequests	Maximum distinct Search pages to fetch when enrichment is enabled (default 10; maximum 50). Repeated suggestions reuse the same results.
maxSearchResultsPerType	Maximum web results, videos, People also ask questions, and related searches retained per Search page (default 10; maximum 50).
maxSearchResponseBytes	Maximum size of each optional Search page response (default 4 MB).
renderJavaScript	Allow an ordinary browser to render Search pages that need it. Applies only when Search enrichment is on; browser rendering requires at least 1024 MB.
proxyConfiguration	Optional Apify proxy settings for Suggest and Search requests. Use proxy groups available to your account.
searchProxyConfiguration	Optional separate proxy for Search enrichment. When enabled, it applies only to Search; Suggest continues to use proxyConfiguration.

Google Suggest returns a suggestion set for each request rather than numbered result pages. Expansion modes can generate multiple requests per seed, so use page and maxPages to control how many are made.

Output

The dataset contains the suggestion, its seed phrase, country and language, its position in Google's response, and any Google relevance or type metadata that Google returns. It also includes simple text comparisons such as character count, whitespace-separated tokens, punctuation, whether the seed appears in the suggestion, and seed-token overlap. These comparisons are calculated from the returned text; they are not Google search-volume or intent metrics.

In flat format, each suggestion is a dataset row. In tree format, each row represents a seed and contains a suggestions array.

When Search enrichment is enabled, a suggestion may also include a searchResults object with visible organic results, video cards, People also ask questions, and related searches. Answers, dates, snippets, and other details are included only when Google displays them. The Actor does not follow result links to collect destination pages.

{
  "suggestion": "python tutorial for beginners",
  "seedKeyword": "python tutorial",
  "language": "en",
  "country": "US",
  "suggestionOrder": 1,
  "googleRelevance": null,
  "googleSuggestionType": null,
  "googleSuggestionSubtypes": null,
  "suggestionCharacterCount": 29,
  "suggestionTokenCount": 4,
  "suggestionTokens": ["python", "tutorial", "for", "beginners"],
  "containsSeedKeyword": true,
  "exactSeedMatch": false,
  "seedTokenOverlapTokens": ["python", "tutorial"],
  "seedTokenOverlapCount": 2,
  "seedTokenOverlapRatio": 1
}

Download the dataset from the Apify run page in JSON, CSV, Excel, and other supported formats. Run counts and access outcomes are available in the run's output.

Limits

• Google may vary suggestions by country, language, time, and access policy.
• Expansion modes can make many requests. Start with a small number of seeds and a low maxPages value.
• The Actor collects public autocomplete suggestions and does not provide Ads search volume, CPC, competition, or trend history.
• The Actor does not bypass CAPTCHAs or other access boundaries.

FAQ

Why did a run return no suggestions?

Google may limit requests or show an access boundary. Check the run log, then retry later with fewer seeds and a modest request delay.

What does tree output contain?

Tree output groups each seed with its returned suggestion objects in a single dataset row. Flat output places each suggestion in its own row.

Is this an official Google product?

No. This Actor is not affiliated with, endorsed by, or sponsored by Google. Use collected data in accordance with Google's applicable terms and policies.

Privacy

The Actor sends seed phrases and the selected country and language settings to Google's public Suggest service. If Search enrichment is enabled, it also sends eligible suggestion phrases to Google Search. Avoid submitting sensitive terms.