# Google Search Autocomplete Api (`scrapers-hub/google-search-autocomplete-api`) Actor

🔎 Google Search Autocomplete API delivers real-time keyword suggestions from Google for smarter SEO, content planning & keyword research. ⚡ Fast, reliable responses to power apps, tools & dashboards. 📈 Perfect for marketers & developers!

- **URL**: https://apify.com/scrapers-hub/google-search-autocomplete-api.md
- **Developed by:** [Scrapers Hub](https://apify.com/scrapers-hub) (community)
- **Categories:** SEO tools, Developer tools, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.01 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## 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

### Google Autocomplete Scraper 🔍

**Google Autocomplete Scraper** automatically collects autocomplete suggestions for a given query, helping you turn “autocomplete keyword research” into real, actionable lists. If you’re looking for a **google autocomplete scraper**, a **google suggest scraper**, or a way to **extract google autocomplete keyword lists** for SEO and research workflows, this actor is built for you—whether you’re a marketer, data analyst, or researcher exploring search behavior at scale.

---

### Why choose Google Autocomplete Scraper?

| Feature | Benefit |
|---|---|
| ✅ All-in-one autocomplete collection | Pulls suggestions for your main query in a single run |
| ✅ Language and country targeting | Produces suggestions aligned to your selected `language` and `country` |
| ✅ Reliability-oriented execution | Includes resilience patterns so runs can complete even when some requests fail |
| ✅ Structured dataset output | Saves results in a consistent JSON structure that’s easy to import into your pipeline |
| ✅ Scale-friendly batching | Generates autocomplete keyword variants (prefix/suffix) when enabled, so you can expand coverage |
| ✅ Works well with automation | Pairs naturally with downstream steps in Apify workflows (export, transforms, analysis) |

---

### Key features

- 🔤 **Query-based suggestions**: Fetches autocomplete suggestions for your provided `query`
- 🌍 **Localized results**: Uses your selected `language` and `country` to tailor the suggestions
- 🧩 **Prefix and suffix expansion**: Optionally generates additional queries using alphabetic prefixes (`use_prefix`) and/or alphabetic suffixes (`use_suffix`)
- 🛡️ **Resilient requests**: Handles request errors gracefully and continues building the output
- 📊 **Consistent structured output**: Returns a `query` plus consistently named `suggestion_XX` fields for each set of suggestions
- 💾 **Dataset-ready results**: Saves everything into the default Apify dataset as JSON objects you can export to CSV/JSON

---

### Input

Provide input via an `input.json` file. Example structure:

```json
{
  "query": "apple watch",
  "language": "English",
  "country": "United States",
  "use_prefix": false,
  "use_suffix": true
}
````

#### Input Fields

| Field | Required | Description |
|---|---:|---|
| `query` | Yes | The search term you want autocomplete suggestions for. |
| `language` | No | Select the language used when requesting suggestions (e.g., English). |
| `country` | No | Select the country context for suggestions (e.g., United States). |
| `use_prefix` | No | Whether to add alphabetic prefixes to the query to expand your autocomplete keyword coverage. |
| `use_suffix` | No | Whether to add alphabetic suffixes to the query to expand your autocomplete keyword coverage. |

***

### Output

After execution, the actor saves your autocomplete results in JSON format. The output is an array of objects where each object represents one query variant and its suggestions.

Example output:

```json
[
  {
    "query": "apple watch",
    "suggestion_01": "apple watch series",
    "suggestion_02": "apple watch bands",
    "suggestion_03": "apple watch price"
  },
  {
    "query": "a apple watch",
    "suggestion_01": "apple watch",
    "suggestion_02": "apple watch series",
    "suggestion_03": "apple watch deals"
  }
]
```

#### Output Fields

| Field | Type | Description |
|---|---|---|
| `query` | string | The query string used for that result object (either your original query or a prefix/suffix variant). |
| `suggestion_01` | string | First autocomplete suggestion for that `query` (ordering is padded/consistent by index). |
| `suggestion_02` | string | Second autocomplete suggestion for that `query`. |
| `suggestion_03` | string | Third autocomplete suggestion for that `query`. |
| `suggestion_04` | string | Fourth autocomplete suggestion for that `query`. |
| `suggestion_05` | string | Fifth autocomplete suggestion for that `query`. |
| `suggestion_06` | string | Sixth autocomplete suggestion for that `query`. |
| `suggestion_07` | string | Seventh autocomplete suggestion for that `query`. |
| `suggestion_08` | string | Eighth autocomplete suggestion for that `query`. |
| `suggestion_09` | string | Ninth autocomplete suggestion for that `query`. |
| `suggestion_10` | string | Tenth autocomplete suggestion for that `query`. |

Note: The actor creates `suggestion_XX` fields by enumerating the returned suggestions from the autocomplete response (starting at 1 and zero-padded).

***

### How to use Google Autocomplete Scraper (via Apify Console)

1. **Open Apify Console**\
   Sign in at [console.apify.com](https://console.apify.com) and go to the **Actors** section.

2. **Find the actor**\
   Search for **Google Autocomplete Scraper** and open the actor page.

3. **Set up your INPUT**\
   In the **INPUT** pane, provide at least `query`. Optionally set `language`, `country`, `use_prefix`, and `use_suffix`.

4. **(Optional) Choose proxy settings**\
   If you use Apify Console proxy configuration, enable it according to your workflow needs. The actor is compatible with Apify’s execution environment and is designed for resilient runs.

5. **Run the actor**\
   Click **Run** to start scraping autocomplete suggestions. You’ll see logs indicating progress and any request issues.

6. **Monitor results in logs**\
   Watch for informative log lines about the run and any errors encountered during data fetching.

7. **Open the dataset**\
   After completion, open the **OUTPUT** tab to view the default dataset containing your JSON results.

8. **Export for analysis**\
   Export the dataset to your preferred format for keyword research, dashboards, or further processing—no coding required.

***

### Advanced features & SEO optimization

- 🚀 **Engineered for autocomplete keyword research**: This Google autocomplete extraction tool is designed to excel at expanding keyword lists from autocomplete-style suggestions (including keyword variants when you toggle prefix/suffix options).
- 🌐 **Localized suggestion context**: Use your chosen `language` and `country` settings to better match how users search in different markets—great for an SEO autocomplete keyword scraper workflow.
- 🔁 **Prefix/suffix expansion mode**: With `use_prefix` and `use_suffix`, you can broaden coverage for more thorough google autocomplete keyword list building.
- 🧾 **Consistent field naming for easy downstream parsing**: Output keys follow a predictable `suggestion_XX` pattern, which simplifies importing into spreadsheets or BI tools.

***

### Best use cases

- 📈 **SEO keyword research**: Generate a structured list of autocomplete suggestions to inform your content topics and keyword targeting.
- 🔎 **Market research by geography**: Compare how autocomplete suggestions shift using different `country` and `language` settings.
- 🧠 **Search intent discovery**: Use the google suggest scraper output to capture user phrasing trends and refine your keyword strategy.
- 🏗️ **Keyword expansion for content briefs**: Turn one `query` into many query variants via prefix and suffix expansion.
- 🧾 **Data analysis workflows**: Feed structured JSON into your own analytics to cluster suggestions and quantify patterns.
- 💻 **Automation pipelines**: Integrate the Google autocomplete API scraper output into repeatable reporting jobs within Apify-style automation.
- 📚 **Tool-assisted research**: Use an autosuggest scraper tool approach to speed up manual keyword list creation.

***

### Technical specifications

- **Supported Input Formats**
  - ✅ `query` as a string
  - ✅ `language` as a string chosen from the provided language list
  - ✅ `country` as a string chosen from the provided country list
  - ✅ `use_prefix` as a boolean
  - ✅ `use_suffix` as a boolean

- **Proxy Support**
  - ✅ Compatible with Apify’s proxy configuration within your run setup

- **Retry Mechanism**
  - ✅ Error handling is built in to keep runs moving when requests fail (some suggestions may be missing if requests error)

- **Dataset Structure**
  - ✅ Stores results as JSON objects in the default dataset
  - ✅ Each object contains `query` and `suggestion_XX` fields (e.g., `suggestion_01` to `suggestion_10`)

- **Rate Limits & Performance**
  - ⚠️ Performance can vary based on the number of generated query variants (especially when `use_prefix` and/or `use_suffix` are enabled)

- **Limitations**
  - ❌ Output depends on the autocomplete response returned for each query variant
  - ❌ Not all suggestions may appear if requests fail for specific variants

***

### FAQ

#### What does Google Autocomplete Scraper return?

✅ It returns autocomplete suggestions in a JSON array. Each entry includes a `query` field and a set of `suggestion_XX` fields (like `suggestion_01`, `suggestion_02`, etc.) for that query.

#### Which input field is required?

✅ Only `query` is required. You can optionally set `language`, `country`, `use_prefix`, and `use_suffix` to tailor the suggestions.

#### Can I expand results beyond the original query?

✅ Yes. Turn on `use_prefix` and/or `use_suffix` to generate additional query variants and collect autocomplete suggestions for each one.

#### Do I need coding to use it?

✅ No coding required. You can run it directly in Apify Console with an `input.json` configuration and then export the dataset.

#### Is this good for free google autocomplete scraper style keyword research?

✅ It’s designed for google autocomplete keyword research and structured collection of autocomplete suggestions. The output is ready for analysis in tools that accept JSON/CSV exports.

#### What kind of data is included—keywords only or more?

✅ This actor focuses on autocomplete suggestions only. The structured output includes `query` and `suggestion_XX` fields.

#### How do I handle large keyword batches?

✅ Use automation by running the actor with carefully chosen `query` values and enabling prefix/suffix expansion when it fits your research plan. The output remains structured for easy ingestion.

#### Is the data legal to use for marketing?

✅ The tool scrapes data from publicly available sources. It’s still your responsibility to comply with applicable laws and platform policies (including GDPR/CCPA and anti-spam rules) for your intended use.

***

### Support & feature requests

Want to improve Google Autocomplete Scraper for your autocomplete keyword scraper workflow? We’d love to hear from you.

- 💡 **Feature Requests**: Examples include adding more flexible suggestion limits per query, exporting directly in additional formats, or adding options that better fit google autocomplete extraction tool workflows.
- 📧 **Contact**: Reach out at <dataforleads@gmail.com>.

Your feedback helps shape future iterations of this google autocomplete data scraper.

***

### *Google Autocomplete Scraper* — Final thoughts

*If you’re building an SEO-friendly autocomplete keyword strategy, Google Autocomplete Scraper gives you structured suggestions you can analyze fast.* Start with a single `query` and scale with localized settings and optional prefix/suffix expansion.

***

### Disclaimer

**This actor accesses publicly accessible sources only**. It does not access private profiles, authenticated data, or password-protected content.

You are responsible for complying with applicable laws (including GDPR and CCPA), platform terms of service, and relevant anti-spam regulations. For data removal requests, contact <dataforleads@gmail.com>.

Use Google Autocomplete Scraper responsibly, ethically, and for legitimate purposes only.

# Actor input Schema

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

The search term to get suggestions for.

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

Select your language

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

Select your country

## `use_prefix` (type: `boolean`):

Whether to add alphabetic prefixes to the query.

## `use_suffix` (type: `boolean`):

Whether to add alphabetic suffixes to the query.

## Actor input object example

```json
{
  "query": "apple watch",
  "language": "English",
  "country": "United States",
  "use_prefix": false,
  "use_suffix": 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers-hub/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 = {}

# Run the Actor and wait for it to finish
run = client.actor("scrapers-hub/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 '{}' |
apify call scrapers-hub/google-search-autocomplete-api --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Search Autocomplete Api",
        "description": "🔎 Google Search Autocomplete API delivers real-time keyword suggestions from Google for smarter SEO, content planning & keyword research. ⚡ Fast, reliable responses to power apps, tools & dashboards. 📈 Perfect for marketers & developers!",
        "version": "1.0",
        "x-build-id": "q1wxnsLQxBrQ4qj5y"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapers-hub~google-search-autocomplete-api/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapers-hub-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/scrapers-hub~google-search-autocomplete-api/runs": {
            "post": {
                "operationId": "runs-sync-scrapers-hub-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/scrapers-hub~google-search-autocomplete-api/run-sync": {
            "post": {
                "operationId": "run-sync-scrapers-hub-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": [
                    "query"
                ],
                "properties": {
                    "query": {
                        "title": "Query",
                        "type": "string",
                        "description": "The search term to get suggestions for.",
                        "default": "apple watch"
                    },
                    "language": {
                        "title": "Language",
                        "enum": [
                            "Afrikaans",
                            "Akan",
                            "Albanian",
                            "Amharic",
                            "Arabic",
                            "Armenian",
                            "Azerbaijani",
                            "Basque",
                            "Belarusian",
                            "Bengali",
                            "Bihari",
                            "Bosnian",
                            "Breton",
                            "Bulgarian",
                            "Catalan",
                            "Croatian",
                            "Czech",
                            "Danish",
                            "Dutch",
                            "English",
                            "Esperanto",
                            "Estonian",
                            "Finnish",
                            "French",
                            "Frisian",
                            "Galician",
                            "Georgian",
                            "German",
                            "Greek",
                            "Guarani",
                            "Gujarati",
                            "Haitian Creole",
                            "Hausa",
                            "Hebrew",
                            "Hindi",
                            "Hungarian",
                            "Icelandic",
                            "Indonesian",
                            "Irish",
                            "Italian",
                            "Japanese",
                            "Javanese",
                            "Kannada",
                            "Kazakh",
                            "Kinyarwanda",
                            "Korean",
                            "Kurdish",
                            "Kyrgyz",
                            "Latin",
                            "Latvian",
                            "Lithuanian",
                            "Macedonian",
                            "Malagasy",
                            "Malay",
                            "Malayalam",
                            "Maltese",
                            "Maori",
                            "Marathi",
                            "Mongolian",
                            "Nepali",
                            "Norwegian",
                            "Oriya",
                            "Pashto",
                            "Persian",
                            "Polish",
                            "Portuguese",
                            "Punjabi",
                            "Quechua",
                            "Romanian",
                            "Russian",
                            "Scottish Gaelic",
                            "Serbian",
                            "Serbo-Croatian",
                            "Sesotho",
                            "Shona",
                            "Sindhi",
                            "Sinhalese",
                            "Slovak",
                            "Slovenian",
                            "Somali",
                            "Spanish",
                            "Swahili",
                            "Swedish",
                            "Tajik",
                            "Tamil",
                            "Tatar",
                            "Telugu",
                            "Thai",
                            "Tigrinya",
                            "Turkish",
                            "Turkmen",
                            "Ukrainian",
                            "Urdu",
                            "Uzbek",
                            "Vietnamese",
                            "Welsh",
                            "Xhosa",
                            "Yiddish",
                            "Yoruba",
                            "Zulu"
                        ],
                        "type": "string",
                        "description": "Select your language",
                        "default": "English"
                    },
                    "country": {
                        "title": "Country",
                        "enum": [
                            "Afghanistan",
                            "Albania",
                            "Algeria",
                            "American Samoa",
                            "Andorra",
                            "Angola",
                            "Anguilla",
                            "Antarctica",
                            "Antigua and Barbuda",
                            "Argentina",
                            "Armenia",
                            "Aruba",
                            "Australia",
                            "Austria",
                            "Azerbaijan",
                            "Bahamas",
                            "Bahrain",
                            "Bangladesh",
                            "Barbados",
                            "Belarus",
                            "Belgium",
                            "Belize",
                            "Benin",
                            "Bermuda",
                            "Bhutan",
                            "Bolivia",
                            "Bosnia and Herzegovina",
                            "Botswana",
                            "Bouvet Island",
                            "Brazil",
                            "British Indian Ocean Territory",
                            "Brunei Darussalam",
                            "Bulgaria",
                            "Burkina Faso",
                            "Burundi",
                            "Cambodia",
                            "Cameroon",
                            "Canada",
                            "Cape Verde",
                            "Cayman Islands",
                            "Central African Republic",
                            "Chad",
                            "Chile",
                            "China",
                            "Christmas Island",
                            "Cocos (Keeling) Islands",
                            "Colombia",
                            "Comoros",
                            "Congo",
                            "Congo, The Democratic Republic of the",
                            "Cook Islands",
                            "Costa Rica",
                            "Côte d'Ivoire",
                            "Croatia",
                            "Cuba",
                            "Cyprus",
                            "Czech Republic",
                            "Denmark",
                            "Djibouti",
                            "Dominica",
                            "Dominican Republic",
                            "Ecuador",
                            "Egypt",
                            "El Salvador",
                            "Equatorial Guinea",
                            "Eritrea",
                            "Estonia",
                            "Ethiopia",
                            "Falkland Islands (Malvinas)",
                            "Faroe Islands",
                            "Fiji",
                            "Finland",
                            "France",
                            "French Guiana",
                            "French Polynesia",
                            "French Southern Territories",
                            "Gabon",
                            "Gambia",
                            "Georgia",
                            "Germany",
                            "Ghana",
                            "Gibraltar",
                            "Greece",
                            "Greenland",
                            "Grenada",
                            "Guadeloupe",
                            "Guam",
                            "Guatemala",
                            "Guinea",
                            "Guinea-Bissau",
                            "Guyana",
                            "Haiti",
                            "Heard Island and Mcdonald Islands",
                            "Holy See (Vatican City State)",
                            "Honduras",
                            "Hong Kong",
                            "Hungary",
                            "Iceland",
                            "India",
                            "Indonesia",
                            "Iran, Islamic Republic of",
                            "Iraq",
                            "Ireland",
                            "Israel",
                            "Italy",
                            "Jamaica",
                            "Japan",
                            "Jordan",
                            "Kazakhstan",
                            "Kenya",
                            "Kiribati",
                            "Korea, Democratic People's Republic of",
                            "Korea, Republic of",
                            "Kuwait",
                            "Kyrgyzstan",
                            "Lao People's Democratic Republic",
                            "Latvia",
                            "Lebanon",
                            "Lesotho",
                            "Liberia",
                            "Libya",
                            "Liechtenstein",
                            "Lithuania",
                            "Luxembourg",
                            "Macao",
                            "Macedonia, The Former Yugoslav Republic of",
                            "Madagascar",
                            "Malawi",
                            "Malaysia",
                            "Maldives",
                            "Mali",
                            "Malta",
                            "Marshall Islands",
                            "Martinique",
                            "Mauritania",
                            "Mauritius",
                            "Mayotte",
                            "Mexico",
                            "Micronesia, Federated States of",
                            "Moldova, Republic of",
                            "Monaco",
                            "Mongolia",
                            "Montserrat",
                            "Morocco",
                            "Mozambique",
                            "Myanmar",
                            "Namibia",
                            "Nauru",
                            "Nepal",
                            "Netherlands",
                            "Netherlands Antilles",
                            "New Caledonia",
                            "New Zealand",
                            "Nicaragua",
                            "Niger",
                            "Nigeria",
                            "Niue",
                            "Norfolk Island",
                            "Northern Mariana Islands",
                            "Norway",
                            "Oman",
                            "Pakistan",
                            "Palau",
                            "Palestinian Territory, Occupied",
                            "Panama",
                            "Papua New Guinea",
                            "Paraguay",
                            "Peru",
                            "Philippines",
                            "Pitcairn",
                            "Poland",
                            "Portugal",
                            "Puerto Rico",
                            "Qatar",
                            "Réunion",
                            "Romania",
                            "Russian Federation",
                            "Rwanda",
                            "Saint Helena",
                            "Saint Kitts and Nevis",
                            "Saint Lucia",
                            "Saint Pierre and Miquelon",
                            "Saint Vincent and The Grenadines",
                            "Samoa",
                            "San Marino",
                            "Sao Tome and Principe",
                            "Saudi Arabia",
                            "Senegal",
                            "Serbia",
                            "Seychelles",
                            "Sierra Leone",
                            "Singapore",
                            "Slovakia",
                            "Slovenia",
                            "Solomon Islands",
                            "Somalia",
                            "South Africa",
                            "South Georgia and The South Sandwich Islands",
                            "Spain",
                            "Sri Lanka",
                            "Sudan",
                            "Suriname",
                            "Svalbard and Jan Mayen",
                            "Swaziland",
                            "Sweden",
                            "Switzerland",
                            "Syrian Arab Republic",
                            "Taiwan, Province of China",
                            "Tajikistan",
                            "Tanzania, United Republic of",
                            "Thailand",
                            "Timor-Leste",
                            "Togo",
                            "Tokelau",
                            "Tonga",
                            "Trinidad and Tobago",
                            "Tunisia",
                            "Turkey",
                            "Turkmenistan",
                            "Turks and Caicos Islands",
                            "Tuvalu",
                            "Uganda",
                            "Ukraine",
                            "United Arab Emirates",
                            "United Kingdom",
                            "United States",
                            "United States Minor Outlying Islands",
                            "Uruguay",
                            "Uzbekistan",
                            "Vanuatu",
                            "Venezuela",
                            "Viet Nam",
                            "Virgin Islands, British",
                            "Virgin Islands, U.S.",
                            "Wallis and Futuna",
                            "Western Sahara",
                            "Yemen",
                            "Zambia",
                            "Zimbabwe"
                        ],
                        "type": "string",
                        "description": "Select your country",
                        "default": "United States"
                    },
                    "use_prefix": {
                        "title": "Use Prefix",
                        "type": "boolean",
                        "description": "Whether to add alphabetic prefixes to the query.",
                        "default": false
                    },
                    "use_suffix": {
                        "title": "Use Suffix",
                        "type": "boolean",
                        "description": "Whether to add alphabetic suffixes to the query.",
                        "default": false
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
