# Google Keyword Suggestions Scraper (`datapilot/google-keyword-suggestions-scraper`) Actor

This Apify Google Suggest Scraper fetches real-time Google autocomplete suggestions for a keyword using a residential proxy. It enriches suggestions with simulated SEO metrics like search volume, CPC, competition, and trends, then saves results to the Apify Dataset.

- **URL**: https://apify.com/datapilot/google-keyword-suggestions-scraper.md
- **Developed by:** [Data Pilot](https://apify.com/datapilot) (community)
- **Categories:** SEO tools, News, Other
- **Stats:** 4 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$7.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Google Keyword Suggestions Scraper

🚀 **Google Keyword Suggestions Scraper** is a powerful Apify Actor designed to scrape **Google Keyword suggestions** in real-time. This tool extracts Google Keyword suggestions directly from Google's autocomplete API, providing a list of related Google Keyword terms based on your input keyword. Whether you're conducting SEO research, content planning, or keyword analysis, the Google Keyword Suggestions Scraper delivers accurate **Google Keyword data** efficiently.

With residential proxy support, the Google Keyword Suggestions Scraper ensures undetected and reliable scraping of **Google Keyword suggestions**. It focuses on key **Google Keyword metrics** like search volume, competition, and CPC estimates, making it an indispensable tool for **Google Keyword research** and optimization.

### 🔥 Features

- **Real-Time Google Keyword Extraction** – Scrapes live **Google Keyword suggestions** from Google's autocomplete API for authentic **Google Keyword data**.
- **Data Enrichment** – Adds simulated metrics to **Google Keyword suggestions**, including search volume, competition levels, and CPC ranges for comprehensive **Google Keyword analysis**.
- **Geographic and Language Targeting** – Supports location and language parameters to tailor **Google Keyword suggestions** to specific regions and languages.
- **Residential Proxy Support** – Uses Apify's residential proxies to bypass restrictions and ensure high success rates for **Google Keyword scraping**.
- **Fallback Mechanisms** – Includes fallback templates if the **Google Keyword API** call fails, guaranteeing **Google Keyword** results.
- **Batch Processing** – Processes single keywords with multiple **Google Keyword suggestions** in one run.
- **Error Handling** – Robust logging for issues during **Google Keyword scraping**.
- **Dataset Integration** – Automatically uploads **Google Keyword suggestions** to your Apify dataset for easy export and analysis.

***

### ⚙️ How It Works

The Google Keyword Suggestions Scraper queries Google's suggestqueries API to fetch real **Google Keyword suggestions** for the input keyword. It then enriches each **Google Keyword suggestion** with simulated metrics like search volume and competition. This hybrid approach provides realistic **Google Keyword data** quickly and reliably.

**Key benefits for Google Keyword analysis:**

- Discover trending Google Keyword suggestions.
- Analyze Google Keyword competition and potential costs.
- Enhance Google Keyword research for SEO campaigns.
- Identify long-tail Google Keyword variations.
- Research geographic and language-specific keywords.

***

### 📥 Input

The Actor accepts the following input parameters:

| Field        | Type   | Default | Description |
|--------------|--------|---------|-------------|
| `keyword`    | string | `"seo"` | The base keyword to generate Google Keyword suggestions for (e.g., `"SEO"`). |
| `location`   | string | `"US"`  | Location code for Google Keyword suggestions (e.g., `"US"`, `"IN"`, `"GB"`). |
| `lang`       | string | `"en"`  | Language code for Google Keyword suggestions (e.g., `"en"`, `"es"`, `"fr"`). |

**Example input JSON:**

```json
{
  "keyword": "SEO",
  "location": "US",
  "lang": "en"
}
```

***

### 📤 Output

The scraper outputs detailed **Google Keyword suggestions** in JSON format. Each record includes:

| Field              | Type   | Description |
|--------------------|--------|-------------|
| `keyword`          | string | The original keyword for Google Keyword suggestions. |
| `suggestion`       | string | A Google Keyword suggestion from Google's API. |
| `location`         | string | Location code used for Google Keyword scraping. |
| `lang`             | string | Language code used for Google Keyword scraping. |
| `search_volume`    | int    | Simulated search volume for the Google Keyword suggestion. |
| `competition`      | string | Competition level (`"LOW"`, `"MEDIUM"`, `"HIGH"`) for the Google Keyword. |
| `cpc_low_bid`      | float  | Low bid CPC for the Google Keyword. |
| `cpc_high_bid`     | float  | High bid CPC for the Google Keyword. |
| `trend_percentage` | float  | Trend percentage for the Google Keyword. |
| `scrapedAt`        | string | ISO timestamp of the Google Keyword scrape. |

**Example output for a Google Keyword suggestion:**

```json
{
  "keyword": "SEO",
  "suggestion": "seo tutorial",
  "location": "US",
  "lang": "en",
  "search_volume": 45678,
  "competition": "MEDIUM",
  "cpc_low_bid": 1.23,
  "cpc_high_bid": 12.45,
  "trend_percentage": 45.67,
  "scrapedAt": "2025-02-14T12:00:00Z"
}
```

**Example summary record:**

```json
{
  "summary": true,
  "keyword": "SEO",
  "total_suggestions": 10,
  "average_search_volume": 48500,
  "average_cpc_low": 1.45,
  "average_cpc_high": 11.80,
  "competition_breakdown": {
    "LOW": 3,
    "MEDIUM": 5,
    "HIGH": 2
  },
  "locations_queried": ["US"],
  "languages": ["en"],
  "completed_at": "2025-02-14T12:35:00Z"
}
```

***

### 🧰 Technical Stack

- **Core Scraper:** Google Keyword suggestions API integration with real-time data enrichment.
- **Proxy:** Apify Proxy with optional RESIDENTIAL support for enhanced reliability.
- **Platform:** Apify Actor – serverless, scalable, integrated with Dataset and Key‑Value Store.
- **Deployment:** One‑click run on Apify Console or via REST API.

***

### 🎯 Use Cases

- **SEO Keyword Research** – Extract real Google Keyword suggestions for your SEO strategy.
- **Content Planning** – Discover Google Keyword suggestions to guide content creation topics.
- **Long-Tail Keyword Discovery** – Find extended Google Keyword suggestions for niche targeting.
- **Geographic SEO** – Research location-specific Google Keyword suggestions for local SEO.
- **Multilingual SEO** – Discover keywords in different languages for international campaigns.
- **PPC Campaign Optimization** – Analyze Google Keyword suggestions with CPC data for Google Ads.
- **Competitive Analysis** – Research which Google Keyword suggestions competitors might target.
- **Trend Analysis** – Monitor trending Google Keyword suggestions over time.
- **Content Gap Analysis** – Identify keyword opportunities through Google Keyword suggestions.
- **E-commerce Optimization** – Find product-related Google Keyword suggestions for better visibility.
- **Academic Research** – Collect real Google Keyword data for SEO and digital marketing studies.
- **Market Intelligence** – Understand emerging keywords in your industry through Google suggestions.

***

### 🚀 Quick Start

1. **Open in Apify Console** – visit the Actor page and click Try for free.
2. **Enter a keyword** in the input field (e.g., `"SEO"` or `"Web Development"`).
3. **(Optional) Select location and language** – default is US and English.
4. **Click Start** – the Actor will scrape real Google Keyword suggestions.
5. **Export** – download the results as JSON, CSV, or Excel.

You can also call this Actor programmatically via Apify SDK or REST API – ideal for automated SEO workflows and real-time keyword research pipelines.

***

### 💎 Why This Actor?

| Feature | Benefit |
|---------|---------|
| ✅ Real-time data | Scrape live Google Keyword suggestions directly from Google's API. |
| ✅ Rich metrics | Receive search volume, competition, and CPC estimates for each keyword. |
| ✅ Geographic targeting | Research keywords specific to different countries and regions. |
| ✅ Multilingual support | Get keyword suggestions in different languages. |
| ✅ Fallback systems | Guaranteed results even if API fails (uses fallback templates). |
| ✅ Accurate data | Direct integration with Google's autocomplete ensures authenticity. |
| ✅ Easy integration | Clean JSON output ready for analysis and visualization. |
| ✅ Apify ecosystem | Seamless integration with other Actors, triggers, and webhooks. |

### 📦 Changelog

- Initial release with real-time Google Keyword suggestions extraction.
- Direct integration with Google's autocomplete API.
- Enriched data with simulated search volume, competition, and CPC metrics.
- Support for geographic and language targeting.
- Fallback mechanisms for API reliability.
- Batch processing for multiple keywords.
- Robust error handling and logging.
- Summary statistics with competition breakdown.
- Full Apify Actor integration.

***

### 🧑‍💻 Support & Feedback

- **Issues & Ideas:** Open a ticket on the Apify Actor issue tracker.
- **Documentation:** Visit Apify Docs for platform guides.
- **Community:** Join the Apify community forum for discussions and support.

***

### 💰 Pricing

- **Free** for basic usage on Apify platform.
- **Paid plans** available for higher limits and priority support.
- Proxy credits consumed only if residential proxies are enabled.

# Actor input Schema

## `keyword` (type: `string`):

Enter main keyword to generate suggestions

## `location` (type: `string`):

Geographic location for keywords

## `lang` (type: `string`):

Language for keyword suggestions

## `useResidentialProxy` (type: `boolean`):

Enable Apify Residential Proxy (optional)

## `proxyCountry` (type: `string`):

Select country for proxy routing

## `upload_to_dataset` (type: `boolean`):

Save results to Apify dataset

## Actor input object example

```json
{
  "location": "US",
  "lang": "en",
  "useResidentialProxy": false,
  "proxyCountry": "US",
  "upload_to_dataset": true
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("datapilot/google-keyword-suggestions-scraper").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("datapilot/google-keyword-suggestions-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{}' |
apify call datapilot/google-keyword-suggestions-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=datapilot/google-keyword-suggestions-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/qNxFwYJbL80XhZXSK/builds/hrlQsjtG0jIEFOVoO/openapi.json