# YouTube Shorts Scraper (`neuro-scraper/youtube-shorts-scraper`) Actor 📹 YouTube Shorts Data Scraper 🤖 | Quickly extract video Title 📝, Channel 🎯, Views 👀, Likes 👍, Comments 💬, Shares 🔄, Upload Date ⏰ & Tags 🏷️. Ideal for content research, analytics, and automating data collection! 🚀 Get more data in least price ❤️ - **URL**: https://apify.com/neuro-scraper/youtube-shorts-scraper.md - **Developed by:** [Neuro Scraper](https://apify.com/neuro-scraper) (community) - **Categories:** Automation, Videos, Other - **Stats:** 15 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $4.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 ## 🎯 YouTube Shorts Metadata Scraper Lightning-fast extraction of detailed YouTube Shorts video data into JSON for analytics, automation, or reporting. ### 📖 Summary Scrape metadata from YouTube Shorts or playlists including title, channel, views, likes, tags, description, and more. ### 💡 Use Cases * Monitor trending Shorts for analytics dashboards * Track competitor channel performance * Automate content research for Shorts * Generate structured reports from playlists or multiple videos ### ⚡ Quick Start — Apify Console 1. Go to the Actor page in Apify Console. 2. Click **Run**. 3. Paste an array of YouTube Shorts URLs in `startUrls`. 4. (Optional) Enable Apify Proxy or provide custom proxies in the **Proxy** panel. 5. Click **Start**. ### ⚡ Quick Start — CLI + API #### CLI ```bash apify run --actor -p input.json ```` #### Python API (apify-client) ```python from apify_client import ApifyClient client = ApifyClient('') run_input = { 'startUrls': ['https://www.youtube.com/shorts/dQw4w9WgXcQ'], 'proxyConfiguration': {'useApifyProxy': True} } run = client.acts.run_actor('', run_input=run_input) print(run['defaultDatasetId']) ``` ### 📝 Inputs - `startUrls`: List of YouTube Shorts video or playlist URLs. - `proxyConfiguration`: Object to configure proxy usage. ### ⚙️ Configuration | 🔑 **Name** | 📝 **Type** | ❓ **Required** | ⚙️ **Default** | 📌 **Example** | 📝 **Notes** | | -------------------- | ------------------- | -------------- | -------------- | ------------------------------------------------ | ---------------------------------- | | `startUrls` | `array` | ✅ Yes | `null` | `["https://www.youtube.com/shorts/dQw4w9WgXcQ"]` | List of target YouTube Shorts URLs | | `proxyConfiguration` | `object` | ⚙️ Optional | `{}` | `{ "useApifyProxy": true }` | Proxy settings for requests | | `ALL_RESULTS` | `dataset/key-value` | ⚙️ Optional | `default` | `ALL_RESULTS` | Key for storing all output data | **Console example:** Paste `startUrls` in input JSON panel or set `APIFY_TOKEN` env variable in Actor settings. ### 📤 Outputs - **Dataset**: JSON objects for each Shorts video containing metadata. Example output item: ```json { "title": "Example Shorts Video", "description": "Short video description...", "duration": 25, "upload_date": "20250101", "url": "https://www.youtube.com/shorts/dQw4w9WgXcQ", "tags": ["fun", "shorts"], "views": 12345, "likes": 678, "dislikes": 10, "comment_count": 45, "category": ["Entertainment"], "thumbnail": "https://example.com/thumb.jpg", "shares": 5, "engagement_ratio": 0.058, "channel_name": "Channel Name", "channel_id": "UC1234567890", "channel_url": "https://www.youtube.com/channel/UC1234567890", "channel_handle": "@channelhandle", "subscribers": 10000, "thumbnails": [], "thumbnail_url_hq": "https://example.com/thumb_hq.jpg", "audio_track": "Song Name", "artist": "Artist Name", "album": "Album Name", "language": "en", "subtitles": ["en"], "is_short": true } ``` ### 🔑 Environment Variables - `APIFY_TOKEN` — your Apify account token. ### ▶️ How to Run - **Console:** Run Actor → paste input JSON → Start. - **CLI:** `apify run --actor -p input.json` - **apify-client:** See Python example above. ### ⏰ Scheduling & Webhooks - Configure schedules in the **Scheduler** panel. - Add webhooks in **Webhook** settings to trigger external callbacks. ### 🐞 Logs & Troubleshooting - ❌ Missing URLs → ensure `startUrls` is provided. - ⚠️ Proxy errors → check proxy configuration and credentials. - ⚠️ Private video errors → may require login cookies. ### 🔒 Permissions & Storage Notes - Actor stores output in default dataset; ensure access to Apify storage. - Proxy credentials should be stored as **secrets**. ### 🆕 Changelog / Versioning Tip - Increment version for major feature additions. - Patch releases for bug fixes. ### 🌍 Proxy Configuration - **Enable Apify Proxy:** In Console, go to **Proxy** panel → toggle **Use Apify Proxy** ✅ - **Custom Proxy:** Set `HTTP_PROXY` / `HTTPS_PROXY` env vars, e.g., `http://` - **Security:** Always store credentials as **secrets** 🔒 - TODO: Add advanced rotating proxy patterns if scraping large playlists. ### 📚 References - [Apify Actor README Guide](https://docs.apify.com/actors/actor-readme) - [Apify Input & Output Docs](https://docs.apify.com/actors/input-output) - [Apify CLI Docs](https://docs.apify.com/cli) ### 🧐 Inferred from main.py - Supports multiple YouTube Shorts URLs or playlists. - Uses optional proxy configuration. - Extracts detailed Shorts metadata including engagement and channel info. - TODO: Confirm support for private videos requiring login cookies. *** ## input.example.json { "startUrls": \[ "" ], "proxyConfiguration": { "useApifyProxy": true } } *** ## CONFIG.md ## Configuration Reference | 🔑 **Name** | 📝 **Type** | ❓ **Required** | ⚙️ **Default** | 📌 **Example** | 📝 **Notes** | | -------------------- | ------------------- | -------------- | -------------- | ------------------------------------------------ | ---------------------------------- | | `startUrls` | `array` | ✅ Yes | `null` | `["https://www.youtube.com/shorts/dQw4w9WgXcQ"]` | List of target YouTube Shorts URLs | | `proxyConfiguration` | `object` | ⚙️ Optional | `{}` | `{ "useApifyProxy": true }` | Proxy settings for requests | | `ALL_RESULTS` | `dataset/key-value` | ⚙️ Optional | `default` | `ALL_RESULTS` | Key for storing all output data | **Example Console input:** ```json { "startUrls": ["https://www.youtube.com/shorts/dQw4w9WgXcQ"] } ``` # Actor input Schema ## `startUrls` (type: `array`): List of one or more YouTube Shorts video URLs ## `proxyConfiguration` (type: `object`): Use Apify Proxy or your own HTTP proxies ## Actor input object example ```json { "startUrls": [ { "url": "https://www.youtube.com/shorts/r-1J94tk5Fo" } ], "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": [ { "url": "https://www.youtube.com/shorts/r-1J94tk5Fo" } ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("neuro-scraper/youtube-shorts-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": [{ "url": "https://www.youtube.com/shorts/r-1J94tk5Fo" }], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("neuro-scraper/youtube-shorts-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": [ { "url": "https://www.youtube.com/shorts/r-1J94tk5Fo" } ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call neuro-scraper/youtube-shorts-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=neuro-scraper/youtube-shorts-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "YouTube Shorts Scraper", "description": "📹 YouTube Shorts Data Scraper 🤖 | Quickly extract video Title 📝, Channel 🎯, Views 👀, Likes 👍, Comments 💬, Shares 🔄, Upload Date ⏰ & Tags 🏷️. Ideal for content research, analytics, and automating data collection! 🚀 Get more data in least price ❤️", "version": "0.0", "x-build-id": "DLIyIM2mk1gGUtDTK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neuro-scraper~youtube-shorts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neuro-scraper-youtube-shorts-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/neuro-scraper~youtube-shorts-scraper/runs": { "post": { "operationId": "runs-sync-neuro-scraper-youtube-shorts-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/neuro-scraper~youtube-shorts-scraper/run-sync": { "post": { "operationId": "run-sync-neuro-scraper-youtube-shorts-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": "Start URLs", "type": "array", "description": "List of one or more YouTube Shorts video URLs", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Use Apify Proxy or your own HTTP proxies", "default": {} } } }, "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 } } } } } } } } } } ```