# Google Autocomplete Keywords - Intent & Changes (`maydit/google-autocomplete-keyword-monitor`) Actor

Collect Google autocomplete suggestions with query/rank evidence, language and country controls, intent labels and saved changes. No API key; no search-volume estimates.

- **URL**: https://apify.com/maydit/google-autocomplete-keyword-monitor.md
- **Developed by:** [Brandt May](https://apify.com/maydit) (community)
- **Categories:** SEO tools, Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.60 / 1,000 saved observations

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 Keywords - Intent & Changes

Turn seed phrases into a repeatable keyword-research watchlist. Get the exact suggestion, its position in each source response, the query that produced it, and an optional comparison with your last saved observation.

### Start with five suggestions

```json
{"seeds":["accounting software"],"maxResults":5}
```

Choose Start, then open **Keyword opportunities** or the readable report. Export CSV/JSON, or give the same input to an AI agent through Apify's API or MCP server. No source API key or paid proxy is required.

### Built for a business workflow

- SEO teams: collect language-specific topics and question phrases for editorial review.
- Product marketers: watch literal pricing, comparison and alternative queries around a category.
- Agencies: save a task per client, schedule repeats and compare only the evidence that was actually observed.

Use **Pricing and alternatives** to add explicit pricing/alternatives/vs query variations. Use **Question prefixes** for how/what/best variations. The Actor shows every generated query; it does not hide extra source requests.

| Field | Meaning |
|---|---|
| `seed`, `suggestion` | Original seed and source-returned phrase |
| `queryEvidence` | Each query, suggestion rank and exact source URL |
| `intent` | Literal rule-based alternative/comparison/pricing/question/general label |
| `language`, `country` | Requested language and country hint |
| `recordId`, `observedAt` | Stable identity and observation time |
| `comparisonStatus`, `changedFields`, `previous` | Saved observation comparison when enabled |

Intent labels are organizational rules, not predictions of a person's intent. Suggestion ranks are not Google search-result rankings. Country is a hint; request location and Google's own systems can affect results. This Actor provides **no search-volume, CPC, traffic or SEO-difficulty estimates**.

### Saved monitoring

Enable `comparePrevious`, choose a `snapshotName`, and reuse the same seeds, language, country, expansion and query cap. The first run establishes a baseline. `onlyChanges` returns only new or changed observed suggestions; an unchanged run can correctly save zero rows. History lives in your account. Only confirmed saved rows advance it. One writer per snapshot; do not overlap runs. Missing suggestions do not prove deletion or a trend reversal.

### Coverage and controls

Up to ten seeds,40 source queries and500 saved suggestions per run. Queries run sequentially at a paced rate and share a30–180second deadline. Results are deduplicated per seed and phrase; evidence retains the contributing query ranks. Maximum results can cut output short. Check SUMMARY for requested/reached queries, caps and failures before treating an export as complete. Public autocomplete can change, return no suggestions or rate-limit access. A source failure produces diagnostics, never a paid fake keyword. Robots policies are checked. No login, proxy rotation, challenge solving or access-control bypass is used.

### Pricing

Base price: **$0.001 per saved suggestion**, plus **$0.00005 per start** at default memory. Five suggestions cost $0.00505 at the base rate. Plan discounts and the Store pricing panel govern actual charges. Set a maximum run charge to cap spending. Failed source requests, reports and skipped unchanged suggestions are not billed result rows.

### Three useful recipes

```json
{"seeds":["accounting software"],"maxResults":5}
```

```json
{"seeds":["crm software"],"expansion":"commercial","maxQueries":4,"maxResults":10}
```

```json
{"seeds":["marketing software"],"language":"de","country":"DE","maxResults":5}
```

Create a task with your inputs and attach an Apify Schedule. Your own integrations can send the dataset to Sheets,n8n,Make or a data pipeline; no delivery is activated automatically.

[How Google autocomplete works](https://support.google.com/websearch/answer/7368877). This independent Mayd IT tool is not affiliated with Google. For help, open an Actor issue with a run ID and expected behavior, or contact bmay@mayd-it.com; never include credentials.

# Actor input Schema

## `seeds` (type: `array`):

Up to ten seed phrases. Empty uses accounting software.

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

Two-letter language, optionally a region such as en-US.

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

Two-letter country hint; source may also use request location.

## `expansion` (type: `string`):

Questions adds how/what/best; commercial adds pricing/alternatives/vs. All generated queries are shown in evidence.

## `maxQueries` (type: `integer`):

Shared query cap across seeds and expansions.

## `maxResults` (type: `integer`):

Maximum confirmed dataset rows saved across the run. A limit may truncate selected observations; see SUMMARY.

## `comparePrevious` (type: `boolean`):

First run establishes a baseline; reuse the same inputs and snapshot. Missing suggestions are not treated as deletions.

## `onlyChanges` (type: `boolean`):

Enables comparison. An unchanged repeat can legitimately return zero rows.

## `snapshotName` (type: `string`):

1–80 letters, numbers, underscores or hyphens. Reuse for the same watchlist; choose a new name for independent history.

## `maxRunSeconds` (type: `integer`):

Shared deadline for all source requests. Stops safely within this budget or the platform timeout, whichever is earlier.

## Actor input object example

```json
{
  "seeds": [
    "accounting software"
  ],
  "language": "en",
  "country": "US",
  "expansion": "none",
  "maxQueries": 10,
  "maxResults": 5,
  "comparePrevious": false,
  "onlyChanges": false,
  "snapshotName": "default",
  "maxRunSeconds": 60
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `summary` (type: `string`):

No description

## `report` (type: `string`):

No description

# 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 = {
    "seeds": [
        "accounting software"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("maydit/google-autocomplete-keyword-monitor").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 = { "seeds": ["accounting software"] }

# Run the Actor and wait for it to finish
run = client.actor("maydit/google-autocomplete-keyword-monitor").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 '{
  "seeds": [
    "accounting software"
  ]
}' |
apify call maydit/google-autocomplete-keyword-monitor --silent --output-dataset

```

## MCP server setup

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

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/tO8CfpVdQT2CqnOb4/builds/uicG1Ab5b2mUeUitH/openapi.json