Google Autocomplete Scraper - Keyword Suggestions

Google Autocomplete Scraper returns the suggestions Google shows while someone types, for any partial query, country and language. The Chrome client adds each suggestion's type and relevance score; the Google web client adds entity titles, descriptions and thumbnails; the YouTube client returns YouTube search suggestions. Use it to expand a seed keyword into the long-tail queries people actually type, for SEO, content planning and PPC research. Pricing is pay-per-event: $0.003 per query; failed requests are not charged.

Proxies, retries and anti-bot handling are built in, so you don't need your own proxies or an API key. Start a run, get structured JSON.

What can this scraper do?

• Suggestions for any partial query, country and language.
• Type and relevance (Chrome client) or entity details (Google web client).
• YouTube suggestions with the YouTube client.
• Cursor position support to complete a word in the middle of a query.
• Very cheap per query; empty answers are free.

What data can you extract?

Field	Description
suggestions[].value	Suggested query
suggestions[].type / relevance	Suggestion type and Google relevance score (Chrome client)
verbatim_relevance	Relevance of the typed text itself
total	Number of suggestions

Every dataset item also carries input (the exact request that was sent), request_id (quote it to support), billed and scraped_at.

How to use Google Autocomplete Scraper - Keyword Suggestions

1. Open Google Autocomplete Scraper - Keyword Suggestions in Apify Console and go to the Input tab.
2. Enter partial queries (seed keywords) and pick a country and language.
3. Adjust the options if needed. Dates accept an exact date (2026-12-01) or a relative one (30 days from today), so saved tasks and schedules never go stale.
4. Click Start and wait for the run to finish.
5. Download the results from the Output tab as JSON, CSV, Excel or HTML, or fetch them with the Apify API.

Input example

This is the default input; running the Actor without changes uses it.

{
  "queries": [
    "coffee"
  ],
  "includeErrors": true,
  "maxConcurrency": 3,
  "maxRetries": 2
}

Output example

One dataset item per request (trimmed here; real items contain every field the API returns):

{
  "endpoint": "/v1/google/autocomplete",
  "input": {
    "q": "coffee"
  },
  "meta": {
    "elapsed_s": 0.21,
    "source": "google_autocomplete"
  },
  "search_parameters": {
    "client": "chrome",
    "engine": "google_autocomplete",
    "gl": "us",
    "hl": "en",
    "q": "coffee"
  },
  "suggestions": [
    {
      "relevance": 1250,
      "type": "QUERY",
      "value": "coffee near me"
    },
    {
      "relevance": 950,
      "type": "QUERY",
      "value": "coffee shops near me"
    },
    {
      "relevance": 601,
      "type": "QUERY",
      "value": "coffee shop"
    },
    {
      "relevance": 600,
      "type": "QUERY",
      "value": "coffee table"
    }
  ],
  "total": 4,
  "verbatim_relevance": 1300,
  "request_id": "req_3f9c0d6e2b8a4c1f9e7d5b3a1c0e8f6d",
  "billed": true,
  "scraped_at": "2026-10-01T14:03:27.512Z"
}

A request that fails is saved with an error message instead (turn off Include failed requests to skip those). Failed requests are never charged.

How much does it cost?

This Actor uses pay-per-event pricing: you pay for successful API requests, not for compute time.

Event	Charged when	Price	Per 1,000
autocomplete-request	One partial query completed by Google Suggest. Empty answers are free.	$0.003	$3.00

For example, 1,000 requests in the default mode cost $3.00.

• Failed requests (errors, invalid input, blocked upstream after retries) are free.
• Requests where the source returns nothing at all (no results, nothing priced) are saved but not charged.
• Set Maximum cost per run when you start a run and the Actor stops cleanly before going over it.

FAQ

Do I need proxies or an API key?

No. Proxy rotation, retries and anti-bot handling are built in, and the Actor is ready to run as is. You only pay the per-event prices above.

How do I get hundreds of keyword ideas?

Feed seed keywords plus each letter (coffee a, coffee b, ...) or question words (how coffee, why coffee) as separate lines; each line is one cheap request.

Is Google Autocomplete the same as Google Suggest?

Yes. Google Suggest is the older name for the suggestions Google shows as you type. This Actor returns them with their type and relevance.

Which countries and languages are supported?

Any Google country and language. Suggestions differ a lot between markets, so set both to match your audience.

Is it legal to scrape this data?

The Actor collects publicly available information that anyone can see without logging in. You are responsible for how you use the results: respect the source site's terms, copyright and privacy law (such as GDPR) and do not collect personal data without a lawful basis. If in doubt, ask a lawyer.

What happens when a request is blocked or rate-limited?

Rate limits (HTTP 429) and temporary errors (5xx) are retried automatically with exponential backoff, respecting Retry-After. If a request still fails it is saved with the error message and not charged, and the rest of the batch keeps going. A run only fails when every request failed.

Why did a request return an error?

Read the error field: validation problems (for example a malformed date or an unknown id) are reported exactly as the API sees them. Fix the input and run again; failed requests cost nothing.

How many requests can I run at once?

Any number per run. The Actor sends up to 3 requests in parallel by default (change it under Run options); larger batches simply take longer.

Use it from your code

Call the Actor from any language through the Apify API. With the JavaScript client (npm install apify-client):

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('scrapercompany/google-autocomplete-scraper').call({
    "queries": [
        "coffee"
    ]
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

With Python (pip install apify-client):

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("scrapercompany/google-autocomplete-scraper").call(run_input={
    "queries": ["coffee"],
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

You can also schedule runs, chain them with webhooks, or connect them to Make, Zapier, n8n, Google Sheets and other integrations from the Integrations tab.

Related scrapers

• Google Trends Scraper
• Google SERP Scraper

Support

Questions, a field you need, or a site that stopped working? Open an issue on the Issues tab. Include the request_id from the dataset item so we can trace the request.