# Google Search Autocomplete API (`scraper-engine/google-search-autocomplete-api`) Actor

Scrape Google Search autocomplete suggestions in real time. Collect keyword ideas, query variations, trending searches, and long-tail phrases at scale. Ideal for SEO research, content planning, PPC targeting, and market analysis. Export structured results in JSON, CSV, or Excel.

- **URL**: https://apify.com/scraper-engine/google-search-autocomplete-api.md
- **Developed by:** [Scraper Engine](https://apify.com/scraper-engine) (community)
- **Categories:** Automation, Lead generation, Social media
- **Stats:** 6 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$14.99/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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

### What does Google Search Autocomplete API Scraper do? 🤖✨

The Google Search Autocomplete API scraper is a powerful tool that extracts real-time Google search suggestions, helping you analyze trending queries, user intent, and long-tail keywords. By pulling data directly from autocomplete predictions, you get an instant snapshot of what users are actively searching for. This is ideal for SEO research, keyword clustering, competitor analysis, and content planning.

Using the Google Autocomplete API gives you access to structured data that search engines rely on—making it easier to identify semantically related terms, high-intent keywords, and topic gaps. Whether you're exploring google search suggestions API, autocomplete search API, or trying to understand what is Google Autocomplete, this scraper delivers clean, actionable, JSON-formatted insights perfect for SEO workflows. 🔍💡

### 🛠️ Support and Feedback

- 🐞 **Bug reports:** Open a ticket in the repository **Issues** section  
- ✨ **Custom solutions or feature requests:** Contact our team 📧 **Email:** dev.scraperengine@gmail.com


### What Google Search Autocomplete API can I extract? 📥📊

Below is a detailed table showing the data fields you can extract using the Google Search Autocomplete API scraper:

| Data Type | Description |
| --- | --- |
| Suggestion Text | The autocomplete suggestion generated by Google |
| Search Intent Clusters | Grouped keyword categories based on prediction patterns |
| Related Keywords | Variations and long-tail terms linked to your query |
| Rank/Order | Suggestion position in Google results |
| Source Engine | Google Web, Maps, or other query endpoints |
| Language / Locale | Region-specific suggestion differences |
| Query Input | The seed keyword used for fetching autocomplete results |

This scraper supports broad use cases—from google search query autocomplete API to google map API search autocomplete, allowing marketers, developers, and researchers to extract accurate results at scale. With the ability to handle multilingual predictions and niche categories like google autocomplete types, the dataset becomes a goldmine for SEO optimization. 🌍✨

* * *

#### ⭐ Key Features of Google Search Autocomplete API Scraper ⚙️🚀

*   Real-Time Suggestions — Extract live Google search suggestions API JSON responses to understand trending search behavior.  
      
    
*   Multi-Platform Support — Works with Google Web Search, Maps, Places, Android, and even google search autocomplete API JavaScript environments.  
      
    
*   High Scalability — Designed to collect thousands of predictions in bulk without performance issues.  
      
    
*   Keyword Expansion — Ideal for SEO teams looking for long-tail keywords, semantic variations, and content gaps.  
      
    
*   Regional & Language Filters — Target specific markets for highly personalized insights.  
      
    
*   Clean JSON Output — Perfect for developers integrating with search autocomplete PHP, Python, Node.js, and other stacks.  
      
    
*   Fast & Lightweight — Optimized for speed so you can run hundreds of queries in minutes.  
      
    
*   Flexible Input Options — Works with multiple queries, custom prefixes, and advanced dataset segmentation.  
      
    

This feature-rich scraper gives marketers, researchers, and dev teams the competitive advantage they need to stay ahead of search trends. 🔎📈

##🔗 What are other Google scraping tools?

If you want to scrape specific Google data, you can use any of the dedicated scrapers below for faster and more targeted results.  
Just enter keywords, search queries, place names, app links, or URLs and start scraping instantly.

| [🖼️ Google Images Scraper](https://apify.com/scraper-engine/google-images-scraper) | [✈️ Google Flights Scraper](https://apify.com/scraper-engine/google-flights-scraper) |
|---|---|
| [📰 Google News Scraper](https://apify.com/scraper-engine/google-news-scraper) | [📢 Google Ads Scraper](https://apify.com/scraper-engine/google-ads-scraper) |
| [🏨 Google Hotels Scraper](https://apify.com/scraper-engine/google-hotels-scraper) | [📈 Google Trends Scraper](https://apify.com/scraper-engine/google-trends-scraper) |
| [📱 Google Play Data Extractor](https://apify.com/scraper-engine/google-play-scraper) | [⭐ Google Play Store Reviews Scraper](https://apify.com/scraper-engine/google-play-store-reviews-scraper) |
| [🗺️ Google Maps Reviews Scraper](https://apify.com/scraper-engine/google-maps-reviews-scraper) | [📧 Google Play Email Scraper](https://apify.com/scraper-engine/google-play-email-scraper) |
| [📍 Google Maps Extractor](https://apify.com/scraper-engine/google-maps-extractor) | [🧭 Google Maps Scraper](https://apify.com/scraper-engine/google-maps-scraper) |
| [📧 Google Maps Email Scraper](https://apify.com/scraper-engine/google-maps-email-scraper) | [📱 Google Play Store App Search Scraper](https://apify.com/scraper-engine/google-play-store-app-search-scraper) |
| [📨 Google Maps Email Extractor](https://apify.com/scraper-engine/google-maps-email-extractor) | [📞 Google Maps Phone Number Extractor](https://apify.com/scraper-engine/google-maps-phone-number-extractor) |
| [☎️ Google Play Phone Number Scraper](https://apify.com/scraper-engine/google-play-phone-number-scraper) | [📞 Google Maps Phone Number Scraper](https://apify.com/scraper-engine/google-maps-phone-number-scraper) |


### How to use Google Search Autocomplete API 🧑‍💻🛠️

Follow this simple step-by-step guide to get started:

1.  Log in to Apify — Create a free account or sign in.  
      
    
2.  Select the Actor — Search for “Google Search Autocomplete API” in the Apify Store.  
      
    
3.  Enter Input Data — Add your keywords or URLs into the startUrls or queries field.  
      
    
4.  Choose Options — Adjust language, region, prefix settings, or limit results.  
      
    
5.  Run the Actor — Click Start, and the scraper will automatically gather autocomplete predictions.  
      
    
6.  Download Results — Export as JSON, CSV, Excel, or integrate via API/Apify dataset.  
      
    

This workflow works flawlessly whether you're building google search console API tutorial tools, google search autocomplete API Android apps, or ngx google places autocomplete search bars. ⚡📥

* * *

### 🎯 Use Cases

The Google Search Autocomplete API scraper is an incredibly versatile tool. Here are real-world applications:

#### 💼 Marketing & SEO

*   Extract long-tail search queries for topic clustering  
      
    
*   Identify trending topics before competitors  
      
    
*   Build keyword strategies using google autocomplete API insights  
      
    

#### 📱 App & Web Development

*   Create intelligent search bars using autocomplete search API  
      
    
*   Build location-based search tools with google map API search autocomplete  
      
    
*   Enhance user experience with real-time predictions  
      
    

#### 🎓 Research & Data Analysis

*   Track global search sentiment changes  
      
    
*   Analyze query diversity across regions  
      
    
*   Collect datasets for NLP, machine learning, and AI models  
      
    

#### 🛒 E-Commerce

*   Predict buyer intent  
      
    
*   Optimize product listing keywords  
      
    
*   Enhance internal site search functionality  
      
    

* * *

### Why choose us? ⭐💙

*   High Accuracy — Data mirrors real Google predictions.  
      
    
*   SEO-Focused — Optimized for Google keyword research workflows.  
      
    
*   Easy Integration — Works with APIs, automation workflows, and analytics tools.  
      
    
*   Lightning Fast — Fetches suggestions in milliseconds across thousands of queries.  
      
    
*   Scalable Architecture — Suitable for enterprises, agencies, and startups.  
      
    
*   Trusted by Professionals — Marketers, developers, and analysts use our scraper for high-impact results.  
      
    

No matter whether you're researching google places autocomplete example or building an address autocomplete API free solution, this scraper gives you everything you need. 🌟

* * *

### How many results can you scrape with Google Search Autocomplete API? 📈⚡

The Google Search Autocomplete API scraper is engineered for high-volume performance. Whether you're querying a handful of keywords or thousands of prefixes, this tool handles massive workloads quickly and reliably.

Here’s what you can expect:

*   Unlimited Queries — Run as many keywords as you want by batching input lists.  
      
    
*   High-Throughput Processing — Supports parallelization for large-scale SEO audits.  
      
    
*   Complex Prefix Mapping — You can generate predictions using A–Z, 0–9, multi-word phrases, and advanced prefix strategies to discover millions of keyword variations.  
      
    
*   Regional Scaling — Collect autocomplete data across dozens of languages and regions simultaneously.  
      
    
*   Developer-Friendly — Perfect for API-driven automation, dashboards, keyword clustering systems, and NLP pipelines.  
      
    

When used strategically (e.g., prefix expansion + geo-localization), the Google Search Autocomplete API can generate tens of thousands of unique suggestions in a single session—making it one of the most powerful autocomplete data extraction tools available. 🚀📊

* * *

### Is it legal to scrape Google Search Autocomplete API? ⚖️🔍

Scraping Google Autocomplete predictions is generally legal when done responsibly. Autocomplete data is publicly accessible, but it’s important to follow:

*   Platform terms of service  
      
    
*   Ethical data usage practices  
      
    
*   Respect for rate limits  
      
    
*   Compliance with local laws  
      
    

The scraper is designed to collect publicly available information, not access private user data. Always use the data for legitimate purposes such as research, SEO strategy, application development, or user-experience optimization. When in doubt, review Google’s policies or seek legal advice specific to your region. ⚖️😊

* * *

### Input Parameters 🧩📥

#### JSON Example

```json
{
    "proxyConfiguration": {
        "useApifyProxy": true
    },
    "queries": [
        "how to lose weight",
        "Machine Learning",
        "pixel 4xl",
        "web scraping"
    ],
    "usePrefix": true,
    "useSuffix": true
}
````

### Output Format 📤📊

#### JSON Example

```json
 {
    "query": "how to lose weight",
    "total_suggestions": 411,
    "suggestions": [
      "how to lose weight fast",
      "how to lose weight",
      "how to lose weight in face",
      "how to lose weight quickly",
      "how to lose weight without exercising",
      "how to lose weight while breastfeeding",
      "how to lose weight with pcos",
      "how to lose weight during menopause",
      "how to lose weight during perimenopause",
      "how to lose weight fast naturally and permanently",
      "a to lose weight",
      "a diet to lose weight",
      "a diet to lose weight fast",
      "a drink to lose weight",
      "a shot to lose weight",
      "a workout to lose weight",
      "a way to lose weight fast",
      "a breakfast to lose weight",
      "a medicine to lose weight",
      "a tea to lose weight",
      "how b to lose weight quick",
      "b vitamins to lose weight",
      "lose weight b",
      "b positive diet to lose weight",
      "b+ blood type to lose weight",
      "b simone lose weight",
      "how to lose weight for b positive blood type",
      "how to lose plan b weight",
      "c section how to lose weight after",
      "how to lose weight c section",
      "weight loss c",
      "vitamin c to lose weight",
      "c section harder to lose weight",
      "c section lose weight fast",
      "c diff lose weight",
      "how to lose weight after c section delivery",
      "how to lose weight post c section",
      "how to lose weight after c section while breastfeeding",
      "weight loss d",
      "how to lose weight so fast",
      "vitamin d to lose weight",
      "vitamin d to lose weight fast",
      "how'd you lose weight reddit",
      "how to lose weight after d&c",
      "how to lose weight with vitamin d deficiency",
      "how to lose weight in 7 d",
      "e bike to lose weight",
      "exercises to lose weight",
      "how to lose weight e",
      "how to lose weight e book",
      "test e to lose weight",
      "e coli lose weight",
      "how to lose weight without e",
      "how to lose weight fast e",
      "how to reduce weight loss at home",
      "how to lose weight what foods to eat",
      "how to lose weight if",
      "how to lose fat effortlessly",
      "how do you physically lose weight",
      "how to lose weight g",
      "g of protein to lose weight",
      "g dragon lose weight",
      "how many g protein to lose weight",
      "how many g carbs to lose weight",
      "how many g of fat to lose weight",
      "how many g of sugar to lose weight",
      "how many g protein a day to lose weight",
      "how many grams should i eat to lose weight",
      "how to slim my gut",
      "how to lose weight h",
      "h pylori unable to lose weight",
      "h pylori hard to lose weight",
      "h pylori lose weight",
]
```

### FAQ ❓💡

#### 1. What is Google Autocomplete?

Google Autocomplete predicts search queries based on user behavior, trends, and intent.

#### 2. Is the Google Search Autocomplete API free?

The scraper is free to run on Apify with usage-based limits.

#### 3. Can I use this with PHP?

Yes! Output comes in JSON, perfect for search autocomplete PHP integrations.

#### 4. Does it work for mobile apps?

Yes, developers use it for Google Search Autocomplete API Android projects.

#### 5. Can I get location-based predictions?

Absolutely—use country and language parameters to refine results.

#### 6. Is this the same as Google Maps Autocomplete?

Similar, but Maps focuses on places and addresses, while Search Autocomplete focuses on keywords.

#### 7. Can I build my own search bar?

Yes! The API powers custom autocomplete search API experiences for apps and websites.

#### 8. Does it support JavaScript?

Yes, results integrate seamlessly with Google search autocomplete API JavaScript workflows.

### ⭐ Conclusion

The Google Search Autocomplete API is an essential tool for SEO, developers, and researchers who want deeper insights into real user search behavior. By leveraging real-time suggestions, you can uncover valuable keywords, optimize content, and build smarter search experiences with speed, accuracy, and scalability. 🚀

# Actor input Schema

## `queries` (type: `array`):

Enter keywords or phrases — one per line. Add multiple for bulk scraping.

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

Language of the suggestions

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

Target country for location-specific suggestions

## `usePrefix` (type: `boolean`):

Add a-z before each keyword (e.g. a apple, b apple) for more results

## `useSuffix` (type: `boolean`):

Add a-z after each keyword (e.g. apple a, apple b) for more results

## `proxyConfiguration` (type: `object`):

Optional: Use proxies for higher volume or to avoid blocks

## Actor input object example

```json
{
  "queries": [
    "how to lose weight"
  ],
  "language": "English",
  "country": "United States",
  "usePrefix": false,
  "useSuffix": false,
  "proxyConfiguration": {
    "useApifyProxy": 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 = {
    "queries": [
        "how to lose weight"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraper-engine/google-search-autocomplete-api").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 = {
    "queries": ["how to lose weight"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("scraper-engine/google-search-autocomplete-api").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 '{
  "queries": [
    "how to lose weight"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call scraper-engine/google-search-autocomplete-api --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Search Autocomplete API",
        "description": "Scrape Google Search autocomplete suggestions in real time. Collect keyword ideas, query variations, trending searches, and long-tail phrases at scale. Ideal for SEO research, content planning, PPC targeting, and market analysis. Export structured results in JSON, CSV, or Excel.",
        "version": "0.1",
        "x-build-id": "ivode12lnp1iVzdhv"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scraper-engine~google-search-autocomplete-api/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scraper-engine-google-search-autocomplete-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/scraper-engine~google-search-autocomplete-api/runs": {
            "post": {
                "operationId": "runs-sync-scraper-engine-google-search-autocomplete-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/scraper-engine~google-search-autocomplete-api/run-sync": {
            "post": {
                "operationId": "run-sync-scraper-engine-google-search-autocomplete-api",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "queries"
                ],
                "properties": {
                    "queries": {
                        "title": "📌 Keywords",
                        "type": "array",
                        "description": "Enter keywords or phrases — one per line. Add multiple for bulk scraping.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "language": {
                        "title": "🌐 Language",
                        "enum": [
                            "English",
                            "Spanish",
                            "French",
                            "German",
                            "Italian",
                            "Portuguese",
                            "Russian",
                            "Japanese",
                            "Korean",
                            "Chinese",
                            "Arabic",
                            "Hindi",
                            "Bengali",
                            "Turkish",
                            "Vietnamese",
                            "Polish",
                            "Dutch",
                            "Swedish",
                            "Danish",
                            "Norwegian",
                            "Finnish",
                            "Czech",
                            "Hungarian",
                            "Romanian",
                            "Greek",
                            "Hebrew",
                            "Thai",
                            "Indonesian",
                            "Malay",
                            "Filipino",
                            "Ukrainian",
                            "Bulgarian",
                            "Croatian",
                            "Slovenian",
                            "Slovak",
                            "Lithuanian",
                            "Latvian",
                            "Estonian",
                            "Icelandic",
                            "Irish",
                            "Welsh",
                            "Basque",
                            "Catalan",
                            "Galician",
                            "Afrikaans",
                            "Swahili",
                            "Zulu",
                            "Xhosa",
                            "Amharic",
                            "Somali",
                            "Yoruba",
                            "Hausa",
                            "Igbo",
                            "Persian",
                            "Urdu",
                            "Tamil",
                            "Telugu",
                            "Kannada",
                            "Malayalam",
                            "Marathi",
                            "Gujarati",
                            "Punjabi",
                            "Nepali",
                            "Sinhala",
                            "Burmese",
                            "Khmer",
                            "Lao",
                            "Mongolian",
                            "Tibetan",
                            "Georgian",
                            "Armenian",
                            "Azerbaijani",
                            "Kazakh",
                            "Uzbek",
                            "Turkmen",
                            "Kyrgyz",
                            "Tajik"
                        ],
                        "type": "string",
                        "description": "Language of the suggestions",
                        "default": "English"
                    },
                    "country": {
                        "title": "📍 Country",
                        "enum": [
                            "United States",
                            "United Kingdom",
                            "Canada",
                            "Australia",
                            "Germany",
                            "France",
                            "Spain",
                            "Italy",
                            "Brazil",
                            "Mexico",
                            "Argentina",
                            "Chile",
                            "Colombia",
                            "Peru",
                            "Russia",
                            "Ukraine",
                            "Poland",
                            "Netherlands",
                            "Belgium",
                            "Switzerland",
                            "Austria",
                            "Sweden",
                            "Norway",
                            "Denmark",
                            "Finland",
                            "Portugal",
                            "Ireland",
                            "Czech Republic",
                            "Hungary",
                            "Slovakia",
                            "Slovenia",
                            "Croatia",
                            "Greece",
                            "Bulgaria",
                            "Romania",
                            "Turkey",
                            "China",
                            "Japan",
                            "South Korea",
                            "India",
                            "Pakistan",
                            "Bangladesh",
                            "Indonesia",
                            "Malaysia",
                            "Thailand",
                            "Philippines",
                            "Vietnam",
                            "Singapore",
                            "New Zealand",
                            "South Africa",
                            "Egypt",
                            "Nigeria",
                            "Kenya",
                            "Morocco",
                            "Tunisia",
                            "Algeria",
                            "Saudi Arabia",
                            "United Arab Emirates",
                            "Israel",
                            "Jordan",
                            "Lebanon",
                            "Iran",
                            "Iraq",
                            "Kuwait",
                            "Qatar",
                            "Oman",
                            "Bahrain",
                            "Yemen",
                            "Syria"
                        ],
                        "type": "string",
                        "description": "Target country for location-specific suggestions",
                        "default": "United States"
                    },
                    "usePrefix": {
                        "title": "⚡ Prefix expansion",
                        "type": "boolean",
                        "description": "Add a-z before each keyword (e.g. a apple, b apple) for more results",
                        "default": false
                    },
                    "useSuffix": {
                        "title": "⚡ Suffix expansion",
                        "type": "boolean",
                        "description": "Add a-z after each keyword (e.g. apple a, apple b) for more results",
                        "default": false
                    },
                    "proxyConfiguration": {
                        "title": "🔒 Proxy",
                        "type": "object",
                        "description": "Optional: Use proxies for higher volume or to avoid blocks"
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
