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

🎬 “YouTube Autocomplete Actor” predicts and completes actor names in YouTube search—fast, accurate suggestions to boost discovery and search efficiency. 🚀 Perfect for casting research, creators, and video marketers. ✅ Save time & rank higher!

- **URL**: https://apify.com/scraperoka/youtube-autocomplete-actor.md
- **Developed by:** [Scraperoka](https://apify.com/scraperoka) (community)
- **Categories:** AI, SEO tools, Videos
- **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.

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

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

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

# README

### Youtube Autocomplete Scraper 🎯

Manually collecting YouTube autocomplete suggestions across many queries wastes time you don’t have. **Youtube Autocomplete Scraper** pulls autocomplete keyword ideas for your chosen query, language, and country—perfect for marketers, researchers, and growth teams who need thousands of suggestion records in minutes.

***

### What You Get: Sample Output

Here's a sample record from a single run:

```json
{
  "query": "apple watch",
  "suggestion_01": "apple watch series",
  "suggestion_02": "apple watch deals",
  "suggestion_03": "apple watch se",
  "suggestion_04": "apple watch bands",
  "suggestion_05": "apple watch waterproof",
  "suggestion_06": "apple watch 9",
  "suggestion_07": "apple watch ultra"
}
```

| Field | Type | What It Tells You |
|---|---|---|
| `query` | string | The exact query you asked for (or an auto-generated prefix/suffix variant) |
| `suggestion_01` | string | Your top autocomplete suggestion for the query |
| `suggestion_02` | string | A second high-signal autocomplete keyword idea |
| `suggestion_03` | string | Another suggestion you can use for keyword research |
| `suggestion_04` | string | A follow-on phrase to expand your content or ads |
| `suggestion_05` | string | Fifth suggestion for rapid ideation and clustering |
| `suggestion_06` | string | Additional variation (useful for broader keyword coverage) |
| `suggestion_07` | string | More autocomplete ideas to expand lists and briefs |
| `suggestion_08` | string | Continues the ranked suggestions (up to your `max_results`) |
| `suggestion_09` | string | Useful when you want deeper suggestion coverage |
| `suggestion_10` | string | Useful when you want a consistent “top 10” set |
| `error_message` | string | Present only when a request fails (error details are logged; failed calls return an empty list) |

Export your dataset as JSON, CSV, or Excel — straight from the Apify dashboard.

***

### Why Youtube Autocomplete Scraper?

There are a lot of ways to pull data from YouTube autocomplete ideas—here’s what sets **Youtube Autocomplete Scraper** (and YouTube search autocomplete scraper workflows) apart.

#### Query-to-record structure made for analysis

Results are pushed as records where each `query` contains a ranked set of `suggestion_XX` fields. That makes it easy to turn YouTube autocomplete keyword research data into spreadsheets, dashboards, and keyword clusters.

#### Language and country targeting for more relevant ideas

By selecting `language` and `country`, you can generate autocomplete suggestions in the context you care about. This is especially helpful when using the Youtube autocomplete scraper for regional keyword research and content planning.

#### Completes more work automatically with prefix/suffix expansion

If you enable `use_prefix` and/or `use_suffix`, the actor generates additional queries with alphabetic prefixes and suffixes and collects suggestions for each one. This is a practical way to grow lists using a YouTube autocomplete suggestions scraper tool approach without manually typing hundreds of variations.

#### Output you can export immediately

The actor pushes results to the default dataset under an event name of `result`. From there, you can export the dataset and feed it into your existing pipelines (CSV/Excel/JSON) with minimal cleanup.

***

### Configuring Your Run

Drop this into your `input.json` to get started:

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

| Parameter | Required | What It Does |
|---|---:|---|
| `query` | ✅ | The search term to get suggestions for (for example, “apple watch”) |
| `language` | ⬜ | Selects the language used for suggestions |
| `country` | ⬜ | Selects the country context for suggestions |
| `use_prefix` | ⬜ | Whether to add alphabetic prefixes to the query |
| `use_suffix` | ⬜ | Whether to add alphabetic suffixes to the query |

***

### Core Capabilities

#### Autocomplete keyword extraction (ranked)

Youtube Autocomplete Scraper returns autocomplete suggestions as a ranked list, stored as `suggestion_01`, `suggestion_02`, and so on. This makes it easy to build a YouTube keyword autocomplete extractor dataset for ideation and keyword research.

#### Input flexibility for targeted research

You can set `query`, pick a `language`, and choose a `country` to generate suggestions that match your audience context. This makes Youtube search autocomplete scraper runs more useful for real-world content and campaign planning.

#### Faster list building with prefix/suffix expansion

With `use_prefix` and/or `use_suffix`, the actor expands your seed query into many additional query variants automatically. That’s ideal when you’re using a YouTube autocomplete crawler mindset—generate ideas broadly, then analyze.

#### Resilient fetching with clear empty-results behavior

If a request fails, the actor returns an empty suggestion list for that query variant and logs the error. The run continues so you still get partial value instead of an all-or-nothing outcome.

#### Dataset-ready output for downstream use

Results are pushed to the default dataset, so you can export and use them right away. This keeps the workflow aligned with typical YouTube autocomplete data scraper and autocomplete keyword extractor use cases.

Overall, Youtube Autocomplete Scraper is built to turn a single query into structured autocomplete suggestions you can analyze immediately.

***

### Who Gets the Most Out of This

Here's how different teams put Youtube Autocomplete Scraper to work:

**Content marketers and SEO strategists**\
They take a core topic (like a product category) and instantly expand it into multiple autocomplete variations. The outcome is a ready-to-review keyword idea list that accelerates briefs and content calendars.

**Recruiters and growth teams**\
They use YouTube autocomplete suggestions to discover how people describe services, roles, and interests in different regions. The outcome is faster discovery and a more complete list of audience-relevant search intents.

**Keyword researchers and data analysts**\
They import the dataset into analysis tools and compare suggestion sets across languages and countries. The outcome is structured YouTube autocomplete keyword research data they can cluster, score, and track over time.

**Developers and automation specialists**\
They run the actor with dynamic inputs and consume the dataset as JSON records for further processing. The outcome is a dependable YouTube suggestion scraping script style workflow that fits into pipelines.

***

### Step-by-Step: How to Use It

No coding needed. Here's how to run Youtube Autocomplete Scraper from start to finish:

1. **Open the actor on Apify** — visit [console.apify.com](https://console.apify.com) and find Youtube Autocomplete Scraper.
2. **Enter your inputs** — set `query` and optionally `language`, `country`, `use_prefix`, and `use_suffix`.
3. **Configure proxy settings** — enable your preferred proxy configuration in the Apify UI for reliability on larger runs.
4. **Hit Run and watch the live log** — monitor progress and review any error messages in the logs.
5. **View results in the dataset tab** — each record contains your `query` plus `suggestion_XX` fields.
6. **Export as JSON, CSV, or Excel** — download the dataset in the format your team uses.

The whole process takes under 5 minutes to set up.

***

### Integrations & Export Options

Once your data is collected, Youtube Autocomplete Scraper plugs directly into your existing workflow.

Export formats are available from the Apify dataset tab, including JSON, CSV, and Excel. From there, you can use the data in spreadsheets, BI tools, and internal keyword databases.

You can also connect the actor to automation workflows via Apify’s API capabilities and no-code automation tools like Zapier/Make, so results can flow into CRMs, spreadsheets, or downstream processes automatically. For deeper details on API usage, see the Apify API documentation at https://apify.com/docs/api.

***

### Pricing & Free Trial

Youtube Autocomplete Scraper runs on the Apify platform, which offers a **free tier** — no credit card required to get started. You’ll be able to test runs and validate the quality of your YouTube autocomplete keyword extractor output before scaling.

Costs are handled through Apify’s platform pricing model. For the most up-to-date pricing and plan details, check the Apify pricing page at https://apify.com/pricing.

Start for free at [apify.com](https://apify.com) and scale when you're ready.

***

### Reliability & Performance

| What We Handle | How |
|---|---|
| Rate limiting pressure | Runs are designed to fetch suggestions reliably at scale |
| Regional relevance | Uses your `language` and `country` inputs to contextualize results |
| Resilience | Continues generating results even if some request attempts fail |
| Structured output | Suggestions are returned in consistent `suggestion_XX` fields per `query` |
| Dataset-first workflow | Results are pushed to the default dataset for easy export |

Limitations: this actor collects autocomplete suggestions from publicly available sources, so results depend on what’s returned for your chosen inputs. Private or login-gated content is not accessible.

For enterprise-scale runs, contact us to discuss custom configurations.

***

### Frequently Asked Questions

#### Is there a free plan or trial?

Yes. Apify offers a **free tier** to help you test Youtube Autocomplete Scraper before committing to larger usage.

#### Do I need to log in to use this?

No. You only provide `query` (and optionally `language`, `country`, `use_prefix`, `use_suffix`)—the actor runs without requiring a user login.

#### How accurate is the data?

The data accuracy depends on what autocomplete suggestions are returned for your selected inputs. The actor extracts the suggestions it receives and outputs them in ranked `suggestion_XX` fields for each `query`.

#### How many results can I get per run?

The actor uses `max_results` when slicing suggestions (e.g., it takes `suggestions[:max_results]`). If you want more or fewer suggestions per `query`, adjust the run configuration accordingly.

#### How often is the data updated / how fresh is it?

It’s as fresh as the moment the actor runs. Each run fetches suggestions during execution, so you’ll see changes if autocomplete suggestions evolve over time.

#### Is this legal? Does it comply with GDPR / CCPA?

In general, Youtube Autocomplete Scraper is intended for **publicly available data**. You are responsible for ensuring your use complies with GDPR, CCPA, and applicable platform terms and local regulations.

#### Can I export results to Google Sheets or Excel?

Yes. You can export from the Apify dataset tab as JSON, CSV, or Excel, then import into Google Sheets or other tools. You can also integrate via automation tools if you prefer a no-code route.

#### Can I run this on a schedule automatically?

Yes. You can schedule Apify actor runs so Youtube Autocomplete Scraper executes automatically on a recurring basis (for example, to refresh keyword idea sets).

#### Can I access this via API?

Yes. You can access run results programmatically using Apify’s API. See https://apify.com/docs/api for details.

#### What happens if the actor hits an error?

If a request fails for a particular query variant, that query’s suggestions come back as an empty list and the error is logged. The actor continues and still pushes whatever successful records it produced.

***

### Need Help or Have a Request?

Got a question about Youtube Autocomplete Scraper or want a new feature added? Email us at <dataforleads@gmail.com>. We actively maintain this actor based on user feedback, and we welcome ideas like webhook notifications on completion or enhanced batch support—so your YouTube autocomplete scraper workflows can move faster.

***

### Disclaimer & Responsible Use

*Youtube Autocomplete Scraper is the fastest, most reliable way to generate structured YouTube autocomplete keyword ideas—start your free run today.*

This actor collects **publicly available data** only. It does not access private accounts, login-gated content, or password-protected pages. You are responsible for complying with GDPR, CCPA, and applicable platform terms when using or storing the results, including respecting any data-removal requests—contact <dataforleads@gmail.com>. Use responsibly, ethically, and only for lawful purposes.

# 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("scraperoka/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("scraperoka/youtube-autocomplete-actor").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{}' |
apify call scraperoka/youtube-autocomplete-actor --silent --output-dataset

```

## MCP server setup

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

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/5e8CUvFpoxehPGc7g/builds/MM4yRZzR8d69MMYw3/openapi.json