# YouTube Search Results Scraper (videos, channels, no API key) (`webdatatools/youtube-search-scraper`) Actor

YouTube Search Results Scraper returns videos, channels or playlists for any keyword, with title, views, duration, channel and publish time — no API key, no quota.

- **URL**: https://apify.com/webdatatools/youtube-search-scraper.md
- **Developed by:** [Murat Uzun](https://apify.com/webdatatools) (community)
- **Categories:** Social media, Videos, SEO tools
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.30 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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

### What is YouTube Search Results Scraper?

**YouTube Search Results Scraper** runs any search term against [YouTube](https://www.youtube.com/results) and returns videos, channels or playlists — title, channel, view count, duration, upload time, thumbnail and more — as one clean row per result. It calls YouTube's own `/youtubei/v1/search` endpoint directly, the same one youtube.com's search page uses, so **no YouTube Data API key and no daily quota** are needed. Paste in your search queries, pick a result type, and run it on Apify with scheduling, API access and export built in.

### What data does YouTube Search Results Scraper extract?

One row per matching video, channel or playlist:

| Field | Type | Description |
| --- | --- | --- |
| `query`, `position` | string, number | The search term and this result's 1-based rank |
| `type`, `id`, `url` | string | `video`/`channel`/`playlist` and its ID and canonical URL |
| `title` | string | Video title, channel name or playlist title |
| `channelName`, `channelId`, `channelUrl` | string | The owning/uploading channel |
| `viewCountText`, `viewCount` | string, number | Raw and parsed view (or "watching") count |
| `publishedTimeText`, `publishedAtApprox` | string | Raw relative time ("6 months ago") and a best-effort resolved ISO date |
| `durationText`, `durationSeconds` | string, number | Video length, null for live streams |
| `thumbnailUrl` | string | Largest available thumbnail |
| `descriptionSnippet` | string | Excerpt from the video description or channel bio |
| `subscriberCountText` | string | Channel results only, e.g. "25.2K subscribers" |
| `videoCount` | number | Playlist results only, parsed from the "N videos" badge |
| `isLive`, `badges` | boolean, array | Live-stream flag and labels like New, LIVE, 4K, CC |
| `error`, `scrapedAt` | string | Set when a query failed completely; ISO timestamp |

### How to use YouTube Search Results Scraper

1. Open the **Input** tab and list your **Search queries**, e.g. `web scraping tutorial`, `apify`.
2. Pick a **Result type** — video, channel, playlist or all three mixed.
3. Optionally set **Upload date**, **Duration** and **Sort by** to narrow the results.
4. Set **Max results per query** (the Actor pages through YouTube's continuations to reach it) and click **Start**.
5. Download the dataset as JSON, CSV, Excel or HTML from the **Output** tab, or pull it via the API.

### Example input

```json
{
    "queries": ["web scraping tutorial", "apify"],
    "type": "video",
    "uploadDate": "any",
    "sortBy": "relevance",
    "duration": "any",
    "maxResultsPerQuery": 50
}
```

### Example output

```json
{
    "query": "web scraping tutorial",
    "position": 1,
    "type": "video",
    "id": "hHQlcnubuFI",
    "url": "https://www.youtube.com/watch?v=hHQlcnubuFI",
    "title": "Learn Web Scraping in 5 Minutes (NO PRIOR KNOWLEDGE)",
    "channelName": "CodeHead",
    "channelUrl": "https://www.youtube.com/channel/UCFVteOob_YXJHPaGTqlDV2Q",
    "viewCountText": "158,721 views",
    "viewCount": 158721,
    "publishedTimeText": "6 months ago",
    "durationText": "4:53",
    "durationSeconds": 293,
    "descriptionSnippet": "Get Rid of IP Blocking for just $1 with DataImpulse: ...",
    "isLive": false,
    "scrapedAt": "2026-09-13T12:00:00.000Z"
}
```

### Input parameters

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `queries` | array | `["web scraping tutorial"]` | Search terms, one dataset slice per query |
| `type` | string | `video` | `all`, `video`, `channel` or `playlist` |
| `uploadDate` | string | `any` | `hour`, `today`, `week`, `month` or `year` |
| `sortBy` | string | `relevance` | `relevance`, `date`, `views` or `rating` |
| `duration` | string | `any` | `short` (<4 min), `medium` (4-20 min), `long` (>20 min) |
| `maxResultsPerQuery` | integer | 50 | Results per query, 1-1000 |
| `language`, `region` | string | `en`, `US` | Sent to YouTube as `hl`/`gl` |
| `maxConcurrency` | integer | 3 | Queries run in parallel |

### Which filters are verified vs. best-effort

Every filter value below was captured live against `youtubei/v1/search` and checked against the actual returned results, not copied from documentation:

- **Type** (video/channel/playlist) — verified: each filter returns exclusively that renderer type.
- **Upload date** (hour/today/week/month/year) — verified: tested against a high-volume query and every returned video's relative-time text fell inside the requested window.
- **Duration** (short/medium/long) — verified: every returned video's length matched the bucket.
- **Sort by views** — verified: results come back in a monotonically decreasing view-count order.
- **Sort by date and rating** — **not** reliably honoured server-side as of this testing; YouTube's WEB client silently no-ops both values on this endpoint. For `sortBy=date` the Actor instead re-sorts the page(s) it already fetched by a parsed approximate publish date (client-side, best-effort — not a true site-wide "newest first"). `sortBy=rating` has no reliable substitute (YouTube no longer exposes like/dislike counts publicly) and is left in fetch order.

Playlists render as YouTube's newer `lockupViewModel` card rather than the legacy `playlistRenderer`; the Actor reads that shape (with a fallback for the old one). Channel results also carry a long-standing field-name swap in YouTube's own JSON: `videoCountText` actually holds the subscriber-count text and `subscriberCountText` holds the @handle — the Actor corrects for this internally so `subscriberCountText` in the dataset means what it says.

### Pricing

YouTube Search Results Scraper uses pay-per-event pricing: **$0.0005 per result row, i.e. $0.50 per 1,000 results**, plus a negligible actor-start fee. A 50-result run across 10 queries costs about $0.25. Set **Maximum cost per run** and the Actor trims work to fit your budget instead of overspending.

### YouTube Search Results Scraper vs. the YouTube Data API

The official YouTube Data API's `search.list` endpoint burns 100 quota units per call against a 10,000-unit daily default — about 100 searches a day, no more. This Actor talks to the same endpoint the youtube.com search page itself uses, with no API key, no OAuth and no quota ceiling, and returns a flat one-row-per-result dataset ready for a spreadsheet or a pipeline.

### Using YouTube Search Results Scraper with AI agents and MCP

This Actor is pay-per-event with limited permissions — the two requirements for an Actor to be callable through the Apify MCP server at `mcp.apify.com`. An agent passes `queries` and gets back structured video/channel/playlist rows for competitive research, content discovery or lead sourcing, and the same run works from n8n, Make, Zapier and LangChain through Apify's integrations.

### FAQ

**Why is `videoCount` null for channel results?** YouTube's search results page does not expose a channel's total video count anywhere in the response — only `subscriberCountText`. It's populated for playlists, parsed from the "N videos" thumbnail badge.

**Why does `publishedAtApprox` look approximate?** YouTube search only ever returns relative text like "6 months ago", never an exact timestamp, so the Actor resolves it against the scrape time as a best-effort midpoint — treat it as approximate, not authoritative.

**Does sorting by date actually work?** Not server-side, as documented above — see "Which filters are verified vs. best-effort".

**Is this legal to run?** Yes. It reads YouTube's own public search results page data, the same data any visitor's browser receives, and collects no personal data beyond what a channel or video owner already published.

**What are the limitations?** YouTube can change its internal JSON shape or filter encoding at any time without notice; if a run starts returning fewer fields than expected, please open an Issue.

### Related Actors

Part of the **webdatatools** web-intelligence suite — every Actor is pay-per-event, reads public data
without a login, and returns one clean row per entity:

Browse the whole suite at [webdatatools](https://paulet4a-commits.github.io/webdatatools/), or call ten of
these Actors straight from Claude, Cursor or Cline with the
[webdatatools MCP server](https://github.com/paulet4a-commits/webdatatools-mcp-server).

**Website & domain intelligence**

- [Email Extractor — Website Contact & Social Finder](https://apify.com/webdatatools/contact-extractor) — e-mails, phones and social profiles per domain
- [Tech Stack Detector — Wappalyzer & BuiltWith Alternative](https://apify.com/webdatatools/tech-stack-detector) — CMS, e-commerce, analytics, pixels and payments per domain
- [Domain DNS & Email Security Checker](https://apify.com/webdatatools/dns-email-security-checker) — SPF, DKIM, DMARC, MX provider, registrar and domain age
- [Domain Security Audit (TLS, HTTP headers, redirects, robots)](https://apify.com/webdatatools/domain-security-audit) — TLS expiry, security headers, redirect chain, robots and llms.txt
- [Subdomain Finder (Certificate Transparency)](https://apify.com/webdatatools/subdomain-finder) — every subdomain seen in CT logs, with a live DNS check
- [Bulk Core Web Vitals & PageSpeed Audit](https://apify.com/webdatatools/core-web-vitals-audit) — Lighthouse scores, LCP, CLS, INP and top fixes per URL
- [On-Page SEO Audit](https://apify.com/webdatatools/seo-page-audit) — title, meta, headings, links, images and schema issues per page
- [Sitemap URL Extractor & Change Monitor](https://apify.com/webdatatools/sitemap-extractor) — every sitemap URL, or new and removed pages between runs
- [Wayback Machine Snapshot & Page Change Tracker](https://apify.com/webdatatools/wayback-page-diff) — how a page changed over time, or every archived snapshot
- [Bulk Domain WHOIS & RDAP Lookup](https://apify.com/webdatatools/domain-whois-rdap) — registrar, dates, status and nameservers per domain
- [Web Scraper — CSS Selector & Data Extractor](https://apify.com/webdatatools/css-selector-extractor) — pull any CSS selector off any page, one row per URL
- [Website Screenshot Generator](https://apify.com/webdatatools/website-screenshot) — full-page or viewport PNG/JPEG screenshots of any URL

**Content for AI, LLMs and RAG**

- [AI Web Search & Read: Google results as clean Markdown](https://apify.com/webdatatools/ai-web-search) — a query turned into clean Markdown from the top search results
- [Website to Markdown — Content Crawler for LLM & RAG](https://apify.com/webdatatools/website-to-markdown) — any site as clean Markdown per page, no browser
- [Article & News Extractor (clean text, author, date, markdown)](https://apify.com/webdatatools/article-extractor) — clean article text, author, date and Markdown per URL
- [Structured Data & JSON-LD Extractor (Schema.org, Open Graph)](https://apify.com/webdatatools/structured-data-extractor) — Schema.org and Open Graph data from any page
- [Google News Scraper (RSS search by keyword, topic, site)](https://apify.com/webdatatools/google-news-scraper) — news results by keyword, topic or site
- [Press Release Monitor: PR Newswire, BusinessWire, GlobeNewswire](https://apify.com/webdatatools/press-release-monitor) — PR Newswire, Business Wire and GlobeNewswire releases

**Search, video and social**

- [YouTube Shorts Scraper](https://apify.com/webdatatools/youtube-shorts-scraper) — Shorts from channels, hashtags and searches with view counts
- [Pinterest Pins Scraper](https://apify.com/webdatatools/pinterest-pins-scraper) — latest pins of public Pinterest profiles and boards
- [YouTube Transcript Scraper](https://apify.com/webdatatools/youtube-transcript-scraper) — captions and subtitles as text + timed segments, per video or channel
- [Google Search Results Scraper — SERP API](https://apify.com/webdatatools/google-search-scraper) — organic SERP results per keyword and country
- [YouTube Comments Scraper — Comments & Replies](https://apify.com/webdatatools/youtube-comments-scraper) — comments and replies with likes, no API key
- [YouTube Channel Latest Videos (RSS, no API key)](https://apify.com/webdatatools/youtube-channel-videos) — the latest 15 videos of any channel from RSS
- [YouTube Channel Scraper (videos, shorts, live)](https://apify.com/webdatatools/youtube-channel-scraper) — a channel's full video, shorts and stream list
- [YouTube Video Details Scraper (views, likes, description, tags)](https://apify.com/webdatatools/youtube-video-details) — views, likes, description, tags and chapters per video
- [Apple Podcasts Lookup & Episodes Scraper](https://apify.com/webdatatools/podcast-lookup) — podcast metadata and episodes from iTunes and RSS
- [Bluesky Post, Search & Profile Scraper](https://apify.com/webdatatools/bluesky-scraper) — posts, profiles, followers and threads from the AT Protocol API
- [Telegram Channel Posts Scraper](https://apify.com/webdatatools/telegram-channel-scraper) — posts, views and media flags from any public channel
- [Substack Publication & Posts Scraper](https://apify.com/webdatatools/substack-scraper) — archive, authors and paywall status per publication
- [Google Play Reviews Scraper](https://apify.com/webdatatools/google-play-reviews-scraper) — reviews, ratings, replies and app versions per app
- [App Store Reviews Scraper](https://apify.com/webdatatools/app-store-reviews-scraper) — iOS reviews and ratings per app and country
- [Google Trends Scraper](https://apify.com/webdatatools/google-trends-scraper) — interest over time, by region, and related queries per keyword
- [Google Ads Transparency Scraper](https://apify.com/webdatatools/google-ads-transparency-scraper) — ads any advertiser runs on Google, with format and dates
- [Keyword Suggestions Scraper (Google, YouTube, Amazon, Bing)](https://apify.com/webdatatools/keyword-suggestions-scraper) — autocomplete keyword ideas from four search engines
- [Bilibili Scraper (Videos, Search, Popular)](https://apify.com/webdatatools/bilibili-scraper) — Chinese video platform: views, likes, coins, danmaku, uploader
- [Mastodon Scraper (Hashtags, Accounts, Trending)](https://apify.com/webdatatools/mastodon-scraper) — public fediverse posts by hashtag, account or trending
- [Meetup Events Scraper (Search by Keyword & City)](https://apify.com/webdatatools/meetup-events-scraper) — upcoming events with RSVPs, fees, venues and groups
- [Eventbrite Scraper (Events by Keyword & City)](https://apify.com/webdatatools/eventbrite-scraper) — events by keyword and city with venue, dates and organizer

**Leads, jobs and company data**

- [Career Site Jobs API (Greenhouse, Lever, Ashby, Workday +1)](https://apify.com/webdatatools/career-site-jobs-api) — company domains in, their open jobs out, ATS detected automatically
- [Workday Jobs Scraper](https://apify.com/webdatatools/workday-jobs-scraper) — jobs with full descriptions from any Workday career site
- [Google Maps Scraper](https://apify.com/webdatatools/google-maps-scraper) — businesses with phone, website, address, rating and coordinates per search
- [LinkedIn Jobs Scraper](https://apify.com/webdatatools/linkedin-jobs-scraper) — job titles, companies, locations and full descriptions from LinkedIn job search
- [Company 360: full company profile from a domain](https://apify.com/webdatatools/company-360) — one row per domain: contacts, tech, security, hiring and company facts
- [Hiring Signals Scraper (Greenhouse, Lever, Ashby, Workable)](https://apify.com/webdatatools/hiring-signals) — open jobs and hiring velocity from 10 public ATS boards
- [Y Combinator Companies & Founders Scraper](https://apify.com/webdatatools/yc-companies-scraper) — YC startups by batch, industry and hiring status
- [Wikidata Entity & Company Enrichment (facts, IDs, links)](https://apify.com/webdatatools/wikidata-entity-enrichment) — HQ, founders, employees, revenue and social IDs per company
- [Email Validator & Verifier — Bulk Email Check](https://apify.com/webdatatools/email-validator) — syntax, MX, disposable, role and free-provider checks
- [OpenStreetMap POI Extractor (Overpass API: shops, amenities)](https://apify.com/webdatatools/overpass-poi-extractor) — shops and amenities by radius, bbox or area
- [Stock, Crypto & FX Quotes](https://apify.com/webdatatools/market-quotes) — one row per symbol from Yahoo, Binance and ECB rates
- [Remote Jobs Aggregator (RemoteOK, WWR, Hacker News)](https://apify.com/webdatatools/remote-jobs-aggregator) — one clean row per remote job, de-duplicated across feeds
- [Greenhouse Jobs Scraper](https://apify.com/webdatatools/greenhouse-jobs-scraper) — jobs with descriptions from any Greenhouse job board
- [Lever Jobs Scraper](https://apify.com/webdatatools/lever-jobs-scraper) — jobs with descriptions from any Lever careers page
- [Ashby Jobs Scraper](https://apify.com/webdatatools/ashby-jobs-scraper) — jobs, salaries and descriptions from any Ashby job board
- [SmartRecruiters Jobs Scraper](https://apify.com/webdatatools/smartrecruiters-jobs-scraper) — jobs with descriptions from any SmartRecruiters company
- [Seek Jobs Scraper (Australia & New Zealand)](https://apify.com/webdatatools/seek-jobs-scraper) — Seek job ads with salary, work type and location
- [Dice Jobs Scraper](https://apify.com/webdatatools/dice-jobs-scraper) — US tech jobs from Dice with salary and remote flag
- [AutoScout24 Scraper](https://apify.com/webdatatools/autoscout24-scraper) — European car listings with price, mileage and seller
- [Rightmove Scraper](https://apify.com/webdatatools/rightmove-scraper) — UK property for sale or rent with price and agent
- [Wellfound Jobs Scraper (AngelList Startup Jobs)](https://apify.com/webdatatools/wellfound-jobs-scraper) — startup jobs with salary and equity ranges, company size and stage
- [Yandex Maps Scraper (Places, Ratings, Phones)](https://apify.com/webdatatools/yandex-maps-scraper) — businesses in Russia, Türkiye and the CIS with phones, ratings, hours
- [Craigslist Scraper (Listings, Prices, Locations)](https://apify.com/webdatatools/craigslist-scraper) — listings in any area and category with price, date and coordinates
- [JobStreet Scraper (Malaysia, Singapore, PH, ID + JobsDB)](https://apify.com/webdatatools/jobstreet-scraper) — JobStreet and JobsDB jobs in 6 Asian countries with parsed salaries
- [InfoJobs Scraper (Spain Jobs, Salaries, Companies)](https://apify.com/webdatatools/infojobs-scraper) — Spanish jobs with salary range, contract type and full description
- [Redfin Scraper (Homes for Sale, Prices, Details)](https://apify.com/webdatatools/redfin-scraper) — US homes for sale or sold from any Redfin search, with price and details
- [Kleinanzeigen Scraper (Ads, Prices, Locations)](https://apify.com/webdatatools/kleinanzeigen-scraper) — German classifieds with price, VB flag, ZIP, city and seller type

**Developer, app and research data**

- [npm, PyPI & Crates.io Package Health Checker](https://apify.com/webdatatools/package-health-checker) — releases, downloads, deprecation and a health score
- [GitHub Repository Health & Activity Report](https://apify.com/webdatatools/github-repo-health) — stars, commits, contributors and risk flags per repo
- [VS Code Marketplace Extension Scraper (installs, ratings)](https://apify.com/webdatatools/vscode-marketplace-extensions) — installs, ratings and versions per extension
- [Chrome Web Store Extension Scraper (installs, ratings)](https://apify.com/webdatatools/chrome-web-store-extensions) — users, rating, version and developer per extension
- [Google Play Scraper](https://apify.com/webdatatools/google-play-scraper) — apps, ratings, installs, developer contact and reviews
- [App Store (iOS) App Metadata, Ratings & Top Charts Lookup](https://apify.com/webdatatools/app-store-lookup) — ratings, price, version and charts per app
- [CrossRef DOI & Citation Metadata Lookup](https://apify.com/webdatatools/crossref-doi-lookup) — papers, authors, journals and citation counts
- [FDA Recalls & Adverse Events Monitor (openFDA)](https://apify.com/webdatatools/openfda-recall-monitor) — food, drug and device recalls from openFDA
- [iCal / ICS Calendar Feed to Events Extractor](https://apify.com/webdatatools/ical-calendar-extractor) — any public calendar feed as event rows
- [Shopify Store Products Scraper](https://apify.com/webdatatools/shopify-products-scraper) — catalog, prices, variants and stock per store
- [Hacker News Search & Front Page Scraper](https://apify.com/webdatatools/hacker-news-scraper) — stories, comments and points by query or front page
- [GitHub Trending Repositories Scraper](https://apify.com/webdatatools/github-trending-scraper) — trending repos and developers by language and period
- [Stack Overflow & Stack Exchange Q\&A Scraper](https://apify.com/webdatatools/stackexchange-scraper) — questions, answers and scores by query, tag or site
- [Bulk Image Downloader](https://apify.com/webdatatools/bulk-image-downloader) — download image URLs to storage with size, dimensions and a ZIP
- [Google Flights Scraper (Prices, Airlines, Stops)](https://apify.com/webdatatools/google-flights-scraper) — flight prices, airlines, times, stops and CO2 by route and date
- [Google Hotels Scraper (Prices, Ratings, Reviews)](https://apify.com/webdatatools/google-hotels-scraper) — hotel prices per night, stars, rating and reviews by city and dates
- [AliExpress Scraper (Search Products & Prices)](https://apify.com/webdatatools/aliexpress-scraper) — AliExpress search results with USD price, discount and rank
- [Lazada Scraper (Products, Prices, Sold, Ratings)](https://apify.com/webdatatools/lazada-scraper) — Lazada products in 6 countries with price, rating, units sold and seller

### Support and feedback

Found a query that returns unexpected results, or a field that's missing? Open an issue on the **Issues** tab.

# Actor input Schema

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

Enter the search terms to run on YouTube, one row is returned per result, e.g. web scraping tutorial. One dataset row is produced per matching video, channel or playlist.

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

Choose what kind of result to return: all mixes videos, channels and playlists; video/channel/playlist restrict the search server-side to one kind (verified live against YouTube's search endpoint).

## `uploadDate` (type: `string`):

Only return videos uploaded within this window, e.g. week for the last 7 days. Verified live against YouTube's own upload-date filter. Ignored when Result type is channel or playlist.

## `sortBy` (type: `string`):

How to order results. relevance (default) and views are applied by YouTube's server and verified live (views produces a clean view-count-descending order). date and rating could not be verified server-side during testing — for those two the Actor instead re-sorts the page(s) it already fetched by parsed publish time client-side, which is a best-effort approximation, not a true site-wide sort; see the README.

## `duration` (type: `string`):

Only return videos of this length: short is under 4 minutes, medium is 4-20 minutes, long is over 20 minutes. Verified live against YouTube's own duration filter. Ignored when Result type is channel or playlist.

## `maxResultsPerQuery` (type: `integer`):

Enter how many results to return per search query, e.g. 50. The Actor pages through YouTube's search continuations until it reaches this number or YouTube runs out of results.

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

Language code sent to YouTube as hl, e.g. en. Affects relative time text ("2 days ago") and UI strings the parser reads.

## `region` (type: `string`):

Country code sent to YouTube as gl, e.g. US. Affects which results and trending content YouTube considers local.

## `maxConcurrency` (type: `integer`):

Enter how many search queries to run in parallel, e.g. 3. Each query pages sequentially through its own continuations, so this only parallelises across different queries.

## Actor input object example

```json
{
  "queries": [
    "web scraping tutorial",
    "apify"
  ],
  "type": "video",
  "uploadDate": "any",
  "sortBy": "relevance",
  "duration": "any",
  "maxResultsPerQuery": 50,
  "language": "en",
  "region": "US",
  "maxConcurrency": 3
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 tutorial",
        "apify"
    ],
    "type": "video",
    "uploadDate": "any",
    "sortBy": "relevance",
    "duration": "any",
    "maxResultsPerQuery": 50,
    "language": "en",
    "region": "US",
    "maxConcurrency": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("webdatatools/youtube-search-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 tutorial",
        "apify",
    ],
    "type": "video",
    "uploadDate": "any",
    "sortBy": "relevance",
    "duration": "any",
    "maxResultsPerQuery": 50,
    "language": "en",
    "region": "US",
    "maxConcurrency": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("webdatatools/youtube-search-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 tutorial",
    "apify"
  ],
  "type": "video",
  "uploadDate": "any",
  "sortBy": "relevance",
  "duration": "any",
  "maxResultsPerQuery": 50,
  "language": "en",
  "region": "US",
  "maxConcurrency": 3
}' |
apify call webdatatools/youtube-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,webdatatools/youtube-search-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/wYgOPl49mY2AWLW0Y/builds/AuHhrm5YYwuMXVarF/openapi.json