YouTube Search Suggestions Scraper

What it returns

8 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.

• suggestion
• seed
• type
• rank
• locale
• source
• suggestionType
• searchUrl

Not in the schema among the core YouTube fields: video_id, title, channel, views, duration, published_at, url, transcript. The field matrix shows which other tools return them.

How it differs from the other YouTube Actors

Among the 17 catalogue Actors for YouTube with a published schema, only this one returns suggestion, seed, locale.

Pick another Actor if you need

Input

Example input

Built from the input form's published example values and defaults.

{
  "queries": [
    "web scraping"
  ],
  "mode": "exact",
  "source": "youtube",
  "language": "en",
  "market": "US",
  "maxItems": 3,
  "maxSuggestionsPerSeed": 3,
  "maxQueriesPerSeed": 300,
  "expansionDepth": 0,
  "dedupeAcrossSeeds": false,
  "excludeTerms": [],
  "minWordCount": 0,
  "onlyQuestions": false,
  "mustContainSeed": false,
  "includeEntityCards": true,
  "includeSearchUrl": true
}

Run it from code or an AI agent

The same run through the Apify API, with the example input. You need an Apify API token; the run is billed to your account at the Store price.

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "queries": [
        "web scraping"
    ],
    "mode": "exact",
    "source": "youtube",
    "language": "en",
    "market": "US",
    "maxItems": 3,
    "maxSuggestionsPerSeed": 3,
    "maxQueriesPerSeed": 300,
    "expansionDepth": 0,
    "dedupeAcrossSeeds": False,
    "excludeTerms": [],
    "minWordCount": 0,
    "onlyQuestions": False,
    "mustContainSeed": False,
    "includeEntityCards": True,
    "includeSearchUrl": True
}

run = client.actor("dataspryva/youtube-search-suggestions-scraper").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "queries": [
        "web scraping"
    ],
    "mode": "exact",
    "source": "youtube",
    "language": "en",
    "market": "US",
    "maxItems": 3,
    "maxSuggestionsPerSeed": 3,
    "maxQueriesPerSeed": 300,
    "expansionDepth": 0,
    "dedupeAcrossSeeds": false,
    "excludeTerms": [],
    "minWordCount": 0,
    "onlyQuestions": false,
    "mustContainSeed": false,
    "includeEntityCards": true,
    "includeSearchUrl": true
};

const run = await client.actor("dataspryva/youtube-search-suggestions-scraper").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/actors/dataspryva~youtube-search-suggestions-scraper/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"queries":["web scraping"],"mode":"exact","source":"youtube","language":"en","market":"US","maxItems":3,"maxSuggestionsPerSeed":3,"maxQueriesPerSeed":300,"expansionDepth":0,"dedupeAcrossSeeds":false,"excludeTerms":[],"minWordCount":0,"onlyQuestions":false,"mustContainSeed":false,"includeEntityCards":true,"includeSearchUrl":true}'

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=dataspryva/youtube-search-suggestions-scraper",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

What a run costs

The result rate falls on higher Apify plans. Each figure is the published per-result rate times the number of results.

• Every run also has a start event, charged per GB of memory (minimum one): $0.10 on Free, $0.03 on Business. At its default memory of 4 GB a run starts at $0.40 on Free. Fewer, larger runs keep this small.
• The Free plan includes $5 of monthly usage (Apify pricing, checked 2026-11-11); at the Free rate that covers at most about 5,050 results, less start events and platform usage.
• Worked example: 10,000 results in one run on the Free plan cost $10.30 ($9.90 for results + $0.40 start), plus Apify platform usage (compute), billed separately by Apify.
• Pay per event. Platform usage (compute) is billed by Apify on top of the event prices. Compare other tools in the cost estimator.

Where it fits among YouTube routes

It ranks 17 of 17 catalogue Actors for YouTube on the published formula (fields, price, reliability, freshness). Its line is highlighted on the map.

What people use it for

• Keyword research
• Content planning
• Search phrase discovery

Other catalogue Actors for YouTube

Similar Actors

Questions people ask

Sources

• YouTube Search Suggestions Scraper on Apify Store
• Published build with input and output schema (JSON)
• YouTube Data API v3 documentation