# YouTube Video Details Scraper (views, likes, description, tags) (`webdatatools/youtube-video-details`) Actor YouTube Video Details Scraper returns views, likes, description, tags, category, channel and comment count for any YouTube video URL or ID — no YouTube Data API key or quota needed. - **URL**: https://apify.com/webdatatools/youtube-video-details.md - **Developed by:** [Murat Uzun](https://apify.com/webdatatools) (community) - **Categories:** Social media, Videos, Automation - **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.60 / 1,000 videos 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 is YouTube Video Details Scraper? **YouTube Video Details Scraper returns views, likes, description, tags, category, channel and comment-count data for any public YouTube video** — no YouTube Data API key, no daily quota, and no browser required. Paste a video URL or ID and get one structured row per video: title, exact view and like counts, full description, uploader-set keywords, category, channel name/ID/URL, subscriber count text, publish date, duration and more. Point it at [any YouTube video](https://www.youtube.com) and run it on Apify with scheduling, API access and monitoring built in. Under the hood it reads the same `ytInitialPlayerResponse` block the youtube.com watch page embeds for itself, plus the `youtubei/v1/next` endpoint the page calls for the sidebar and comments panel — so there is nothing to authenticate and no per-request cost from Google. ### Why use YouTube Video Details Scraper? - **Content research** — pull view/like counts, tags and descriptions across a competitor's or influencer's catalog to spot what performs. - **SEO and metadata audits** — check whether a channel's videos have keywords, a filled-in description and a matching category. - **Monitoring and reporting** — schedule a run to track view/like growth on a set of videos over time. - **AI agent tooling** — let an agent look up "how many views does this video have" without writing any scraping code. ### How to use YouTube Video Details Scraper 1. Click **Try for free** (or **Run** if you already have it open). 2. In **Videos**, paste one or more YouTube URLs or bare video IDs. 3. Optionally set **Max concurrency**, **Language** and **Region**. Leave **Proxy configuration** on its default (Residential) for platform runs. 4. Click **Start** and watch rows appear in the **Dataset** tab as they're fetched. 5. Export the results as JSON, CSV, Excel or HTML, or pull them via the API. ### Input | Field | Type | Description | | ------------------- | ------- | ------------------------------------------------------------------------------------------------------------------- | | `videos` | array | Video IDs or URLs (watch, shorts, `youtu.be`). Default: `["dQw4w9WgXcQ"]`. | | `proxyMode` | string | `auto`, `always` or `never` — see **Proxy requirement** below. Default `auto`. | | `proxyConfiguration`| object | Which Apify Proxy group to use when `proxyMode` needs one. Default: Residential proxy. | | `maxConcurrency` | integer | Videos fetched in parallel, 1–10. Default `3`. | | `language` | string | UI language code, e.g. category name. Default `en`. | | `region` | string | 2-letter country code. Default `US`. | See the **Input** tab for the full schema with examples. #### Example input ```json { "videos": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ", "jNQXAC9IVRw"], "maxConcurrency": 3 } ``` ### Proxy requirement YouTube's watch page and its `/player`/`/next` endpoints can return a "Sign in to confirm you're not a bot" page to requests coming from Apify's own datacenter IP ranges — this comes and goes (a run can succeed for hours, then start failing without any code change). The **Proxy mode** input controls how the Actor reacts: - **Auto (default)** — every request is tried directly first, with zero proxy cost; the moment YouTube blocks a direct request, the Actor switches to Apify Proxy (see **Proxy configuration**) for the rest of that run, so later videos don't re-pay the failed-direct attempt. - **Always** — skip the direct attempt and route everything through the proxy from the start. - **Never** — always request directly, even if that means some videos come back with an error. When the proxy is in play, the Actor also minimizes what goes through it: it prefers the small `/youtubei/v1/player` call (a few KB) over the ~1 MB watch page, and skips the (surprisingly large, ~370-420 KB) `/next` call entirely once a run is already paying for proxy bandwidth — `/next` only ever adds a few optional fields (exact subscriber-count text, comment count, a like-count fallback), so it isn't worth its size once you're not getting it for free. ### Output One row per video: ```json { "videoId": "dQw4w9WgXcQ", "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)", "description": "The official video for \"Never Gonna Give You Up\" by Rick Astley...", "keywords": ["rick astley", "Never Gonna Give You Up", "rick roll"], "category": "Music", "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw", "channelName": "Rick Astley", "channelUrl": "https://www.youtube.com/@RickAstleyYT", "subscriberCountText": "4.54M subscribers", "publishDate": "2009-10-24T23:57:33-07:00", "uploadDate": "2009-10-24T23:57:33-07:00", "viewCount": 1815026601, "likeCount": 19386875, "commentCountText": "2.4M", "durationSeconds": 213, "isLive": false, "isLiveContent": false, "isPrivate": false, "isFamilySafe": true, "isUnlisted": false, "thumbnailUrl": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/maxresdefault.webp", "chapters": [], "hashtags": [ "#RickAstleyNever", "#RickAstley", "#NeverGonnaGiveYouUp", "#WheneverYouNeedSomebody", "#OfficialMusicVideo" ], "error": null, "scrapedAt": "2026-09-13T00:00:00.000Z" } ``` You can download the dataset in various formats such as JSON, CSV, Excel or HTML. #### Data table | Field | Description | | -------------------------------------------------------------------- | --------------------------------------------------------------------------- | | `videoId`, `url`, `title` | Video identity | | `description`, `keywords`, `category` | Full description (up to 5000 chars), uploader-set tags and YouTube category | | `channelId`, `channelName`, `channelUrl`, `subscriberCountText` | Uploading channel | | `publishDate`, `uploadDate`, `durationSeconds` | Timing | | `viewCount`, `likeCount`, `commentCountText` | Engagement | | `isLive`, `isLiveContent`, `isPrivate`, `isFamilySafe`, `isUnlisted` | Status flags | | `thumbnailUrl` | Highest-resolution thumbnail | | `chapters`, `hashtags` | Best-effort, parsed from the description text | | `error` | Set instead of video data when the video is unavailable | ### Pricing This Actor uses **Pay-per-event** pricing: **$0.001 per video row**. Fetching details for 1,000 videos costs about **$1.00**. There is no separate compute-unit charge on top — the price already covers it. Apify Proxy adds a small infrastructure cost on top of that, paid from your Apify plan's proxy allowance rather than charged to the caller. With the default **Auto** proxy mode, that cost is **$0** whenever YouTube isn't currently blocking the run's IP (the common case). Measured live: in **Auto** mode with a block triggered mid-run, and in **Always** mode (proxy used for every request), proxy data transfer cost **~$0.00007 per video** in both cases — the Actor's direct-first strategy and its preference for the small `/player` call over the ~1 MB watch page and the ~400 KB `/next` call keep this small even in the worst case, well inside the Residential free-plan allowance (20 GB/month). ### YouTube Video Details Scraper vs. the YouTube Data API The official YouTube Data API v3 `videos.list` endpoint requires a Google Cloud project, an API key, and burns your daily quota (10,000 units — a few thousand video reads) fast. This Actor reads the same public data the youtube.com watch page loads for itself, with no key, no quota, and results delivered as a ready-to-export dataset. ### Using YouTube Video Details Scraper with AI agents / MCP This Actor is published with Pay-per-event pricing and limited permissions, so it is directly callable through the [Apify MCP Server](https://mcp.apify.com) and AI agent frameworks that support Apify tools — an agent can ask "how many views and likes does this video have" and get structured JSON back without any custom scraping code. ### FAQ **Is this legal?** The Actor reads publicly visible video metadata the same way a browser loading youtube.com does. Respect YouTube's Terms of Service and applicable data-protection law for how you store and use the results. **What about private, deleted or unavailable videos?** These return a row with `error` set and every other field `null` — nothing to configure, just check the `error` field. **What happens with age-restricted videos?** Metadata (title, views, likes, description, channel) is still public even when playback itself would need a signed-in account, so age-restricted videos return a normal, full row — only genuinely private/deleted/removed videos produce an `error` row. **Why is `likeCount` sometimes approximate?** YouTube's watch page exposes an exact like count for almost every video. On the rare video where that field is missing, the Actor falls back to the like button's own compact count/accessibility text, which can be off by a handful due to normal live-count drift between the two page loads. **Are `chapters` always filled in?** No — chapters are parsed on a best-effort basis from timestamp lines in the description (the same convention YouTube's own chapter-list detector uses), and only returned when at least two distinct timestamps are found. Many videos have no chapter list at all, so this is often an empty array. **Will large batches get rate-limited?** The Actor routes requests through Apify Proxy by default (see **Proxy requirement** above) — each parallel request gets its own proxy session. For very large batches, keep `maxConcurrency` at 2–3; on an HTTP 429 the Actor waits 5 seconds and retries once before giving up on that page. **Can I use this in n8n, Make or Zapier?** Yes — call the Actor via its Apify API endpoint from any of these tools' native Apify integration or a generic HTTP node, or trigger it from a webhook. ### Related Actors Part of the **webdatatools** web-intelligence suite — every Actor is pay-per-event, reads public data without a login, and returns one clean row per entity: Browse the whole suite at [webdatatools](https://paulet4a-commits.github.io/webdatatools/), or call ten of these Actors straight from Claude, Cursor or Cline with the [webdatatools MCP server](https://github.com/paulet4a-commits/webdatatools-mcp-server). **Website & domain intelligence** - [Email Extractor — Website Contact & Social Finder](https://apify.com/webdatatools/contact-extractor) — e-mails, phones and social profiles per domain - [Tech Stack Detector — Wappalyzer & BuiltWith Alternative](https://apify.com/webdatatools/tech-stack-detector) — CMS, e-commerce, analytics, pixels and payments per domain - [Domain DNS & Email Security Checker](https://apify.com/webdatatools/dns-email-security-checker) — SPF, DKIM, DMARC, MX provider, registrar and domain age - [Domain Security Audit (TLS, HTTP headers, redirects, robots)](https://apify.com/webdatatools/domain-security-audit) — TLS expiry, security headers, redirect chain, robots and llms.txt - [Subdomain Finder (Certificate Transparency)](https://apify.com/webdatatools/subdomain-finder) — every subdomain seen in CT logs, with a live DNS check - [Bulk Core Web Vitals & PageSpeed Audit](https://apify.com/webdatatools/core-web-vitals-audit) — Lighthouse scores, LCP, CLS, INP and top fixes per URL - [On-Page SEO Audit](https://apify.com/webdatatools/seo-page-audit) — title, meta, headings, links, images and schema issues per page - [Sitemap URL Extractor & Change Monitor](https://apify.com/webdatatools/sitemap-extractor) — every sitemap URL, or new and removed pages between runs - [Wayback Machine Snapshot & Page Change Tracker](https://apify.com/webdatatools/wayback-page-diff) — how a page changed over time, or every archived snapshot - [Bulk Domain WHOIS & RDAP Lookup](https://apify.com/webdatatools/domain-whois-rdap) — registrar, dates, status and nameservers per domain - [Web Scraper — CSS Selector & Data Extractor](https://apify.com/webdatatools/css-selector-extractor) — pull any CSS selector off any page, one row per URL - [Website Screenshot Generator](https://apify.com/webdatatools/website-screenshot) — full-page or viewport PNG/JPEG screenshots of any URL **Content for AI, LLMs and RAG** - [AI Web Search & Read: Google results as clean Markdown](https://apify.com/webdatatools/ai-web-search) — a query turned into clean Markdown from the top search results - [Website to Markdown — Content Crawler for LLM & RAG](https://apify.com/webdatatools/website-to-markdown) — any site as clean Markdown per page, no browser - [Article & News Extractor (clean text, author, date, markdown)](https://apify.com/webdatatools/article-extractor) — clean article text, author, date and Markdown per URL - [Structured Data & JSON-LD Extractor (Schema.org, Open Graph)](https://apify.com/webdatatools/structured-data-extractor) — Schema.org and Open Graph data from any page - [Google News Scraper (RSS search by keyword, topic, site)](https://apify.com/webdatatools/google-news-scraper) — news results by keyword, topic or site - [Press Release Monitor: PR Newswire, BusinessWire, GlobeNewswire](https://apify.com/webdatatools/press-release-monitor) — PR Newswire, Business Wire and GlobeNewswire releases **Search, video and social** - [YouTube Shorts Scraper](https://apify.com/webdatatools/youtube-shorts-scraper) — Shorts from channels, hashtags and searches with view counts - [Pinterest Pins Scraper](https://apify.com/webdatatools/pinterest-pins-scraper) — latest pins of public Pinterest profiles and boards - [YouTube Transcript Scraper](https://apify.com/webdatatools/youtube-transcript-scraper) — captions and subtitles as text + timed segments, per video or channel - [Google Search Results Scraper — SERP API](https://apify.com/webdatatools/google-search-scraper) — organic SERP results per keyword and country - [YouTube Comments Scraper — Comments & Replies](https://apify.com/webdatatools/youtube-comments-scraper) — comments and replies with likes, no API key - [YouTube Channel Latest Videos (RSS, no API key)](https://apify.com/webdatatools/youtube-channel-videos) — the latest 15 videos of any channel from RSS - [YouTube Channel Scraper (videos, shorts, live)](https://apify.com/webdatatools/youtube-channel-scraper) — a channel's full video, shorts and stream list - [YouTube Search Results Scraper (videos, channels, no API key)](https://apify.com/webdatatools/youtube-search-scraper) — videos, channels and playlists per query - [Apple Podcasts Lookup & Episodes Scraper](https://apify.com/webdatatools/podcast-lookup) — podcast metadata and episodes from iTunes and RSS - [Bluesky Post, Search & Profile Scraper](https://apify.com/webdatatools/bluesky-scraper) — posts, profiles, followers and threads from the AT Protocol API - [Telegram Channel Posts Scraper](https://apify.com/webdatatools/telegram-channel-scraper) — posts, views and media flags from any public channel - [Substack Publication & Posts Scraper](https://apify.com/webdatatools/substack-scraper) — archive, authors and paywall status per publication - [Google Play Reviews Scraper](https://apify.com/webdatatools/google-play-reviews-scraper) — reviews, ratings, replies and app versions per app - [App Store Reviews Scraper](https://apify.com/webdatatools/app-store-reviews-scraper) — iOS reviews and ratings per app and country - [Google Trends Scraper](https://apify.com/webdatatools/google-trends-scraper) — interest over time, by region, and related queries per keyword - [Google Ads Transparency Scraper](https://apify.com/webdatatools/google-ads-transparency-scraper) — ads any advertiser runs on Google, with format and dates - [Keyword Suggestions Scraper (Google, YouTube, Amazon, Bing)](https://apify.com/webdatatools/keyword-suggestions-scraper) — autocomplete keyword ideas from four search engines - [Bilibili Scraper (Videos, Search, Popular)](https://apify.com/webdatatools/bilibili-scraper) — Chinese video platform: views, likes, coins, danmaku, uploader - [Mastodon Scraper (Hashtags, Accounts, Trending)](https://apify.com/webdatatools/mastodon-scraper) — public fediverse posts by hashtag, account or trending - [Meetup Events Scraper (Search by Keyword & City)](https://apify.com/webdatatools/meetup-events-scraper) — upcoming events with RSVPs, fees, venues and groups - [Eventbrite Scraper (Events by Keyword & City)](https://apify.com/webdatatools/eventbrite-scraper) — events by keyword and city with venue, dates and organizer **Leads, jobs and company data** - [Career Site Jobs API (Greenhouse, Lever, Ashby, Workday +1)](https://apify.com/webdatatools/career-site-jobs-api) — company domains in, their open jobs out, ATS detected automatically - [Workday Jobs Scraper](https://apify.com/webdatatools/workday-jobs-scraper) — jobs with full descriptions from any Workday career site - [Google Maps Scraper](https://apify.com/webdatatools/google-maps-scraper) — businesses with phone, website, address, rating and coordinates per search - [LinkedIn Jobs Scraper](https://apify.com/webdatatools/linkedin-jobs-scraper) — job titles, companies, locations and full descriptions from LinkedIn job search - [Company 360: full company profile from a domain](https://apify.com/webdatatools/company-360) — one row per domain: contacts, tech, security, hiring and company facts - [Hiring Signals Scraper (Greenhouse, Lever, Ashby, Workable)](https://apify.com/webdatatools/hiring-signals) — open jobs and hiring velocity from 10 public ATS boards - [Y Combinator Companies & Founders Scraper](https://apify.com/webdatatools/yc-companies-scraper) — YC startups by batch, industry and hiring status - [Wikidata Entity & Company Enrichment (facts, IDs, links)](https://apify.com/webdatatools/wikidata-entity-enrichment) — HQ, founders, employees, revenue and social IDs per company - [Email Validator & Verifier — Bulk Email Check](https://apify.com/webdatatools/email-validator) — syntax, MX, disposable, role and free-provider checks - [OpenStreetMap POI Extractor (Overpass API: shops, amenities)](https://apify.com/webdatatools/overpass-poi-extractor) — shops and amenities by radius, bbox or area - [Stock, Crypto & FX Quotes](https://apify.com/webdatatools/market-quotes) — one row per symbol from Yahoo, Binance and ECB rates - [Remote Jobs Aggregator (RemoteOK, WWR, Hacker News)](https://apify.com/webdatatools/remote-jobs-aggregator) — one clean row per remote job, de-duplicated across feeds - [Greenhouse Jobs Scraper](https://apify.com/webdatatools/greenhouse-jobs-scraper) — jobs with descriptions from any Greenhouse job board - [Lever Jobs Scraper](https://apify.com/webdatatools/lever-jobs-scraper) — jobs with descriptions from any Lever careers page - [Ashby Jobs Scraper](https://apify.com/webdatatools/ashby-jobs-scraper) — jobs, salaries and descriptions from any Ashby job board - [SmartRecruiters Jobs Scraper](https://apify.com/webdatatools/smartrecruiters-jobs-scraper) — jobs with descriptions from any SmartRecruiters company - [Seek Jobs Scraper (Australia & New Zealand)](https://apify.com/webdatatools/seek-jobs-scraper) — Seek job ads with salary, work type and location - [Dice Jobs Scraper](https://apify.com/webdatatools/dice-jobs-scraper) — US tech jobs from Dice with salary and remote flag - [AutoScout24 Scraper](https://apify.com/webdatatools/autoscout24-scraper) — European car listings with price, mileage and seller - [Rightmove Scraper](https://apify.com/webdatatools/rightmove-scraper) — UK property for sale or rent with price and agent - [Wellfound Jobs Scraper (AngelList Startup Jobs)](https://apify.com/webdatatools/wellfound-jobs-scraper) — startup jobs with salary and equity ranges, company size and stage - [Yandex Maps Scraper (Places, Ratings, Phones)](https://apify.com/webdatatools/yandex-maps-scraper) — businesses in Russia, Türkiye and the CIS with phones, ratings, hours - [Craigslist Scraper (Listings, Prices, Locations)](https://apify.com/webdatatools/craigslist-scraper) — listings in any area and category with price, date and coordinates - [JobStreet Scraper (Malaysia, Singapore, PH, ID + JobsDB)](https://apify.com/webdatatools/jobstreet-scraper) — JobStreet and JobsDB jobs in 6 Asian countries with parsed salaries - [InfoJobs Scraper (Spain Jobs, Salaries, Companies)](https://apify.com/webdatatools/infojobs-scraper) — Spanish jobs with salary range, contract type and full description - [Redfin Scraper (Homes for Sale, Prices, Details)](https://apify.com/webdatatools/redfin-scraper) — US homes for sale or sold from any Redfin search, with price and details - [Kleinanzeigen Scraper (Ads, Prices, Locations)](https://apify.com/webdatatools/kleinanzeigen-scraper) — German classifieds with price, VB flag, ZIP, city and seller type **Developer, app and research data** - [npm, PyPI & Crates.io Package Health Checker](https://apify.com/webdatatools/package-health-checker) — releases, downloads, deprecation and a health score - [GitHub Repository Health & Activity Report](https://apify.com/webdatatools/github-repo-health) — stars, commits, contributors and risk flags per repo - [VS Code Marketplace Extension Scraper (installs, ratings)](https://apify.com/webdatatools/vscode-marketplace-extensions) — installs, ratings and versions per extension - [Chrome Web Store Extension Scraper (installs, ratings)](https://apify.com/webdatatools/chrome-web-store-extensions) — users, rating, version and developer per extension - [Google Play Scraper](https://apify.com/webdatatools/google-play-scraper) — apps, ratings, installs, developer contact and reviews - [App Store (iOS) App Metadata, Ratings & Top Charts Lookup](https://apify.com/webdatatools/app-store-lookup) — ratings, price, version and charts per app - [CrossRef DOI & Citation Metadata Lookup](https://apify.com/webdatatools/crossref-doi-lookup) — papers, authors, journals and citation counts - [FDA Recalls & Adverse Events Monitor (openFDA)](https://apify.com/webdatatools/openfda-recall-monitor) — food, drug and device recalls from openFDA - [iCal / ICS Calendar Feed to Events Extractor](https://apify.com/webdatatools/ical-calendar-extractor) — any public calendar feed as event rows - [Shopify Store Products Scraper](https://apify.com/webdatatools/shopify-products-scraper) — catalog, prices, variants and stock per store - [Hacker News Search & Front Page Scraper](https://apify.com/webdatatools/hacker-news-scraper) — stories, comments and points by query or front page - [GitHub Trending Repositories Scraper](https://apify.com/webdatatools/github-trending-scraper) — trending repos and developers by language and period - [Stack Overflow & Stack Exchange Q\&A Scraper](https://apify.com/webdatatools/stackexchange-scraper) — questions, answers and scores by query, tag or site - [Bulk Image Downloader](https://apify.com/webdatatools/bulk-image-downloader) — download image URLs to storage with size, dimensions and a ZIP - [Google Flights Scraper (Prices, Airlines, Stops)](https://apify.com/webdatatools/google-flights-scraper) — flight prices, airlines, times, stops and CO2 by route and date - [Google Hotels Scraper (Prices, Ratings, Reviews)](https://apify.com/webdatatools/google-hotels-scraper) — hotel prices per night, stars, rating and reviews by city and dates - [AliExpress Scraper (Search Products & Prices)](https://apify.com/webdatatools/aliexpress-scraper) — AliExpress search results with USD price, discount and rank - [Lazada Scraper (Products, Prices, Sold, Ratings)](https://apify.com/webdatatools/lazada-scraper) — Lazada products in 6 countries with price, rating, units sold and seller ### Support Found a bug or have a feature request? Open an issue on the Actor's **Issues** tab in Apify Console. Custom scraping solutions are also available on request. # Actor input Schema ## `videos` (type: `array`): Enter YouTube video IDs or URLs, one row is returned per video. Accepts a bare ID (dQw4w9WgXcQ), a watch URL, a shorts URL, or a youtu.be link, e.g. https://www.youtube.com/watch?v=dQw4w9WgXcQ. ## `proxyMode` (type: `string`): 'auto' (recommended) requests YouTube directly first and only switches to Apify Proxy for the rest of the run if a direct request gets blocked — this keeps proxy cost at $0 whenever YouTube isn't currently blocking datacenter IPs. 'always' skips the direct attempt and always uses the proxy. 'never' always requests directly, even if that means errors. ## `proxyConfiguration` (type: `object`): Which Apify Proxy group to use when 'Proxy mode' above decides a request needs the proxy (either 'auto' after a block, or 'always'). Leave Residential proxy selected (the default) unless you know a datacenter group works for your account. Not needed when running locally with your own IP. ## `maxConcurrency` (type: `integer`): Enter how many videos to fetch in parallel, e.g. 3. Each video needs one watch-page request plus one /next request; keep this at 2-3 for large lists to avoid HTTP 429 rate limiting. ## `language` (type: `string`): Enter a 2-letter language code YouTube should localize its UI text to, e.g. en. This affects labels like the category name and relative date text, not the video's own title or description. ## `region` (type: `string`): Enter a 2-letter country code for YouTube to use when resolving region-specific details, e.g. US. ## Actor input object example ```json { "videos": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "jNQXAC9IVRw" ], "proxyMode": "auto", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxConcurrency": 3, "language": "en", "region": "US" } ``` # Actor output Schema ## `videos` (type: `string`): All fetched videos — download as JSON, CSV, Excel or HTML. # 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 = { "videos": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "jNQXAC9IVRw" ], "proxyMode": "auto", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxConcurrency": 3, "language": "en", "region": "US" }; // Run the Actor and wait for it to finish const run = await client.actor("webdatatools/youtube-video-details").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 = { "videos": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "jNQXAC9IVRw", ], "proxyMode": "auto", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, "maxConcurrency": 3, "language": "en", "region": "US", } # Run the Actor and wait for it to finish run = client.actor("webdatatools/youtube-video-details").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 '{ "videos": [ "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "jNQXAC9IVRw" ], "proxyMode": "auto", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxConcurrency": 3, "language": "en", "region": "US" }' | apify call webdatatools/youtube-video-details --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,webdatatools/youtube-video-details" } } } ``` 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/oIsr3QIQoU6d5wmZn/builds/oTA61tfwVPPUjdPve/openapi.json