# YouTube Scraper (`parseforge/youtube-scraper`) Actor Scrape YouTube videos, channels, and transcripts without using an API key. Search videos by keywords, extract detailed channel profiles with subscriber counts, and download captions. Built for speed and reliability, it scales efficiently for large data collection workflows. - **URL**: https://apify.com/parseforge/youtube-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Automation, Social media, Other - **Stats:** 71 total users, 5 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 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/platform/actors/running/actors-in-store#pay-per-event ## 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 ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐ŸŽฌ YouTube Scraper > ๐Ÿš€ **Collect YouTube videos, channels, and playlist data in minutes.** Search by keyword, paste playlist URLs, or channel handles. Export video stats, metadata, thumbnails, and channel profiles. No coding, no YouTube API key. > ๐Ÿ•’ **Last updated:** 2026-04-23 ยท **๐Ÿ“Š 25+ fields** per video ยท **๐Ÿ” Search + playlist modes** ยท **๐Ÿ“… Date + duration filters** ยท **๐Ÿšซ No auth** required The **YouTube Scraper** collects video and channel data from YouTube, returning **25+ fields per video**: title, view count, like count, comment count, duration, upload date, channel name, subscriber count, description, thumbnails, and video URL. Supports search queries, playlist URLs, video URLs, and channel handles. Runs support up to 1,000,000 items on a paid plan. The Actor supports keyword search with filters (sort order, upload date, duration, video type, features) and direct playlist URL scraping. No YouTube Data API key needed. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | Content creators, marketers, market researchers, media agencies, data analysts, academic researchers | Trend research, competitor analysis, content strategy, playlist monitoring, channel benchmarking, audience research | --- ### ๐Ÿ“‹ What the YouTube Scraper does Two input modes with search filters: - ๐Ÿ” **Search mode.** Keywords, video URLs, or channel handles as search queries. - ๐Ÿ“‹ **Playlist mode.** Paste playlist URLs to extract all videos in order. - ๐Ÿ“Š **Sort options.** Relevance, upload date, view count, rating. - ๐Ÿ“… **Upload date filter.** Last hour, today, this week, this month, this year. - โฑ๏ธ **Duration filter.** Short (<4 min), medium (4-20 min), long (>20 min). - ๐ŸŽฌ **Video type filter.** Video, channel, playlist, movie. - ๐Ÿท๏ธ **Feature filters.** Live, 4K, subtitles, Creative Commons, 360, VR180, HDR, location. Each video record includes title, URL, channel name, channel URL, subscriber count, view count, like count, comment count, duration, upload date, description, thumbnails, and tags. > ๐Ÿ’ก **Why it matters:** manually researching YouTube trends, competitor channels, or content strategies means clicking through search results and playlists page by page. This Actor exports structured video data at scale, ready for your dashboards, content calendars, or trend reports. --- ### ๐ŸŽฌ Full Demo _๐Ÿšง Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._ --- ### โš™๏ธ Input
InputTypeDefaultBehavior
searchQueriesarray[]Keywords, video URLs, or channel handles.
playlistUrlsarray[]YouTube playlist URLs.
maxItemsinteger10Max items per source. Free: limited. Paid: up to 1,000,000.
sortBystring""Sort: relevance, date, view count, rating.
uploadDatestring""Filter: last hour, today, this week, this month, this year.
videoDurationstring""Filter: short, medium, long.
videoTypestring""Filter: video, channel, playlist, movie.
featuresarray[]Filters: live, 4K, subtitles, Creative Commons, 360, HDR.
**Example: trending AI videos this week.** ```json { "searchQueries": ["artificial intelligence"], "sortBy": "viewCount", "uploadDate": "thisWeek", "maxItems": 50 } ```` **Example: all videos from a playlist.** ```json { "playlistUrls": ["https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf"], "maxItems": 200 } ``` > โš ๏ธ **Good to Know:** YouTube search results are personalized by region and account. This Actor uses a neutral, logged-out view for consistent results across runs. *** ### ๐Ÿ“Š Output Each video record contains **25+ fields**. Download the dataset as CSV, Excel, JSON, or XML. #### ๐Ÿงพ Schema | Field | Type | Example | |---|---|---| | ๐Ÿ–ผ๏ธ `thumbnailUrl` | string | `"https://i.ytimg.com/vi/..."` | | ๐Ÿ“ `title` | string | `"How AI is Changing Everything"` | | ๐Ÿ”— `videoUrl` | string | `"https://www.youtube.com/watch?v=..."` | | ๐Ÿ‘ค `channelName` | string | `"TechChannel"` | | ๐Ÿ”— `channelUrl` | string | `"https://www.youtube.com/@TechChannel"` | | ๐Ÿ‘ฅ `subscriberCount` | number | `2500000` | | ๐Ÿ‘€ `viewCount` | number | `1200000` | | ๐Ÿ‘ `likeCount` | number | `45000` | | ๐Ÿ’ฌ `commentCount` | number | `3200` | | โฑ๏ธ `duration` | string | `"15:42"` | | ๐Ÿ“… `uploadDate` | string | `"2026-04-10"` | | ๐Ÿ“ `description` | string | `"In this video we explore..."` | | ๐Ÿท๏ธ `tags` | array | `["AI", "technology", "future"]` | | ๐Ÿ•’ `scrapedAt` | ISO 8601 | `"2026-04-16T00:00:00.000Z"` | #### ๐Ÿ“ฆ Sample records
๐ŸŽฌ High-view video from search ```json { "thumbnailUrl": "https://i.ytimg.com/vi/abc123/maxresdefault.jpg", "title": "How AI is Changing Everything in 2026", "videoUrl": "https://www.youtube.com/watch?v=abc123", "channelName": "TechChannel", "channelUrl": "https://www.youtube.com/@TechChannel", "subscriberCount": 2500000, "viewCount": 1200000, "likeCount": 45000, "commentCount": 3200, "duration": "15:42", "uploadDate": "2026-04-10", "description": "In this video we explore how AI is transforming...", "tags": ["AI", "technology", "future"], "scrapedAt": "2026-04-16T00:00:00.000Z" } ```
๐Ÿ“‹ Playlist video with position ```json { "thumbnailUrl": "https://i.ytimg.com/vi/xyz789/default.jpg", "title": "Python Tutorial for Beginners - Part 1", "videoUrl": "https://www.youtube.com/watch?v=xyz789", "channelName": "CodeAcademy", "channelUrl": "https://www.youtube.com/@CodeAcademy", "subscriberCount": 800000, "viewCount": 450000, "likeCount": 12000, "commentCount": 890, "duration": "22:15", "uploadDate": "2025-09-01", "description": "Learn Python from scratch...", "tags": ["python", "tutorial", "programming"], "scrapedAt": "2026-04-16T00:00:00.000Z" } ```
๐Ÿ“ฑ Short video with sparse data ```json { "thumbnailUrl": "https://i.ytimg.com/vi/short1/default.jpg", "title": "Quick cooking hack", "videoUrl": "https://www.youtube.com/watch?v=short1", "channelName": "HomeCook", "channelUrl": "https://www.youtube.com/@HomeCook", "subscriberCount": 1200, "viewCount": 340, "likeCount": 12, "commentCount": 0, "duration": "0:58", "uploadDate": "2026-04-14", "description": "", "tags": [], "scrapedAt": "2026-04-16T00:00:00.000Z" } ```
*** ### โœจ Why choose this Actor | | Capability | |---|---| | ๐Ÿ” | **Search + playlist modes.** Keywords, video URLs, channel handles, and playlist URLs. | | ๐Ÿ“Š | **25+ fields per video.** Views, likes, comments, duration, channel stats, and tags. | | ๐Ÿ“… | **Search filters.** Upload date, duration, video type, and feature flags. | | ๐Ÿ‘ค | **Channel data.** Name, URL, subscriber count per video. | | ๐Ÿ“‹ | **Playlist support.** Extract all videos from any public playlist in order. | | โšก | **Scalable.** From quick 10-video samples to full channel archives. | | ๐Ÿšซ | **No authentication.** No YouTube Data API key needed. | > ๐Ÿ“Š YouTube has over 2 billion logged-in users monthly and 500+ hours of video uploaded every minute. Structured access to video and channel data powers every content strategy, trend analysis, and competitive research workflow. *** ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **โญ YouTube Scraper** *(this Actor)* | $5 free credit, then pay-per-use | Any public video/playlist | **Live per run** | sort, date, duration, type, features | โšก 2 min | | YouTube Data API | Free with quota (10K/day) | Full | Real-time | Many | โณ Hours (API key setup) | | Paid video analytics tools | $50-500/month | Multi-platform | Varies | Many | ๐Ÿข Days | | Manual YouTube browsing | Free | Manual | Manual | UI only | ๐Ÿ•’ Hours per search | Pick this Actor when you want YouTube data on demand, without managing API quotas or keys. *** ### ๐Ÿš€ How to use 1. ๐Ÿ“ **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes). 2. ๐ŸŒ **Open the Actor.** Go to the YouTube Scraper page on the Apify Store. 3. ๐ŸŽฏ **Set input.** Enter search keywords or paste playlist URLs. Set filters and `maxItems`. 4. ๐Ÿš€ **Run it.** Click **Start** and let the Actor collect your data. 5. ๐Ÿ“ฅ **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML. > โฑ๏ธ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required. *** ### ๐Ÿ’ผ Business use cases
#### ๐Ÿ“Š Content Strategy & Marketing - Research trending topics by keyword and view count - Benchmark channel performance against competitors - Track upload frequency and engagement patterns - Build content calendars from competitor analysis #### ๐Ÿ“ˆ Market Research & Analytics - Analyze video performance by topic and category - Track subscriber growth across channels - Study engagement ratios (likes/views, comments/views) - Build longitudinal trend datasets
#### ๐ŸŽ“ Academic & Media Research - Build video datasets for research projects - Study content creation patterns at scale - Analyze thumbnail and title strategies - Track educational content trends #### ๐Ÿ“‹ Playlist & Channel Monitoring - Extract full playlist contents for archival - Track playlist changes over time - Monitor channel upload schedules - Build notification systems for new content
*** ### ๐ŸŒŸ Beyond business use cases Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.
#### ๐ŸŽ“ Research and academia - Empirical datasets for papers, thesis work, and coursework - Longitudinal studies tracking changes across snapshots - Reproducible research with cited, versioned data pulls - Classroom exercises on data analysis and ethical scraping #### ๐ŸŽจ Personal and creative - Side projects, portfolio demos, and indie app launches - Data visualizations, dashboards, and infographics - Content research for bloggers, YouTubers, and podcasters - Hobbyist collections and personal trackers
#### ๐Ÿค Non-profit and civic - Transparency reporting and accountability projects - Advocacy campaigns backed by public-interest data - Community-run databases for local issues - Investigative journalism on public records #### ๐Ÿงช Experimentation - Prototype AI and machine-learning pipelines with real data - Validate product-market hypotheses before engineering spend - Train small domain-specific models on niche corpora - Test dashboard concepts with live input
*** ### ๐Ÿ”Œ Automating YouTube Scraper Control the scraper programmatically for scheduled runs and pipeline integrations: - ๐ŸŸข **Node.js.** Install the `apify-client` NPM package. - ๐Ÿ **Python.** Use the `apify-client` PyPI package. - ๐Ÿ“š See the [Apify API documentation](https://docs.apify.com/api/v2) for full details. The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. Daily pulls keep your content monitoring dashboard in sync. *** ### ๐Ÿค– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - ๐Ÿ’ฌ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20YouTube%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿง  [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20YouTube%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20YouTube%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - ๐Ÿ…’ [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20YouTube%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** ### โ“ Frequently Asked Questions #### ๐Ÿงฉ How does it work? Enter search keywords or paste playlist/video URLs, click Start, and the Actor collects video data from YouTube's public pages, applies your filters, and returns one structured record per video. #### ๐Ÿ“ How accurate is the data? The data is collected from YouTube's public pages. View counts, likes, and subscriber counts reflect the state at the time of the run. #### โฐ Can I schedule regular runs? Yes. Use Apify Schedules to run this Actor daily or weekly and track content trends over time. #### โš–๏ธ Is this data legal to use? This Actor collects publicly available video metadata from YouTube. Review YouTube's terms of service for your specific use case. #### ๐Ÿ’ณ Do I need a paid Apify plan? No. The free plan is enough for testing. A paid plan lifts the item limit. #### ๐Ÿ” What happens if a run fails? Apify automatically retries transient errors. Partial datasets are preserved. #### ๐Ÿ†˜ What if I need help? Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below. *** ### ๐Ÿ”Œ Integrate with any app YouTube Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get alerts on new uploads - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe video data into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets *** ### ๐Ÿ”— Recommended Actors - [**๐Ÿ’ฌ YouTube Comments Scraper**](https://apify.com/parseforge/youtube-comments-scraper) - Comments and replies from YouTube videos - [**๐Ÿ“ธ Instagram Posts Scraper**](https://apify.com/parseforge/instagram-posts-scraper) - Posts and engagement from public profiles - [**๐Ÿฆ X.com Tweets Scraper**](https://apify.com/parseforge/x-com-scraper) - Tweet data and engagement metrics - [**๐Ÿ“ฑ Reddit Posts Scraper**](https://apify.com/parseforge/reddit-posts-scraper) - Reddit posts with engagement data - [**๐ŸŽฌ Auto Video Thumbnail Generator**](https://apify.com/parseforge/auto-video-thumbnail-generator) - Generate video thumbnails > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more video and social media scrapers. *** **๐Ÿ†˜ Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue. *** > **โš ๏ธ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by YouTube, Google LLC, or Alphabet Inc. All trademarks mentioned are the property of their respective owners. Only publicly available video metadata is collected. # Actor input Schema ## `searchQueries` (type: `array`): Enter search terms, video URLs, or channel handles (@channelname). The actor auto-detects the type and enriches each video with full channel profile. ## `maxItems` (type: `integer`): Maximum items to collect per search query, channel, or video URL. For example, if you have 3 search queries and maxItems=10, you'll get up to 10 videos per query (30 total). Free users: Limited to 100 per input. Paid users: Optional, max 1,000,000 per input. ## `sortBy` (type: `string`): How to sort search results ## `uploadDate` (type: `string`): Filter by upload date ## `videoDuration` (type: `string`): Filter by video length ## `videoType` (type: `string`): Filter by video type ## `features` (type: `array`): Filter by video features (select multiple) ## Actor input object example ```json { "searchQueries": [ "python tutorial", "web scraping" ], "maxItems": 10, "sortBy": "relevance", "uploadDate": "any", "videoDuration": "any", "videoType": "video" } ``` # Actor output Schema ## `results` (type: `string`): Complete dataset with all scraped YouTube videos ## `overview` (type: `string`): Overview view with key fields displayed in a table format # 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": [ "python tutorial", "web scraping" ], "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/youtube-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": [ "python tutorial", "web scraping", ], "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("parseforge/youtube-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 '{ "searchQueries": [ "python tutorial", "web scraping" ], "maxItems": 10 }' | apify call parseforge/youtube-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/youtube-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "YouTube Scraper", "description": "Scrape YouTube videos, channels, and transcripts without using an API key. Search videos by keywords, extract detailed channel profiles with subscriber counts, and download captions. Built for speed and reliability, it scales efficiently for large data collection workflows.", "version": "1.0", "x-build-id": "ccE2dxULOLj9PWtm5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~youtube-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-youtube-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/parseforge~youtube-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-youtube-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/parseforge~youtube-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-youtube-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", "properties": { "searchQueries": { "title": "Search Queries or URLs", "type": "array", "description": "Enter search terms, video URLs, or channel handles (@channelname). The actor auto-detects the type and enriches each video with full channel profile.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items Per Input", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum items to collect per search query, channel, or video URL. For example, if you have 3 search queries and maxItems=10, you'll get up to 10 videos per query (30 total). Free users: Limited to 100 per input. Paid users: Optional, max 1,000,000 per input." }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "upload_date", "view_count", "rating" ], "type": "string", "description": "How to sort search results", "default": "relevance" }, "uploadDate": { "title": "Upload Date", "enum": [ "any", "last_hour", "today", "this_week", "this_month", "this_year" ], "type": "string", "description": "Filter by upload date", "default": "any" }, "videoDuration": { "title": "Video Duration", "enum": [ "any", "short", "medium", "long" ], "type": "string", "description": "Filter by video length", "default": "any" }, "videoType": { "title": "Video Type", "enum": [ "video", "film" ], "type": "string", "description": "Filter by video type", "default": "video" }, "features": { "title": "Features", "uniqueItems": true, "type": "array", "description": "Filter by video features (select multiple)", "items": { "type": "string", "enum": [ "hd", "subtitles", "creative_commons", "3d", "live", "purchased", "4k", "360", "location", "hdr", "vr180" ] } } } }, "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 } } } } } } } } } } ```