Google Autocomplete Scraper

Features

• Autocomplete Suggestions: Extracts keyword suggestions that Google shows as you type in the search box
• Suggestion Types: Identifies whether each suggestion is a standard query, trending topic, or other type
• Relevance Scores: Captures relevance/ranking data associated with each suggestion
• Position Tracking: Records the position of each suggestion in Google's dropdown
• Keyword Research: Ideal for SEO keyword research, content ideation, and competitive analysis
• Localization Support: Configurable country (gl) and language (hl) for region-specific suggestions
• Proxy Support: Built-in support for Google SERP proxy to avoid rate limiting

Input Parameters

Parameter	Type	Required	Default	Description
query	String	Yes	"how to"	The keyword or partial query to get autocomplete suggestions for
maxItems	Integer	No	50	Maximum number of suggestions to return (1–500)
gl	String	No	"us"	Country code for localized suggestions (e.g., us, in, uk)
hl	String	No	"en"	Language code for suggestions (e.g., en, hi, fr)
proxyConfiguration	Object	No	Apify GOOGLE_SERP	Proxy settings for the scraper

Input Schema Example

{
  "query": "best programming language",
  "maxItems": 20,
  "gl": "us",
  "hl": "en",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["GOOGLE_SERP"]
  }
}

Output Schema

The scraper outputs structured JSON data for each autocomplete suggestion returned by Google.

Main Fields

Field	Type	Description
position	Integer	Position of the suggestion in the autocomplete dropdown
suggestion	String	The autocomplete suggestion text
type	String	Type of suggestion (query, trending, etc.)
relevance	Number	Relevance score assigned by Google

Autocomplete Suggestion Example

{
  "position": 1,
  "suggestion": "best programming language for beginners",
  "type": "query",
  "relevance": 600
},
{
  "position": 2,
  "suggestion": "best programming language for web development",
  "type": "query",
  "relevance": 565
},
{
  "position": 3,
  "suggestion": "best programming language 2025",
  "type": "trending",
  "relevance": 530
}