# YouTube Video Details Scraper (`receptional_blender/youtube-video-info`) Actor Turn any YouTube video URL or ID into clean structured metadata — title, description, channel, view count, length, keywords, thumbnails, publish/upload dates, category and country availability. Powered by YouTube's own InnerTube endpoint, so there's no Data API key and no headless browser. - **URL**: https://apify.com/receptional\_blender/youtube-video-info.md - **Developed by:** [Assia Fadli](https://apify.com/receptional_blender) (community) - **Categories:** Videos - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 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. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Video Details Scraper **YouTube Video Details Scraper** turns any YouTube video link into clean, structured metadata. Paste a single URL or a whole list and get back the details you actually need — title, description, channel, view count, length, keywords, thumbnails, publish and upload dates, category and where the video is available — ready to drop into a spreadsheet, database or downstream pipeline. No YouTube Data API key. No headless browser. It talks to YouTube's own **InnerTube** endpoint (the same one the mobile app uses), so it's fast, cheap and reliable. Built for creators, analysts, agencies and developers who need dependable video metadata without maintaining scraping infrastructure. ### What you get For every video you provide, the actor returns a single dataset record: | Field | Description | | --- | --- | | `videoId` | The 11-character video ID | | `url` | Canonical watch URL | | `title` | Video title | | `description` | Full video description | | `channelName` | Channel / author name | | `channelId` | Channel ID | | `viewCount` | View count (number) | | `lengthSeconds` | Duration in seconds (number) | | `keywords` | Array of video tags / keywords | | `isLiveContent` | Whether the video is / was a live stream | | `thumbnails` | Array of `{ url, width, height }` thumbnails | | `publishDate` | Publish date | | `uploadDate` | Upload date | | `category` | Video category | | `isFamilySafe` | Family-safe flag | | `availableCountries` | Array of country codes where the video is available | If a video can't be read (removed, private, region-locked or temporarily blocked), the actor still writes a row — `{ "videoId": "...", "error": "..." }` — so the rest of the batch always completes. ### Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `videoUrls` | array of strings | ✅ | YouTube video URLs (`watch?v=`, `youtu.be/`, `/shorts/`, `/embed/`, `/live/`) or bare 11-char IDs. | | `videoId` | string | — | A single URL / ID, merged with `videoUrls`. | | `proxyCountryCode` | string | — | Two-letter residential-proxy country code (e.g. `US`, `GB`, `DE`). Optional. | #### Example input ```json { "videoUrls": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "https://youtu.be/9bZkp7q19f0", "kJQP7kiw5Fk" ] } ```` #### Example output row ```json { "videoId": "dQw4w9WgXcQ", "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)", "channelName": "Rick Astley", "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw", "viewCount": 1670000000, "lengthSeconds": 212, "isLiveContent": false, "category": "Music" } ``` ### How it works The actor sends a `POST` to `https://www.youtube.com/youtubei/v1/player` using the InnerTube **ANDROID** client for the core `videoDetails`, and the **WEB** client for the `microformat` fields (publish/upload date, category, availability). Unlike scraping the watch page, the ANDROID client returns the full player response with no Proof-of-Origin / PoToken wall and no login. Requests route through Apify residential proxies with an automatic fallback to a direct request, and each video is fetched independently so one failure never affects the rest. ### Pricing This actor uses Apify's **pay-per-event** model. You're charged once per successfully scraped video (`video-scraped`); error rows are never billed, and the run stops automatically once your budget is reached. ### Use cases - Enrich a list of videos with metadata for research or analytics - Build content dashboards, catalogues or recommendation datasets - Monitor view counts and video availability across countries - Feed clean metadata into downstream ML / data pipelines ### Tech Written in **TypeScript** on the Apify SDK. HTTP-only, so builds are fast and runs are cheap. ### License MIT © Assia Fadli # Actor input Schema ## `videoUrls` (type: `array`): One or more YouTube videos to fetch metadata for. Accepts full URLs in any form (watch?v=, youtu.be/, /shorts/, /embed/, /live/) or bare 11-character video IDs. Each video becomes one dataset row. ## `videoId` (type: `string`): Convenience field for a single YouTube video URL or 11-character ID. Merged with any items in 'videoUrls'. ## `proxyCountryCode` (type: `string`): Optional 2-letter country code (e.g. US, GB, DE) for the Apify residential proxy. Leave empty to let Apify pick automatically. If the proxy is unavailable the actor falls back to a direct request. ## Actor input object example ```json { "videoUrls": [ "https://youtu.be/9bZkp7q19f0", "kJQP7kiw5Fk" ] } ``` # 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 = { "videoUrls": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ] }; // Run the Actor and wait for it to finish const run = await client.actor("receptional_blender/youtube-video-info").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 = { "videoUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"] } # Run the Actor and wait for it to finish run = client.actor("receptional_blender/youtube-video-info").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 '{ "videoUrls": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ" ] }' | apify call receptional_blender/youtube-video-info --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=receptional_blender/youtube-video-info", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "YouTube Video Details Scraper", "description": "Turn any YouTube video URL or ID into clean structured metadata — title, description, channel, view count, length, keywords, thumbnails, publish/upload dates, category and country availability. Powered by YouTube's own InnerTube endpoint, so there's no Data API key and no headless browser.", "version": "1.0", "x-build-id": "AtYudXS3bfG4rDuSF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/receptional_blender~youtube-video-info/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-receptional_blender-youtube-video-info", "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/receptional_blender~youtube-video-info/runs": { "post": { "operationId": "runs-sync-receptional_blender-youtube-video-info", "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/receptional_blender~youtube-video-info/run-sync": { "post": { "operationId": "run-sync-receptional_blender-youtube-video-info", "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": [ "videoUrls" ], "properties": { "videoUrls": { "title": "YouTube video URLs or IDs", "type": "array", "description": "One or more YouTube videos to fetch metadata for. Accepts full URLs in any form (watch?v=, youtu.be/, /shorts/, /embed/, /live/) or bare 11-character video IDs. Each video becomes one dataset row.", "items": { "type": "string" } }, "videoId": { "title": "Single video URL or ID (optional)", "type": "string", "description": "Convenience field for a single YouTube video URL or 11-character ID. Merged with any items in 'videoUrls'." }, "proxyCountryCode": { "title": "Proxy country code (optional)", "type": "string", "description": "Optional 2-letter country code (e.g. US, GB, DE) for the Apify residential proxy. Leave empty to let Apify pick automatically. If the proxy is unavailable the actor falls back to a direct request." } } }, "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 } } } } } } } } } } ```