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

{
  "videoUrls": [
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "https://youtu.be/9bZkp7q19f0",
    "kJQP7kiw5Fk"
  ]
}

Example output row

{
  "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