# Youtube Autocomplete Actor (`solid-scraper/youtube-autocomplete-actor`) Actor

🎬 Unlock the power of YouTube Autocomplete—discover trending keywords, boost video visibility, and rank faster with smart search suggestions. 🚀 Perfect for creators, marketers, and SEO teams to find what viewers type every day!

- **URL**: https://apify.com/solid-scraper/youtube-autocomplete-actor.md
- **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community)
- **Categories:** SEO tools, Lead generation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

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

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

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

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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

### Youtube Autocomplete Scraper 🔍

**Youtube Autocomplete Scraper** automatically fetches autocomplete suggestions for your chosen search query, helping you discover keyword ideas and search suggestions at scale. If you’re into **YouTube autocomplete scraper** workflows, **YouTube search suggestions extraction**, or building a **YouTube autocomplete keyword scraper** dataset for SEO and marketing planning, this actor is designed for you. Whether you’re a marketer, researcher, or data enthusiast, you can use this **Youtube Autocomplete Scraper** to generate structured suggestions quickly—saving you hours of manual work.

---

### Why choose Youtube Autocomplete Scraper?

| Feature | Benefit |
|---|---|
| ✅ **All-in-one autocomplete scraping** | Collects suggestions for your original query and optional prefix/suffix variants in one run |
| ✅ **Reliable, resilient fetching** | Includes error handling for request failures and parsing issues to keep runs stable |
| ✅ **Success-focused structured output** | Produces a consistent JSON structure with your query and numbered suggestions |
| ✅ **Configurable language + country targeting** | Lets you set the **Language** and **Country** used for suggestion results |
| ✅ **Scales with batch-style expansion** | Generates additional queries when **Use Prefix** and/or **Use Suffix** are enabled |
| ✅ **Automation-friendly dataset delivery** | Pushes results to the default dataset for easy export to JSON/CSV downstream |

---

### Key features

- 🔎 **Autocomplete suggestions extraction:** Retrieves suggestion phrases for your provided query
- 🌍 **Language-aware scraping:** Uses your selected **Language** setting to shape results
- 🇺🇸 **Country-aware suggestions:** Uses your selected **Country** setting for regionalized outputs
- 🧠 **Prefix and suffix expansion:** When enabled, it runs additional queries using alphabetic prefixes and suffixes to widen coverage (useful for **YouTube keyword suggestions tool** workflows)
- 📊 **Structured dataset records:** Saves each query’s results with fields named `suggestion_01`, `suggestion_02`, etc.
- 💾 **Dataset-ready output:** Uses Apify’s dataset output pattern so you can export and analyze quickly
- 🛡️ **Basic resilience via fallbacks:** Returns empty suggestions when requests fail or responses can’t be parsed, while continuing the job

---

### Input

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

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

#### Input Fields

| Field | Required | Description |
|---|---|---|
| `query` | ✅ | The search term to get autocomplete suggestions for. |
| `language` | ❌ | Select your language (used to tailor the suggestions). Defaults to `English`. |
| `country` | ❌ | Select your country (used to tailor the suggestions). Defaults to `United States`. |
| `use_prefix` | ❌ | Whether to add alphabetic prefixes to the query (e.g., variations that begin with different letters). Defaults to `false`. |
| `use_suffix` | ❌ | Whether to add alphabetic suffixes to the query (e.g., variations that end with different letters). Defaults to `false`. |

***

### Output

The actor saves your scraped autocomplete results as JSON records in the default dataset.

Example output:

```json
[
  {
    "query": "apple watch",
    "suggestion_01": "apple watch series 9",
    "suggestion_02": "apple watch deals",
    "suggestion_03": "apple watch bands",
    "suggestion_04": "apple watch price",
    "suggestion_05": "apple watch charger"
  }
]
```

#### Output Fields

| Field | Type | Description |
|---|---|---|
| `query` | string | The query used to fetch suggestions (original and/or generated variant) |
| `suggestion_01` | string | First autocomplete suggestion for the given `query` |
| `suggestion_02` | string | Second autocomplete suggestion for the given `query` |
| `suggestion_03` | string | Third autocomplete suggestion for the given `query` |
| `suggestion_04` | string | Fourth autocomplete suggestion for the given `query` |
| `suggestion_05` | string | Fifth autocomplete suggestion for the given `query` |
| `suggestion_06` | string | Sixth autocomplete suggestion for the given `query` (if present in the returned list) |
| `suggestion_07` | string | Seventh autocomplete suggestion for the given `query` (if present in the returned list) |
| `suggestion_08` | string | Eighth autocomplete suggestion for the given `query` (if present in the returned list) |
| `suggestion_09` | string | Ninth autocomplete suggestion for the given `query` (if present in the returned list) |
| `suggestion_10` | string | Tenth autocomplete suggestion for the given `query` (if present in the returned list) |

> Note: The code constructs suggestion keys using `suggestion_` followed by a zero-padded index (e.g., `suggestion_01`). The exact number of suggestion fields per record depends on the number of suggestions returned and the internal result slicing.

***

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

1. **Open Apify Console**\
   Log in at https://console.apify.com and open the **Actors** section.

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

3. **Go to the INPUT tab**\
   Configure the input fields using the form or paste an `input.json` structure.

4. **Set your query**\
   Enter your target `query` (required). This is the base keyword you want to scrape autocomplete suggestions for.

5. **Choose Language and Country**\
   Update `language` and `country` to match where your audience is located.\
   These settings help you create a **YouTube autocomplete keyword scraper** style output that’s more relevant to your research.

6. **Decide whether to use Prefix/Suffix expansion**\
   Enable `use_prefix` to expand queries with alphabetic prefixes, enable `use_suffix` to expand queries with alphabetic suffixes.\
   This is handy when you want wider coverage for **scrape YouTube autocomplete suggestions** or **YouTube related searches scraper**-like research patterns.

7. **Run the actor**\
   Click **Run**. Watch the logs for suggestion counts. If requests fail or responses can’t be parsed, the actor returns empty suggestions for that particular query and continues.

8. **Open the dataset and export**\
   After the run completes, open the default dataset in the **OUTPUT** section and export the JSON data (and convert to CSV if you use your own export workflow).

No coding required — get accurate results in minutes. 🚀

***

### Advanced features & SEO optimization

- 🚀 **Engineered for Youtube Autocomplete Scraper keyword discovery:** Great for **YouTube autocomplete scraper tool** workflows where you need suggestion lists you can feed into keyword research
- 🌐 **YouTube autocomplete data scraper targeting:** Use `language` and `country` to generate results aligned with your audience region, improving the usefulness of **YouTube search suggestions extraction**
- 🔁 **Wide coverage with prefix/suffix query expansion:** Turn on `use_prefix` and/or `use_suffix` to broaden suggestion coverage using alphabetic variants
- 🧾 **Clean, structured suggestion keys:** Output records are consistently labeled as `suggestion_01`, `suggestion_02`, etc., making it easy to analyze in spreadsheets or BI pipelines
- 📌 **Built for dataset workflows:** Results are pushed to the default dataset, so you can integrate this **YouTube autocomplete scraping software** into your automation chain

***

### Best use cases

- 📈 **SEO researchers expanding keyword lists:** Use **Youtube Autocomplete Scraper** to build a structured pool of autocomplete ideas for content planning
- 🧠 **Marketers validating audience intent:** Compare suggestion phrasing across `language`/`country` settings to sharpen messaging and targeting
- 🔍 **YouTube keyword research autocomplete:** Generate many query variations quickly to support ideation and keyword clustering
- 🗂️ **Data analysts building suggestion corpora:** Import the dataset JSON and analyze frequency, overlaps, and topical groupings
- 🧬 **Content strategists mapping related topics:** Use prefix/suffix expansion to uncover adjacent themes and long-tail angles
- 🛠️ **Developer workflows for research pipelines:** Automate repeated suggestion pulls for dashboards or ongoing keyword monitoring

***

### Technical specifications

- **Supported Input Formats**
  - ✅ JSON input matching the provided schema (`query`, `language`, `country`, `use_prefix`, `use_suffix`)
- **Proxy Support**
  - ✅ Built-in proxy support for reliable scraping
- **Retry Mechanism**
  - ✅ Includes retries and fallbacks for resilience at a high level
- **Dataset Structure**
  - ✅ JSON records containing `query` and `suggestion_XX` fields
- **Rate Limits & Performance**
  - ✅ Designed to process the original query and optional prefix/suffix variants in one run
- **Limitations**
  - ❌ If requests fail or responses can’t be parsed for a query, suggestions for that query may be empty

***

### FAQ

#### ✅ What does Youtube Autocomplete Scraper return?

It returns JSON records in your dataset, where each record includes the `query` used and autocomplete suggestions labeled as `suggestion_01`, `suggestion_02`, and so on (depending on how many suggestions are returned).

#### ✅ Do I need to provide a query every time?

Yes—`query` is required. You can also adjust `language`, `country`, `use_prefix`, and `use_suffix` to control how suggestions are generated.

#### ✅ Can I scrape suggestions for different languages and countries?

Yes. Set `language` and `country` to tailor suggestion results for your audience. This is useful for YouTube autocomplete keyword scraper workflows.

#### ✅ What are `use_prefix` and `use_suffix`?

`use_prefix` adds alphabetic prefixes to your base query, and `use_suffix` adds alphabetic suffixes. Turning them on expands the set of queries, helping you scrape YouTube autocomplete suggestions more broadly.

#### ❌ Does it require any authentication or login?

No login details are part of the input schema. The actor is intended for scraping publicly available autocomplete suggestions.

#### 💻 Can I use this in a Python or automation pipeline?

Yes. The actor outputs structured JSON into the Apify dataset, which you can export and load into your pipeline. The API/pipeline approach is compatible with typical data workflows.

#### 📦 Can I export the results to CSV?

The actor saves JSON to the default dataset. From there, you can export and convert to CSV in your downstream workflow.

#### ⚖️ Is it compliant to use this data for marketing or research?

Use the output responsibly and make sure your use complies with applicable laws and platform rules. This tool is based on publicly available data, but compliance is ultimately your responsibility.

***

### Support & feature requests

Want to improve your Youtube Autocomplete Scraper workflow? We’d love feedback. 💡

- 💡 **Feature Requests:** Examples include adding more output controls, better result slicing, or exporting directly to additional formats like CSV from the actor side.
- 📧 **Contact:** Email us at <dataforleads@gmail.com>

Your feedback helps shape the roadmap for this YouTube autocomplete keyword scraper actor.

***

*In short: the **Youtube Autocomplete Scraper** is a practical, SEO-friendly way to turn YouTube autocomplete keyword research into structured datasets—at scale.*

# 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("solid-scraper/youtube-autocomplete-actor").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("solid-scraper/youtube-autocomplete-actor").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 solid-scraper/youtube-autocomplete-actor --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Youtube Autocomplete Actor",
        "description": "🎬 Unlock the power of YouTube Autocomplete—discover trending keywords, boost video visibility, and rank faster with smart search suggestions. 🚀 Perfect for creators, marketers, and SEO teams to find what viewers type every day!",
        "version": "1.0",
        "x-build-id": "SuRC7V0J9XtWl8SxD"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/solid-scraper~youtube-autocomplete-actor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-solid-scraper-youtube-autocomplete-actor",
                "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/solid-scraper~youtube-autocomplete-actor/runs": {
            "post": {
                "operationId": "runs-sync-solid-scraper-youtube-autocomplete-actor",
                "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/solid-scraper~youtube-autocomplete-actor/run-sync": {
            "post": {
                "operationId": "run-sync-solid-scraper-youtube-autocomplete-actor",
                "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
