# ✨ Google Autocomplete Scraper (`damilo/google-autocomplete-apify`) Actor

🔍✨ Instantly grab live Google Autocomplete ideas—no proxies, no browser! 🌍 Supports 250 + countries & 100 + languages, returns clean JSON (value, relevance) and a ⚡ “cursor-before” boost for hidden gems. Perfect for SEO, PPC, content brainstorming & trend spotting.

- **URL**: https://apify.com/damilo/google-autocomplete-apify.md
- **Developed by:** [Imad](https://apify.com/damilo) (community)
- **Categories:** SEO tools
- **Stats:** 80 total users, 1 monthly users, 100.0% runs succeeded, 5 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$5.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google Autocomplete Scraper (Apify Actor)

✅ If this actor saved you time, a ⭐⭐⭐⭐⭐ review helps me keep improving!

Uncover what people *really* type into Google—instantly.

**Google Autocomplete Scraper** transforms every keystroke into ready-to-analyze JSON or CSV, letting you mine thousands of long-tail keywords, content ideas, and search intents in seconds. No browser automation, no rate-limit headaches—just clean data from Google’s “Suggest” API via Apify’s serverless platform.

***

### Table of Contents

1. [Key Benefits](#key-benefits)
2. [Popular Use Cases](#popular-use-cases)
3. [Features](#features)
4. [Input Parameters](#input-parameters)
5. [Example Input](#example-input)
6. [Output](#output)
7. [Tips & Best Practices](#tips--best-practices)
8. [Support](#support)

***

### Key Benefits

- **True User Intent** – Harvest up-to-date autocomplete phrases direct from Google, not scraped SERPs.
- **Global Coverage** – 250 ⁺ country codes + 100 ⁺ interface languages for hyper-localized suggestions.
- **Proxy‑Free** – Works out of the box; **no proxies, captchas, or residential IPs** required.
- **Cursor Tricks** – Optional “cursor before query” mode surfaces *even more* hidden keywords.
- **Blazing Fast** – Lightweight HTTP calls (no headless Chrome) deliver thousands of suggestions per minute.
- **Plug-and-Play** – One-click run in Apify UI or call via REST/SDK; export to BigQuery, S3, Airtable, Looker Studio.

***

### Popular Use Cases

| Role / Goal          | How the scraper helps                                                                                 |
| -------------------- | ----------------------------------------------------------------------------------------------------- |
| **SEO & Content**    | Build massive keyword lists, uncover question keywords (“how, why, when”), validate topical clusters. |
| **PPC & ASO**        | Discover long-tail phrases with lower CPC, craft exact-match ad groups, optimize app titles.          |
| **Product Ideation** | See what features customers expect (“*laptop with <X>*”), gauge demand before launching.              |
| **Market Research**  | Compare autocomplete differences by country/language to spot regional trends.                         |
| **Chatbot Training** | Feed intents & entities straight into NLP pipelines for smarter auto-responses.                       |

***

### Features

- 🔍 **Direct API Calls** – Pull suggestions from Google’s `/complete/search` endpoint—no HTML parsing.
- 🌍 **Country & Language Selectors** – Fine-tune results with `country` (gl param) and `language` (hl param).
- ↩️ **Cursor-Before-Query Mode** – Prepend a space ( *” query”* ) to reveal hidden suggestions.
- ⚡ **Bulk Friendly** – Chain hundreds of queries via Apify task scheduler; pay only for successful requests.
- 📊 **Relevance Scoring** – Return index order as a numeric `relevance` field for easy ranking.
- 🗂 **Clean Output** – JSON, CSV, or view in-browser table; column names: `value`, `relevance`.

***

### Input Parameters

| Key             | Type    | Required | Default | Description                                                  |
| --------------- | ------- | -------- | ------- | ------------------------------------------------------------ |
| `query`         | string  | **Yes**  | –       | Seed term (e.g. `"coffee"` or `"best laptop for"`).          |
| `country`       | string  | No       | `us`    | 2-letter country code for geo bias (`gb`, `fr`, `de`, etc.). |
| `language`      | string  | No       | `en`    | Interface language for suggestions (`es`, `de`, `ja`, etc.). |
| `cursor_before` | boolean | No       | `false` | If `true`, inserts a leading space to expand results pool.   |

> **Tip** – Combine *multiple* seeds with Apify Scheduler or API batching to build huge datasets overnight.

***

### Example Input

```json
{
  "query": "electric bike",
  "country": "ca",
  "language": "en",
  "cursor_before": true
}
```

***

### Output

The actor returns an array of suggestion objects:

```json
[
  { "value": "electric bike for adults", "relevance": 0 },
  { "value": "electric bike canada", "relevance": 1 },
  { "value": "electric bike conversion kit", "relevance": 2 }
]
```

*Lower `relevance` = higher position in Google’s drop-down.*

***

### Tips & Best Practices

1. **Seed modifiers** – Use underscore (`"coffee _"`), wildcard (`"* coffee"`), or alphabet loops (`"coffee a" … "coffee z"`) to explode keyword coverage.
2. **Compare locales** – Run the same query across `country`/`language` pairs to see regional phrasing differences.
3. **Deduplicate smartly** – Merge datasets on the `value` field; keep the *lowest* `relevance` to prioritize top suggestions.
4. **Blend with SERP data** – Pair this actor with our **Google Search Scraper** or **Shopping Scraper** for volume, CPC, and product availability.
5. **Schedule & Append** – Set a weekly run to track how autocomplete trends shift over time for seasonality insights.

***

### Support

- 💬 **Community** – Ask questions in the [Apify Discord](https://discord.gg/jyEM2PR).
- 🛠 **Custom Mods** – Need n-gram expansions, question-only filtering, or direct Sheets export? Message us via Apify.
- 🖥 **Enterprise SLA** – Dedicated proxies & guaranteed throughput available on request.

***

#### Why Choose Google Autocomplete Scraper?

Because traditional keyword tools lag behind. Get **real-time, source-of-truth user queries** in any language, feed them straight into your SEO, PPC, or product research workflow, and outrank the competition—without writing a single line of scraping code.

> **Start discovering hidden keywords—click “Try for free” and get your first dataset in under 30 seconds.**

***

Happy scraping!

# Actor input Schema

## `query` (type: `string`):

The query to search for.

## `country` (type: `string`):

Parameter defines the country to use for the Google search.

## `language` (type: `string`):

Parameter defines the language to use for the Google Autocomplete search.

## `cursor_before` (type: `boolean`):

If true, the cursor will be placed before the query. This highly increases the chance of getting more results, and highly impacts the results.

## Actor input object example

```json
{
  "query": "coffee",
  "cursor_before": false
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "coffee",
    "cursor_before": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("damilo/google-autocomplete-apify").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "coffee",
    "cursor_before": False,
}

# Run the Actor and wait for it to finish
run = client.actor("damilo/google-autocomplete-apify").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "coffee",
  "cursor_before": false
}' |
apify call damilo/google-autocomplete-apify --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,damilo/google-autocomplete-apify"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/WmuzPrm71Pt9rxqL8/builds/CjgqS50juZLRZjdRU/openapi.json