# YouTube Search Suggestions Scraper (`crawlerbros/youtube-search-suggestions-scraper`) Actor

Get public YouTube autocomplete suggestions for keyword research, content discovery, and SEO planning.

- **URL**: https://apify.com/crawlerbros/youtube-search-suggestions-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## YouTube Search Suggestions Scraper

Discover the phrases YouTube shows in its public search autocomplete. Enter one or more seed keywords and get clean, ranked suggestions that can be used for SEO research, video planning, audience research, and content discovery.

This actor uses YouTube's public autocomplete response. It does not require a YouTube account, API key, cookies, or a paid proxy.

### What this actor does

- **Autocomplete lookup:** pass one or more seed phrases and get YouTube's own suggestions
- **Ready search URLs:** every suggestion includes a `searchUrl` you can feed to a search scraper
- **Market and language aware:** localized suggestions per country and language
- **Bulk queries:** multiple seeds are processed in one run
- **Empty fields are omitted** — records only contain values that are actually populated.

### Output

One row is returned for every suggestion:

| Field | Description |
|---|---|
| `suggestion` | The exact phrase returned by YouTube autocomplete. |
| `inputQuery` | The seed keyword that produced the suggestion. |
| `rank` | Position within that seed keyword's returned list. |
| `language` | Language used for the request. |
| `market` | Country or region used for the request. |
| `searchUrl` | YouTube search URL for the suggestion when enabled. |

All emitted fields contain real public values. Empty suggestions are discarded rather than emitted as blank rows.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `queries` | array | `["web scraping"]` | One or more seed keywords or phrases. |
| `maxSuggestions` | integer | `10` | Suggestions to return per keyword (1–20). |
| `language` | string | `en` | Language code used to localize suggestions. |
| `market` | string | `US` | Country or region used to localize suggestions. |
| `deduplicateSuggestions` | boolean | `true` | Keep one row when the same suggestion appears for multiple keywords. |
| `includeSearchUrl` | boolean | `true` | Include a ready-to-use YouTube search URL on every row. |

### Examples

```json
{
  "queries": ["web scraping", "youtube automation"],
  "maxSuggestions": 10,
  "language": "en",
  "market": "US",
  "deduplicateSuggestions": true,
  "includeSearchUrl": true
}
```

#### Example: single seed

```json
{
  "queries": ["how to scrape"],
  "market": "US",
  "language": "en"
}
```

#### Example: multiple seeds

```json
{
  "queries": ["youtube api", "web scraping"],
  "market": "GB"
}
```

### Use cases

- **SEO and content research** — discover what users actually search for
- **Keyword expansion** — grow seed keywords into long-tail phrases
- **Market localization** — compare suggestions across countries
- **Autocomplete features** — power search boxes with real YouTube suggestions

### FAQ

#### Does this require cookies or an API key?

No. It uses YouTube's public autocomplete endpoint and works without a login.

#### Are suggestions guaranteed to be the same every time?

No. YouTube can change autocomplete based on language, country, current trends, and its own ranking. The actor records the returned phrases and request context for reproducibility.

#### Does this scrape video results?

No. Use the YouTube Search Scraper when you need video, channel, playlist, or Shorts result metadata.

### YouTube Scraper Suite

This actor is part of a complete YouTube data extraction toolkit. Explore the full suite:

| Actor | Description |
|-------|-------------|
| [YouTube Ads Scraper](https://apify.com/crawlerbros/youtube-ads-scraper) | Google Ads Transparency ads by advertiser, keyword, and country |
| [YouTube Channel Profile Scraper](https://apify.com/crawlerbros/youtube-channel-profile-scraper) | Full channel profiles with About data, playlists, and community posts |
| [YouTube Channel Scraper](https://apify.com/crawlerbros/youtube-channel-scraper) | Channel metadata, subscriber counts, and full video catalogs |
| [YouTube Channel Scraper Fast](https://apify.com/crawlerbros/youtube-channel-scraper-fast) | Streamlined channel scraper for high-volume and speed-sensitive workflows |
| [YouTube Comment Scraper](https://apify.com/crawlerbros/youtube-comment-scraper) | Comments, replies, likes, author info, and pinned/hearted status |
| [YouTube Community Posts Scraper](https://apify.com/crawlerbros/youtube-community-posts-scraper) | Community posts with images, polls, video attachments, and comments |
| [YouTube Email Scraper](https://apify.com/crawlerbros/youtube-email-scraper) | Creator contact emails from channel pages, Instagram, TikTok, and Linktree |
| [YouTube Hashtag Scraper](https://apify.com/crawlerbros/youtube-hashtag-scraper) | Videos and Shorts tagged with specific hashtags |
| [YouTube Live Chat Scraper](https://apify.com/crawlerbros/youtube-live-chat-scraper) | Live and replay chat messages with author and timing metadata |
| [YouTube Playlist Scraper](https://apify.com/crawlerbros/youtube-playlist-scraper) | Videos from playlists plus channel playlist discovery |
| [YouTube Search Scraper](https://apify.com/crawlerbros/youtube-search-scraper) | Search results including videos, channels, and playlists |
| [YouTube Shorts Scraper](https://apify.com/crawlerbros/youtube-shorts-scraper) | Shorts from channels or hashtags with full view and like metadata |
| [YouTube SponsorBlock Segments Scraper](https://apify.com/crawlerbros/youtube-sponsorblock-scraper) | SponsorBlock segments (sponsor, intro, outro, and more) for any video |
| [YouTube Transcript Scraper](https://apify.com/crawlerbros/youtube-transcript-scraper) | Timed transcripts and captions with optional Whisper AI fallback |
| [YouTube Trending Scraper](https://apify.com/crawlerbros/youtube-trending-scraper) | Ranked trending videos by category — Gaming, Music, News, Movies |
| [YouTube Video Details Scraper](https://apify.com/crawlerbros/youtube-video-details-scraper) | Comprehensive video metadata, chapters, endscreen, captions, and comments |
| [YouTube Video Downloader](https://apify.com/crawlerbros/youtube-video-downloader) | Download videos, playlists, and channels in any quality with metadata |

# Actor input Schema

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

Keywords or phrases to expand with YouTube autocomplete.

## `maxSuggestions` (type: `integer`):

Maximum number of suggestions returned for each keyword.

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

Language used to personalize the suggestion list.

## `market` (type: `string`):

Country or region used for localized suggestions.

## `deduplicateSuggestions` (type: `boolean`):

Avoid emitting the same suggestion more than once for a run.

## `includeSearchUrl` (type: `boolean`):

Include a ready-to-open YouTube search URL for every suggestion.

## Actor input object example

```json
{
  "queries": [
    "web scraping"
  ],
  "maxSuggestions": 10,
  "language": "en",
  "market": "US",
  "deduplicateSuggestions": true,
  "includeSearchUrl": true
}
```

# Actor output Schema

## `suggestions` (type: `string`):

Dataset containing all scraped autocomplete suggestion rows with search urls.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "web scraping"
    ],
    "maxSuggestions": 10,
    "language": "en",
    "market": "US",
    "deduplicateSuggestions": true,
    "includeSearchUrl": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/youtube-search-suggestions-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": ["web scraping"],
    "maxSuggestions": 10,
    "language": "en",
    "market": "US",
    "deduplicateSuggestions": True,
    "includeSearchUrl": True,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/youtube-search-suggestions-scraper").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 '{
  "queries": [
    "web scraping"
  ],
  "maxSuggestions": 10,
  "language": "en",
  "market": "US",
  "deduplicateSuggestions": true,
  "includeSearchUrl": true
}' |
apify call crawlerbros/youtube-search-suggestions-scraper --silent --output-dataset

```

## MCP server setup

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

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/B6j1xdpivosUNkgOY/builds/H8BB8qkhhVARRuiSz/openapi.json