# YouTube Search Scraper: YouTube Search Results & Videos (`xmolodtsov/youtube-search-scraper`) Actor Scrape YouTube search results for any keyword: video title, URL, views, duration, upload date, channel and thumbnail, plus Shorts. Filter by upload date, type or length, sort by popularity, and run many keywords at once. No API key, no login. - **URL**: https://apify.com/xmolodtsov/youtube-search-scraper.md - **Developed by:** [GoFetch](https://apify.com/xmolodtsov) (community) - **Categories:** Social media, Videos - **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.60 / 1,000 youtube search 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 does YouTube Search Scraper do? YouTube Search Scraper turns any YouTube search into a clean dataset. Type the keywords you would type into YouTube's search bar and get back every video and Short on the results page: title, URL, view count, upload date, duration, channel name, @handle and channel ID, the description snippet, badges such as 4K or CC, and the rank each result had in the search. It works for any language and any number of searches in one run. It is built for people who need YouTube search results as data, not as a web page: - **Marketers and SEO teams** tracking which videos and channels rank for their keywords, week after week. - **Researchers and analysts** collecting videos on a topic, from news events to product launches, with view counts for each. - **Agencies and creators** finding channels to partner with, by @handle and channel ID, from the searches their audience runs. - **AI and data teams** building video datasets, or giving an agent a YouTube search tool through the Apify API or MCP. You don't need a YouTube API key, a Google account or quota. You pay only for the results you get, and results are deduplicated across the whole run. **Drop-in output.** The rows use the field names that YouTube scrapers commonly use (`id`, `title`, `url`, `viewCount`, `date`, `duration`, `channelName`, `channelUrl`, `channelUsername`, `channelId`, `order`, `input`, `fromYTUrl`), so existing pipelines keep working. It also fills the fields that listing-level scrapers often leave empty: every Short gets its channel, upload date and exact view count, and every video gets its description snippet, badges, verified-channel flag and channel avatar. ### What data you get One row per video or Short. Field names are case-sensitive. | Field | Example | Notes | |---|---|---| | `id` | `xP2rh160e_A` | YouTube video ID | | `title` | `Peppa's NEW Electric Car…` | As YouTube lists it for an English-language viewer in the US | | `url` | `https://www.youtube.com/watch?v=xP2rh160e_A` | Shorts use `/shorts/` | | `type` | `video` | `video`, `stream` (live now or a past stream) or `shorts` | | `duration` | `00:31:28` | HH:MM:SS; empty for live streams and Shorts | | `date` | `11 months ago` | Upload date as listed ("Streamed 2 days ago" for past streams) | | `viewCount` | `9890936` | A number. Exact for Shorts; for live streams, the people watching now | | `thumbnailUrl` | `https://i.ytimg.com/vi/…/hq720.jpg` | Largest thumbnail in the listing | | `channelName` | `Peppa Pig - Official Channel` | For collaborations, the uploading channel | | `channelUrl` | `https://www.youtube.com/@PeppaPigOfficial` | `/channel/` when YouTube shows no handle | | `channelUsername` | `PeppaPigOfficial` | The @handle without "@", when YouTube shows one | | `channelId` | `UCAOtE1V7Ots4DjM8JLlrYgg` | Stable channel ID | | `order` | `3` | Position in YouTube's results for this search (videos and Shorts together), counted before any filtering | | `input` | `electric cars` | The search term the row came from | | `fromYTUrl` | `https://www.youtube.com/results?search_query=electric%20cars&sp=CAM%3D` | The YouTube results page with your filters | | `durationSeconds` | `1888` | Duration as a number | | `text` | `Peppa and George are playing…` | Description snippet shown in search | | `isChannelVerified` | `true` | Verified badge on the channel | | `badges` | `["CC"]` | Labels on the result: `4K`, `CC`, `LIVE`, `New`, `360°`, `VR180`… | | `isLive` | `false` | `true` while the stream is on air | | `channelAvatarUrl` | `https://yt3.ggpht.com/…` | Channel profile picture | ### How to use YouTube Search Scraper 1. Open the Actor in Apify Console and go to the **Input** tab. 2. Type your searches into **Search terms**, one per line. You can also paste a YouTube results URL such as `https://www.youtube.com/results?search_query=lofi+hip+hop`. 3. Set **Max videos per search** and, if you want Shorts too, **Max Shorts per search**. 4. Optionally pick filters: **Sort by** popularity, **Upload date**, **Duration**, **Videos only**, or features such as 4K, Live or Creative Commons. 5. Click **Start**. Download the results from the **Output** tab as JSON, CSV, Excel or HTML, or read them through the API. #### Use it as a YouTube search API This call runs the Actor and returns the results. Synchronous calls time out after 5 minutes, so for large batches start a run and read its dataset afterwards. ```bash curl -X POST "https://api.apify.com/v2/acts/xmolodtsov~youtube-search-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"searchQueries": ["electric cars", "ev charging"], "maxResults": 50, "dateFilter": "month"}' ``` With the Apify Python client: ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("xmolodtsov/youtube-search-scraper").call( run_input={"searchQueries": ["python tutorial"], "maxResults": 100, "sortingOrder": "views"} ) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["order"], item["viewCount"], item["channelName"], item["title"]) ``` #### Use it from an AI agent (MCP) Connect your MCP client to `https://mcp.apify.com?tools=xmolodtsov/youtube-search-scraper` and the agent can search YouTube as a tool call. The usual pricing and free-plan limits apply. ### Pricing Pay per result, all-inclusive: you are charged for each video or Short returned, and the proxy and platform usage are included. There are no start fees and no separate compute bill. | Apify plan | Price per result | Price per 1,000 results | |---|---|---| | Free | $0.0011 | $1.10 | | Starter (Bronze) | $0.0009 | $0.90 | | Scale (Silver) | $0.00075 | $0.75 | | Business (Gold) | $0.0006 | $0.60 | Platinum and Diamond plans pay the Gold price. #### How much does it cost to scrape YouTube search results? Example: you run 20 keywords with **Max videos per search** at 100 and **Max Shorts per search** at 20. That is up to 2,400 results. If YouTube lists 2,200 of them, you pay for 2,200: $1.98 on Starter, $1.32 on Business. Results that don't exist cost nothing, errors are never pushed as rows, and a video that shows up for two of your keywords is returned and charged once. To cap spending, set a maximum cost per run in Console or the API. The Actor stops cleanly at that limit and keeps every result fetched so far. #### Is it free? You can try it on the free Apify plan. Free-plan runs are limited to **10 results per run** and **5 runs per calendar month per account**. These limits are set by the developer of this Actor, not by Apify, and any paid Apify plan removes them. A capped run still succeeds and says so in its status message. Once the five runs are used, further runs end successfully with an explanation and no results until the 1st of the next month. ### Input ```json { "searchQueries": ["lofi hip hop", "receta de pan casero"], "maxResults": 100, "maxResultsShorts": 20, "sortingOrder": "relevance", "dateFilter": "month", "lengthFilter": "between420", "is4K": true } ``` | Field | Default | What it does | |---|---|---| | `searchQueries` | required\* | Search terms, one per entry, or YouTube results URLs (their own filters are kept). | | `startUrls` | none | YouTube search results URLs as `[{"url": …}]` or strings, the shape other YouTube scrapers take. \*One of the two is required. | | `maxResults` | 50 | Videos and streams per search. 0 = Shorts only. | | `maxResultsShorts` | 0 | Shorts per search, on top of the videos. 0 = no Shorts. | | `sortingOrder` | `relevance` | `relevance` or `views` (YouTube's "Popularity"). | | `dateFilter` | none | `today`, `week`, `month` or `year`. | | `videoType` | none | `video` = videos only (no Shorts, channels or playlists). | | `lengthFilter` | none | `under4` (under 3 minutes), `between420` (3 to 20 minutes), `plus20` (over 20 minutes). | | `isLive`, `is4K`, `isHD`, `hasSubtitles`, `hasCC`, `is360`, `isVR180`, `is3D`, `isHDR`, `hasLocation` | off | YouTube's feature filters. `hasCC` is Creative Commons; `hasSubtitles` is subtitles/closed captions. | | `proxyConfiguration` | Apify datacenter | Change only to use residential or your own proxies. | **How the filters behave.** Every filter here was checked against YouTube's own filter panel, which marks the filters it applied, and against the returned videos: badges, durations, upload dates, licence, location tag and stream formats. Some details are worth knowing: - YouTube removed sorting by upload date and by rating, and the "Last hour" filter. They aren't offered here. To get recent videos, use **Upload date**. - YouTube changed its duration buckets to under 3 minutes, 3 to 20 minutes and over 20 minutes. The option names (`under4`, `between420`, `plus20`) stay the same so inputs from other YouTube scrapers keep working. - YouTube mixes a few older videos into date-filtered results. This Actor drops them using each result's listed upload date, and counts them in the status message. - With **Popularity** sorting, YouTube shows no Shorts next to videos, so the Actor doesn't page on looking for them and the status message says why there are none. Set **Max videos per search** to 0 to get popular Shorts. **Videos only** excludes Shorts by definition. With **Max videos per search** at 0 and no date filter, the Actor asks YouTube for Shorts directly and gets full pages of them. - The **Location** filter only returns videos for searches that name a place, such as "walking tour new york". - Filters apply to every search in the run. A pasted results URL keeps the filters in its own `sp` parameter. ### Output ![YouTube search results in the Overview table](https://api.apify.com/v2/key-value-stores/2DxCOvbMjhvK3S1qP/records/youtube-search-scraper-output.png) A regular video: ```json { "id": "xP2rh160e_A", "title": "Peppa's NEW Electric Car 🚙 Futuristic Talking Car! 🏎️ Peppa Pig Full Episodes | 2 Hours", "url": "https://www.youtube.com/watch?v=xP2rh160e_A", "type": "video", "duration": "00:31:28", "date": "11 months ago", "viewCount": 9890936, "thumbnailUrl": "https://i.ytimg.com/vi/xP2rh160e_A/hq720.jpg", "channelName": "Peppa Pig - Official Channel", "channelUrl": "https://www.youtube.com/@PeppaPigOfficial", "channelUsername": "PeppaPigOfficial", "channelId": "UCAOtE1V7Ots4DjM8JLlrYgg", "order": 3, "input": "electric cars", "fromYTUrl": "https://www.youtube.com/results?search_query=electric%20cars&sp=CAM%3D", "durationSeconds": 1888, "text": "Peppa and George are playing with an electric toy car. Daddy Pig arrives in a new electric car which he is trying out for fun.", "isChannelVerified": true, "badges": ["CC"], "isLive": false, "channelAvatarUrl": "https://yt3.ggpht.com/rif9IX4_RzmYGQylB0lO0R1jp-Jt7lOYxyOlgBdPtlZZdEhxSu0pMQctyHEInn_wW-0rtb8i7A=s68-c-k-c0x00ffffff-no-rj" } ``` A Short. Search lists Shorts with only a title and a rounded view count; this Actor looks up each one so the row has its channel, upload date and exact views: ```json { "id": "uCWC3xGUNS8", "title": "Minecraft Speedrun", "url": "https://www.youtube.com/shorts/uCWC3xGUNS8", "type": "shorts", "duration": null, "date": "3 months ago", "viewCount": 184546316, "channelName": "clipsdonut", "channelUrl": "https://www.youtube.com/@clipsdonut", "channelUsername": "clipsdonut", "channelId": "UCSx6vsVfEjHKevahvODzJGQ", "order": 2, "input": "minecraft speedrun", "fromYTUrl": "https://www.youtube.com/results?search_query=minecraft%20speedrun&sp=EgIQCQ%3D%3D", "isChannelVerified": false, "badges": [], "isLive": false } ``` **Deduplication.** Within a search, each video is returned once, even though YouTube repeats its Shorts shelves from page to page. Across searches, a video that matches several of your keywords is returned once, under the search that reached it first. Searches run in parallel, so with overlapping keywords that can be either one. `order` still shows the video's real position in YouTube's results for the search it is listed under, so a skipped duplicate leaves a gap in the numbers rather than shifting them. The search keeps paging until it reaches your maximum with new videos. **How deep does a search go?** YouTube lists a limited number of results per search, usually 200 to 400 for a popular keyword including Shorts, and fewer with narrow filters. The run stops a search when YouTube has no more pages or stops showing new videos, and the log says why for each search. ### Guarantees and failure semantics **No error rows, no charge for failures.** Only real videos and Shorts are pushed and charged. A Short whose details can't be loaded after retries is skipped and counted in the status message, never pushed with an empty channel. **Errors are retried.** Every request gets up to three attempts, each from a fresh IP address on the same proxy type. The Actor never switches you to a pricier proxy behind your back. **When a run fails.** A run is marked **FAILED**, so your integration can retry the batch, when: - no result was returned and at least one search got no valid answer from YouTube (blocked, rate-limited, timed out, or every Short lookup failed), or - more than one search, and more than 20% of them, got no valid answer (for example 2 of 3), or - YouTube changed its search page and the results could no longer be read (status `outdated:`), or - the input is invalid, for example an option YouTube no longer supports. The status message starts with a reason code (for example `blocked:` or `outdated:`), followed by a summary. A search that YouTube answers with no results is not a failure: when every search is simply empty, the run ends **SUCCEEDED** with 0 results and names the searches. Stopping at your maximum cost per run is a normal **SUCCEEDED** run. **Run statistics.** The run's key-value store holds a `STATISTICS` record: requests and failures per endpoint, results per search and why each search stopped, Shorts lookups, and results dropped by the date window. In our platform tests on 15 Oct 2026, YouTube answered 386 of 386 search and Shorts requests through Apify's datacenter proxy, across searches in Spanish, Russian, French and English. ### Integrations - **Apify API and clients**: start runs and read results from any language, or with the JavaScript and Python clients. - **Make, Zapier and n8n**: run the Actor from a workflow and pass results to the next step. - **Google Sheets, Slack and webhooks**: send results where your team works, or trigger your own endpoint when a run finishes. - **Schedules**: re-run your keywords every day or week to track rankings over time; `order` gives each video's rank. - **AI agents**: use it as a tool through Apify's MCP server, LangChain or LlamaIndex. ### More scrapers from this developer **TikTok:** [TikTok Search Scraper](https://apify.com/xmolodtsov/tiktok-search-scraper): videos and creators for any keyword, pay per result · [TikTok Profile Scraper (Pay Per Result)](https://apify.com/xmolodtsov/tiktok-profile-scraper): profiles, followers and latest posts by username · [TikTok Comments Scraper](https://apify.com/xmolodtsov/tiktok-comments-scraper): comments and full reply threads from any video · [TikTok Hashtag Scraper](https://apify.com/xmolodtsov/tiktok-hashtag-scraper): videos for any hashtag, with views, likes and music · [TikTok Sound & Music Scraper](https://apify.com/xmolodtsov/tiktok-sound-scraper): videos that use a sound or song **Social & news:** [Reddit Search Scraper](https://apify.com/xmolodtsov/reddit-scraper): posts by keyword, subreddit or author · [Google News Scraper](https://apify.com/xmolodtsov/google-news-scraper): Google News results as clean full-text articles **E-commerce:** [Prom.ua Product Search Scraper](https://apify.com/xmolodtsov/prom-ua): Prom.ua product search results, no browser needed · [Amazon Product Search & Bestsellers Scraper](https://apify.com/xmolodtsov/amazon-search-scraper): search results, Best Sellers and product details from Amazon **Maps & leads:** [Google Maps Scraper](https://apify.com/xmolodtsov/google-maps-scraper): places, leads and emails from Google Maps **Ads:** [Facebook Ad Library Scraper (Meta Ads Library)](https://apify.com/xmolodtsov/facebook-ads-library-scraper): ads from the Meta Ad Library, with EU reach and payers **Video:** [YouTube Transcript Scraper](https://apify.com/xmolodtsov/youtube-transcript-scraper): transcripts, subtitles and captions from YouTube videos · [YouTube Shorts Scraper](https://apify.com/xmolodtsov/youtube-shorts-scraper): Shorts of any channel with exact views, likes and duration · [YouTube Channel Scraper](https://apify.com/xmolodtsov/youtube-channel-scraper): every video of a channel, with channel stats · [YouTube Comments Scraper](https://apify.com/xmolodtsov/youtube-comments-scraper): comments, replies and likes from any video ### FAQ #### Is it legal to scrape YouTube search results? This Actor collects only public information that anyone can see on YouTube without signing in: video titles, view counts, upload dates and public channel names. Scraping publicly available data is generally lawful, but your use of it must follow the laws that apply to you, such as the GDPR in the EU and the CCPA in California, and must respect copyright: titles and thumbnails remain their creators' work. Channel names and handles can identify people, so only process them when you have a legitimate reason. If you are unsure, ask a lawyer. Read more in Apify's post on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). #### Do I need a YouTube API key or a Google account? No. The Actor reads YouTube's public search pages, so there is no API key, no OAuth and no daily quota. You only need an Apify account. #### Why are some titles in English when I searched in another language? The Actor sees YouTube as an English-language viewer in the US. When a creator has added an English title for their video, YouTube shows that version, and so does the dataset. Titles without a translation stay in their original language, and searches work in any language. #### Can I sort by upload date? YouTube removed that option from search. Use **Upload date** (`dateFilter`) with `today`, `week`, `month` or `year` to get recent videos, and combine it with **Popularity** sorting to see what is trending in that window. #### Why do I get fewer results than my maximum? YouTube lists a limited number of results per search, usually a few hundred, and fewer with narrow filters such as a date window or 4K. The run ends that search when YouTube has no more pages, and the log and `STATISTICS` say why for each search. Results already returned by an earlier search in the same run aren't repeated. #### How do I get only Shorts? Set **Max videos per search** to 0 and **Max Shorts per search** to the number you want. Without a date filter, the Actor asks YouTube for Shorts directly. #### Why is `duration` empty for some rows? YouTube's search results show no duration for Shorts or for streams that are live now. Everything else has `duration` and `durationSeconds`. #### How do I track keyword rankings over time? Schedule the Actor with the same searches daily or weekly. `order` is each video's position in the results, and `input` and `fromYTUrl` say which search and filters produced it. #### How fast is it? A search of 200 results usually takes about 15 to 30 seconds. Shorts take a little longer because each one is looked up, and several searches run in parallel. #### Can I scrape channels, comments or transcripts? This Actor is for search. For a channel's videos, a channel's Shorts, video comments and transcripts, see the YouTube line under "More scrapers from this developer" above. ### Support Found a bug, a search that returns less than YouTube shows, or a field you need? Open an issue in the **Issues** tab on this Actor's page with the run link, and we'll take a look. # Changelog This Actor's version history is a separate document: https://apify.com/xmolodtsov/youtube-search-scraper/changelog.md # Actor input Schema ## `searchQueries` (type: `array`): One search per line, in any language, exactly as you would type it into YouTube. Required unless you add search result URLs below. You can also paste a YouTube search results URL (youtube.com/results?search_query=…); its own filters are kept. ## `startUrls` (type: `array`): Optional, instead of or next to search terms: YouTube search results URLs (youtube.com/results?search_query=…), for example from a list you already have. Each URL keeps its own filters. Video, channel and playlist URLs aren't supported. ## `maxResults` (type: `integer`): How many regular videos and live streams to return for each search term. YouTube usually lists 200–400 results per search. Set 0 to get Shorts only. Free Apify plan: 10 results per run in total. ## `maxResultsShorts` (type: `integer`): How many Shorts to return for each search term, on top of the videos. Each Short comes with its channel, upload date and exact view count. 0 skips Shorts. With "Popularity" sorting YouTube shows no Shorts next to videos (set max videos to 0 to get popular Shorts); "Videos only" excludes them. ## `sortingOrder` (type: `string`): YouTube's "Prioritize" setting. YouTube no longer offers sorting by upload date or rating; use "Upload date" below for recent videos. ## `dateFilter` (type: `string`): Only videos uploaded within this window. YouTube mixes a few older videos into date-filtered results; this Actor drops them by their listed upload date. ## `videoType` (type: `string`): "Videos only" hides Shorts, channels and playlists from YouTube's results. Leave empty for the normal mix. ## `lengthFilter` (type: `string`): YouTube's duration buckets. YouTube changed them to under 3 minutes, 3–20 minutes and over 20 minutes; the option names stay compatible with other YouTube scrapers. ## `isLive` (type: `boolean`): Only live streams that are on air. ## `is4K` (type: `boolean`): Only videos available in 4K. ## `isHD` (type: `boolean`): Only videos available in 720p or higher. ## `hasSubtitles` (type: `boolean`): Only videos with subtitles or closed captions. ## `hasCC` (type: `boolean`): Only videos under a Creative Commons licence (reuse allowed). ## `is360` (type: `boolean`): Only 360° videos. ## `isVR180` (type: `boolean`): Only VR180 videos. ## `is3D` (type: `boolean`): Only 3D videos (YouTube counts VR180 stereo videos as 3D). ## `isHDR` (type: `boolean`): Only videos available in HDR. ## `hasLocation` (type: `boolean`): Only videos with a location tag. Works best when the search names a place; generic searches often return nothing. ## `proxyConfiguration` (type: `object`): Optional. Apify datacenter proxy by default, which YouTube search accepts. Change it only to use residential or your own proxies. ## Actor input object example ```json { "searchQueries": [ "lofi hip hop" ], "maxResults": 10, "maxResultsShorts": 0, "sortingOrder": "relevance", "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): One item per video or Short found for your search terms: title, URL, views, upload date, duration, channel name, handle and ID, rank and the search it came from. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "lofi hip hop" ], "maxResults": 10, "maxResultsShorts": 0, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("xmolodtsov/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["lofi hip hop"], "maxResults": 10, "maxResultsShorts": 0, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("xmolodtsov/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 '{ "searchQueries": [ "lofi hip hop" ], "maxResults": 10, "maxResultsShorts": 0, "proxyConfiguration": { "useApifyProxy": true } }' | apify call xmolodtsov/youtube-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,xmolodtsov/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 ` 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/bL79dlKeiQlo8iPFW/builds/Ghn7JKZGBVDtUsIjY/openapi.json