# Youtube Channel Scraper (`scraper-engine/youtube-channel-scraper`) Actor YouTube Channel Scraper extracts channel data at scale. Collect video titles, descriptions, views, likes, upload dates, and channel metadata. Ideal for market research, competitor analysis, content audits, and automation workflows using clean structured outputs. - **URL**: https://apify.com/scraper-engine/youtube-channel-scraper.md - **Developed by:** [Scraper Engine](https://apify.com/scraper-engine) (community) - **Categories:** Lead generation, Social media, Videos - **Stats:** 5 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing $19.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ### πŸ” What is a YouTube Channel Scraper? A YouTube Channel Scraper is an advanced data extraction tool designed to collect structured information from YouTube channels automatically. Instead of manually browsing channels, this scraper gathers valuable data like channel metadata, video details, engagement metrics, and contact information at scale. This tool is especially popular among users searching for: * youtube channel scraper apify * youtube channel scraper python * youtube channel scraper github * the youtube channel crawler From an SEO and growth marketing perspective, a YouTube Channel Scraper enables competitive analysis, influencer research, lead generation, and content strategy optimization. Whether you're using an Apify YouTube scraper, a Python-based YouTube channel scraper, or exploring GitHub YouTube channel scraper projects, the goal remains the same: turn public YouTube data into actionable insights πŸ“Š. ### πŸ› οΈ Support and Feedback - 🐞 **Bug reports:** Open a ticket in the repository **Issues** section - ✨ **Custom solutions or feature requests:** Contact our team πŸ“§ **Email:** dev.scraperengine@gmail.com ### πŸ“Š What Data Can a YouTube Channel Scraper Extract? Below is a detailed overview of what a YouTube Channel Data Extractor can collect: | Data Type | Description | | --- | --- | | Channel Name | Official YouTube channel title | | Channel URL | Direct channel link | | Channel ID | Unique YouTube channel identifier | | Subscriber Count | Total number of subscribers | | Total Videos | Number of videos published | | Total Views | Cumulative channel views | | Video Titles | Titles of all uploaded videos | | Video URLs | Individual video links | | Video Descriptions | Full video descriptions | | Upload Dates | Video publishing dates | | Likes & Comments | Engagement metrics | | Channel Emails | Extracted public emails (when available) | πŸ‘‰ Ideal for users searching youtube channel email extractor free or youtube channel data extractor solutions. * * * #### βš™οΈ Key Features of YouTube Channel Scraper A modern YouTube Channel Scraper Apify solution offers enterprise-grade performance with flexibility and ease of use: * πŸš€ Fast & Scalable Crawling – Scrape thousands of channels efficiently * 🧠 Smart NLP-Friendly Extraction – Clean, structured, SEO-ready data * πŸ”§ Multiple Input Formats – Channel URLs, usernames, or IDs * 🐍 Python-Compatible – Ideal for youtube channel scraper python workflows * 🧩 API & Automation Ready – Integrates with CRMs, dashboards, and pipelines * 🌐 Apify Platform Support – Reliable cloud execution * πŸ“ Multiple Export Formats – JSON, CSV, Excel * πŸ”Œ Alternative Options – Works alongside tools like * Phantombuster YouTube Channel Scraper * Thunderbit YouTube Channel Scraper * YouTube Scraper Chrome Extension This makes it a strong alternative to many YouTube Channel Scraper GitHub repositories that lack scalability. ### πŸ”— What are other YouTube scraping tools? If you want to scrape specific YouTube data, you can use any of the dedicated scrapers below for faster and more targeted results. Just enter one or more YouTube URLs, channel names, video IDs, or keywords and start scraping instantly. | [πŸ’¬ YouTube Comments Scraper](https://apify.com/scraper-engine/youtube-comments-scraper) | [πŸ“ YouTube Transcript Scraper](https://apify.com/scraper-engine/youtube-transcript-scraper) | |---|---| | [πŸ”Ž YouTube Search Scraper](https://apify.com/scraper-engine/youtube-search-scraper) | [πŸŽ₯ YouTube Video Details Scraper](https://apify.com/scraper-engine/youtube-video-details-scraper) | | [πŸ“‚ YouTube Playlist Scraper](https://apify.com/scraper-engine/youtube-playlist-scraper) | [🧠 YouTube Video Summarizer](https://apify.com/scraper-engine/youtube-video-summarizer) | | [☎️ YouTube Channel Phone Number Scraper](https://apify.com/scraper-engine/youtube-channel-phone-number-scraper) | [πŸ‘₯ YouTube Community Posts Scraper](https://apify.com/scraper-engine/youtube-community-posts-scraper) | | [⏱️ YouTube Most Replayed Scraper](https://apify.com/scraper-engine/youtube-most-replayed-scraper) | [πŸ“Š YouTube Metadata Scraper](https://apify.com/scraper-engine/youtube-metadata-scraper) | | [🌐 YouTube Video Subtitles Scraper](https://apify.com/scraper-engine/youtube-video-subtitles-scraper) | [πŸ”₯ YouTube Trending Scraper](https://apify.com/scraper-engine/youtube-trending-scraper) | | [🏷️ YouTube Video Scraper by Hashtag](https://apify.com/scraper-engine/youtube-video-scraper-by-hashtag) | [🎬 YouTube Shorts Scraper](https://apify.com/scraper-engine/youtube-shorts-scraper) | | [πŸ“‘ YouTube Channel Scraper](https://apify.com/scraper-engine/youtube-channel-scraper) | [πŸ“ž YouTube Phone Number Scraper](https://apify.com/scraper-engine/youtube-phone-number-scraper) | | [πŸ“§ YouTube Email Scraper](https://apify.com/scraper-engine/youtube-email-scraper) | [πŸ“¨ YouTube Channel Email Scraper](https://apify.com/scraper-engine/youtube-channel-email-scraper) | ### πŸ› οΈ How to Use YouTube Channel Scraper Follow this step-by-step guide to extract YouTube channel data effortlessly: 1. Log in to Apify πŸ‘‰ Create a free account or sign in. 2. Select the Actor πŸ” Search for β€œYouTube Channel Scraper” in the Apify Store. 3. Enter Input Data πŸ“Œ Paste YouTube channel URLs into the startUrls field. 4. Choose Options βš™οΈ Configure output preferences like video limits or metadata depth. 5. Run the Actor ▢️ Click startβ€”data extraction begins automatically. 6. Download Results πŸ“₯ Export results in JSON, CSV, or Excel format. This workflow is perfect for users learning how to scrape YouTube videos without building scrapers from scratch. * * * ### 🎯 Use Cases for YouTube Channel Scraper A YouTube Channel Scraper unlocks powerful real-world applications: * πŸ“ˆ Digital Marketing – Analyze competitors’ channels and content strategies * 🀝 Influencer Outreach – Find creators by niche, subscribers, and engagement * πŸ§ͺ Market Research – Track trends across thousands of channels * 🧠 AI & NLP Training – Collect structured video metadata for ML models * πŸ’Ό Lead Generation – Extract public contact details for B2B outreach * πŸ“Š Content Strategy – Discover top-performing video topics Widely used by agencies, SaaS teams, and researchers using Apify YouTube Scraper or Fast YouTube Channel Scraper solutions. * * * ### ⭐ Why Choose Our YouTube Channel Scraper? Here’s why professionals prefer this scraper over random GitHub YouTube Channel Scraper scripts: * βœ… No setup required – Cloud-based & beginner-friendly * πŸ”’ Reliable & Maintained – Regular updates and platform compatibility * ⚑ High Performance – Handles large-scale scraping smoothly * 🧩 Flexible Integrations – API-first design * 🌍 Trusted Platform – Built on Apify infrastructure Perfect alternative to tools like Thunderbit YouTube Channel Scraper or browser extensions with limitations. * * * ### πŸ“ˆ How Many Results Can You Scrape with YouTube Channel Scraper? Scalability is where this YouTube Channel Scraper Apify solution truly shines. * πŸ”’ From 1 to 100,000+ channels * πŸŽ₯ Unlimited videos per channel (based on configuration) * ⚑ Parallel processing for faster results * ☁️ Cloud executionβ€”no local machine limits Compared to a YouTube Channel Scraper Python script or APK-based scraper, this solution offers enterprise-level reliability. You can scrape: * Entire niches * Competitor ecosystems * Influencer databases All without worrying about IP blocks or performance bottlenecks. * * * ### βš–οΈ Is It Legal to Scrape YouTube Channel Data? Scraping YouTube data exists in a legal gray area and depends on usage and jurisdiction. βœ… Generally acceptable when: * Data is publicly available * Used for research, analysis, or internal insights * You respect robots.txt and platform terms 🚫 Avoid: * Scraping private data * Republishing content without permission * Violating YouTube’s Terms of Service Always consult legal advice for commercial usage. Ethical scraping is key πŸ›‘οΈ. * * * ### 🧾 Input Parameters #### πŸ”Ή Example Input JSON ```json { "maxResults": 200, "proxyConfiguration": { "useApifyProxy": false }, "scrapeChannelInfo": true, "scrapeLiveStreams": true, "scrapePosts": true, "scrapeShorts": true, "scrapeVideos": true, "startUrls": [ "https://www.youtube.com/@MrBeast" ], "sortOrderVideos": "date", "sortOrderShorts": "date", "sortOrderPosts": "date", "sortOrderLiveStreams": "date" } ```` ### πŸ“€ Output Format #### πŸ”Ή Example Output JSON ```json { "scrapedAt": "2026-01-20T12:40:24.452845", "totalChannels": 1, "maxResultsPerCategory": 200, "MrBeast": { "about": { "channelDescription": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000,000 Trees\n- Removed 30,000,000 pounds of trash from the ocean\n- Helped 2,000 people walk again\n- Helped 1,000 blind people see\n- Helped 1,000 deaf people hear\n- Built wells in Africa\n- Built and gave away 100 houses\n- Adopted every dog in a shelter (twice)\n- Given millions to charity\n- Started my own snack company Feastables\n- Started my own software company Viewstats\n- Started Lunchly, a tasty, better-for-you lunch option\n- Gave away a private island (twice)\n- Gave away 1 million meals\n- I counted to 100k\n- Ran a marathon in the world's largest shoes\n- Survived 50 hours in Antarctica\n- Recreated Squid Game in real life\n- Created the largest competition show with 1000 people (Beast Games)\n- Gave $5,000,000 to one person\n- Passed T-Series to become most subscribed YouTube channel πŸ₯Ή\nyou get it, I appreciate all of you so much :)\n", "channelJoinedDate": "Feb 19, 2012", "channelDescriptionLinks": [ { "text": "Beast Games", "url": "https://linktr.ee/beastgames" }, { "text": "Follow", "url": "https://www.instagram.com/mrbeast/" }, { "text": "Twitter", "url": "https://twitter.com/MrBeast" }, { "text": "Facebook", "url": "https://facebook.com/mrbeast/" } ], "channelLocation": "United States", "channelUsername": "MrBeast", "channelAvatarUrl": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj", "channelBannerUrl": "https://yt3.googleusercontent.com/mdQwWXA5Pf5VnEChXzYoZgeI6u9G5wqfX6RIhK-qNJ1ko41gCMlkzGqF6cbmdOQkjItHNRDF=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj", "channelTotalVideos": 943, "channelTotalViews": 108122546559, "numberOfSubscribers": "462M", "isChannelVerified": true, "channelName": "MrBeast", "channelUrl": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA", "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA", "inputChannelUrl": "http://www.youtube.com/@MrBeast", "isAgeRestricted": false }, "videos": [ { "id": "QJI0an6irrA", "title": "30 Celebrities Fight For $1,000,000!", "duration": "41:58", "channelName": "MrBeast", "channelUsername": "MrBeast", "channelUrl": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA", "date": "12 days ago", "url": "https://www.youtube.com/watch?v=QJI0an6irrA", "viewCount": 88482114, "fromYTUrl": "https://www.youtube.com/@MrBeast/videos", "type": "video", "thumbnailUrl": "https://i.ytimg.com/vi/QJI0an6irrA/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLC5QU6oWI0KN_-xQHuD0H2jKwGiNQ", "input": "https://www.youtube.com/@MrBeast", "order": 0 }, { "id": "ZFoNBxpXen4", "title": "Survive 30 Days Trapped In The Sky, Win $250,000", "duration": "37:26", "channelName": "MrBeast", "channelUsername": "MrBeast", "channelUrl": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA", "date": "4 weeks ago", "url": "https://www.youtube.com/watch?v=ZFoNBxpXen4", "viewCount": 127351878, "fromYTUrl": "https://www.youtube.com/@MrBeast/videos", "type": "video", "thumbnailUrl": "https://i.ytimg.com/vi/ZFoNBxpXen4/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAaVahxiPm84L2HjnDnDCLezbrQ-w", "input": "https://www.youtube.com/@MrBeast", "order": 1 }, { "id": "8bMh8azh3CY", "title": "100 Pilots Fight For A Private Jet", "duration": "28:46", "channelName": "MrBeast", "channelUsername": "MrBeast", "channelUrl": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA", "date": "1 month ago", "url": "https://www.youtube.com/watch?v=8bMh8azh3CY", "viewCount": 122442479, "fromYTUrl": "https://www.youtube.com/@MrBeast/videos", "type": "video", "thumbnailUrl": "https://i.ytimg.com/vi/8bMh8azh3CY/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLASZJffUcdvpY9eLlJXIE5eYBpKHw", "input": "https://www.youtube.com/@MrBeast", "order": 2 }, { "id": "Ah_uuTwGOYU", "title": "World's Strongest Man Vs Robot", "duration": "18:24", "channelName": "MrBeast", "channelUsername": "MrBeast", "channelUrl": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA", "date": "1 month ago", "url": "https://www.youtube.com/watch?v=Ah_uuTwGOYU", "viewCount": 93747156, "fromYTUrl": "https://www.youtube.com/@MrBeast/videos", "type": "video", "thumbnailUrl": "https://i.ytimg.com/vi/Ah_uuTwGOYU/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDzk2JzQAtN4WfALIHvhVfkEHZWiQ", "input": "https://www.youtube.com/@MrBeast", "order": 3 }, ], "stats": { "totalVideos": 120, "totalShorts": 152, "totalLiveStreams": 0, "totalPosts": 54, "scrapingTimeSeconds": 17.78 } }, "summary": { "totalVideos": 120, "totalShorts": 152, "totalLiveStreams": 0, "totalPosts": 54, "totalScrapingTimeSeconds": 17.85 } } ``` ### ❓ FAQ – YouTube Channel Scraper #### 1️⃣ Is this better than a YouTube Channel Scraper GitHub project? Yes. It’s more scalable, maintained, and beginner-friendly. #### 2️⃣ Can I use it with Python? Absolutely. Ideal for youtube channel scraper python workflows. #### 3️⃣ Does it replace a Chrome extension? Yesβ€”browser extensions are limited compared to cloud scraping. #### 4️⃣ Can I extract emails? Only publicly available emails, respecting ethical guidelines. #### 5️⃣ Is this similar to Phantombuster? Yes, but more customizable and scalable. #### 6️⃣ Does it support Apify API? βœ… Fully compatible with Apify YouTube Channel Scraper API. *** ### πŸš€ Final Thoughts A YouTube Channel Scraper is an essential tool for data-driven growth, SEO research, and automation. Whether you’re replacing a YouTube Channel Scraper APK, GitHub script, or Chrome extension, this solution offers speed, accuracy, and scalabilityβ€”all optimized for modern workflows. πŸ‘‰ Start extracting YouTube channel data smarter, faster, and ethically today. # Actor input Schema ## `startUrls` (type: `array`): List of YouTube channel URLs (e.g., https://www.youtube.com/@MrBeast), usernames (e.g., @MrBeast), or keywords to search for channels. ## `maxResults` (type: `integer`): Maximum number of results to scrape per category (videos, shorts, live streams, posts). ## `sortOrderVideos` (type: `string`): Sort order for videos (date, rating, relevance, title, viewCount). ## `sortOrderShorts` (type: `string`): Sort order for shorts (date, rating, relevance, viewCount). ## `sortOrderPosts` (type: `string`): Sort order for community posts (date, relevance). ## `sortOrderLiveStreams` (type: `string`): Sort order for live streams (date, relevance, viewCount). ## `scrapeChannelInfo` (type: `boolean`): Enable to scrape channel about information (description, subscribers, join date, etc.). ## `scrapeVideos` (type: `boolean`): Enable to scrape channel videos. ## `scrapeShorts` (type: `boolean`): Enable to scrape YouTube Shorts. ## `scrapePosts` (type: `boolean`): Enable to scrape community posts. ## `scrapeLiveStreams` (type: `boolean`): Enable to scrape live streams. ## `proxyConfiguration` (type: `object`): Choose which proxies to use. The actor will start with no proxy, fallback to datacenter proxy if blocked, then to residential proxy if datacenter fails. ## Actor input object example ```json { "startUrls": [ "https://www.youtube.com/@MrBeast" ], "maxResults": 10, "sortOrderVideos": "date", "sortOrderShorts": "date", "sortOrderPosts": "date", "sortOrderLiveStreams": "date", "scrapeChannelInfo": true, "scrapeVideos": true, "scrapeShorts": true, "scrapePosts": true, "scrapeLiveStreams": true, "proxyConfiguration": { "useApifyProxy": 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "https://www.youtube.com/@MrBeast" ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("scraper-engine/youtube-channel-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 = { "startUrls": ["https://www.youtube.com/@MrBeast"], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("scraper-engine/youtube-channel-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "https://www.youtube.com/@MrBeast" ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call scraper-engine/youtube-channel-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraper-engine/youtube-channel-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Youtube Channel Scraper", "description": "YouTube Channel Scraper extracts channel data at scale. Collect video titles, descriptions, views, likes, upload dates, and channel metadata. Ideal for market research, competitor analysis, content audits, and automation workflows using clean structured outputs.", "version": "0.1", "x-build-id": "HAk2ZzPReRZ0MwtUU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~youtube-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-youtube-channel-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scraper-engine~youtube-channel-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-youtube-channel-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scraper-engine~youtube-channel-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-youtube-channel-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Channel URLs, Usernames, or Keywords", "type": "array", "description": "List of YouTube channel URLs (e.g., https://www.youtube.com/@MrBeast), usernames (e.g., @MrBeast), or keywords to search for channels.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results Per Category", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of results to scrape per category (videos, shorts, live streams, posts).", "default": 10 }, "sortOrderVideos": { "title": "Sort Order for Videos", "enum": [ "date", "rating", "relevance", "title", "viewCount" ], "type": "string", "description": "Sort order for videos (date, rating, relevance, title, viewCount).", "default": "date" }, "sortOrderShorts": { "title": "Sort Order for Shorts", "enum": [ "date", "rating", "relevance", "viewCount" ], "type": "string", "description": "Sort order for shorts (date, rating, relevance, viewCount).", "default": "date" }, "sortOrderPosts": { "title": "Sort Order for Posts", "enum": [ "date", "relevance" ], "type": "string", "description": "Sort order for community posts (date, relevance).", "default": "date" }, "sortOrderLiveStreams": { "title": "Sort Order for Live Streams", "enum": [ "date", "relevance", "viewCount" ], "type": "string", "description": "Sort order for live streams (date, relevance, viewCount).", "default": "date" }, "scrapeChannelInfo": { "title": "Scrape Channel Information", "type": "boolean", "description": "Enable to scrape channel about information (description, subscribers, join date, etc.).", "default": true }, "scrapeVideos": { "title": "Scrape Videos", "type": "boolean", "description": "Enable to scrape channel videos.", "default": true }, "scrapeShorts": { "title": "Scrape Shorts", "type": "boolean", "description": "Enable to scrape YouTube Shorts.", "default": true }, "scrapePosts": { "title": "Scrape Community Posts", "type": "boolean", "description": "Enable to scrape community posts.", "default": true }, "scrapeLiveStreams": { "title": "Scrape Live Streams", "type": "boolean", "description": "Enable to scrape live streams.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Choose which proxies to use. The actor will start with no proxy, fallback to datacenter proxy if blocked, then to residential proxy if datacenter fails." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```