Google Autocomplete Scraper

Scrapes Google Autocomplete suggestions for any seed query. Extracts the full set of autocomplete fields: suggestion text + HTML, vertical (web/people/products/news/...), highlighted flag, completion, replacement, locale, client, and more.

What this Actor collects

The Actor converts Google Autocomplete responses into one clean JSON record per suggestion, including suggestion text and HTML, rank, vertical, completion and replacement data, locale, client context, and retrieval metadata.

• Uses the input limits and filters below to control the crawl.
• Stores source-backed fields defined by the 38-field dataset schema.
• Omits optional fields when the source does not expose a value instead of writing nulls or fabricated placeholders.

Use cases

• Keyword discovery
• Content and SEO research
• Search-demand exploration

Input

Provide input in JSON. Fields marked required must be supplied. The Default / example column shows a schema default when one exists; otherwise it shows a documented prefill or fixture value.

Field	Type	Required	Default / example	Description
query	string	Yes	"how to"	The query/keyword to get autocomplete suggestions for.
maxItems	integer	No	50	Maximum number of autocomplete suggestions to return.
gl	string	No	"us"	Google country code for localized results (e.g. 'us', 'in', 'uk').
hl	string	No	"en"	Google language code for localized results (e.g. 'en', 'hi', 'fr').
expandQueries	boolean	No	true	Request alphabetic and numeric seed expansions until maxItems unique source suggestions are collected.
maxRequestRetries	integer	No	3	Retries for a failed, blocked, or malformed Suggestions response.
requestTimeoutSecs	integer	No	30	Per-request timeout in seconds.
proxyConfiguration	object	No	{"useApifyProxy":true,"apifyProxyGroups":["GOOGLE_SERP"]}	Proxy settings for the scraper.

Example input

{
  "query": "how to",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "GOOGLE_SERP"
    ]
  },
  "gl": "us",
  "hl": "en",
  "expandQueries": true,
  "maxRequestRetries": 3,
  "requestTimeoutSecs": 30
}

Output

The default dataset contains one item per autocomplete suggestion. The following are the most useful fields; vertical, highlighting, completion, and replacement fields depend on the source response.

Field	Type	Description
position	integer	Position
searchQuery	string	Seed Query
requestQuery	string	Source Request Query
suggestion	string	Suggestion
suggestionType	string	Google Suggestion Type
relevance	integer	Google Relevance
country	string	Country
language	string	Language
scrapedAt	string	Scraped At
type	string	Type
source	string	Source
query	string	Query Alias
page	integer	Request Page
resultType	string	Result Type
requestIndex	integer	Source Request Index
isExpandedRequest	boolean	Expanded Request

Example dataset item

This compact example is taken from local Actor storage. Long text and nested collections are shortened for documentation only.

{
  "position": 1,
  "searchQuery": "how to",
  "requestQuery": "how to",
  "suggestion": "how to lose a guy in 10 days",
  "suggestionType": "query",
  "relevance": 601,
  "country": "US",
  "language": "en",
  "scrapedAt": "2026-07-23T19:31:03.758Z",
  "type": "autocomplete-suggestion",
  "source": "google-suggest-api",
  "query": "how to lose a guy in 10 days"
}

Related Actors

• Google About This Result Scraper
• Google AI Overview Scraper
• Google Books Scraper