YouTube Movie Search Scraper

Collect current public YouTube video results using the Movie-filter search parameter. The actor returns rich metadata for each visible result and records bounded diagnostics when a public page cannot be read.

Input

{
  "query": "movie trailers",
  "limit": 5,
  "maxPages": 1,
  "locale": "en-US",
  "country": "US",
  "includeDiagnostics": true,
  "enableProxyFallback": true,
  "proxyConfiguration": {"useApifyProxy": false}
}

query is required. limit is bounded to 1-100 and maxPages to 1-5. Public page requests use the selected locale and country. An explicit account-authorized Apify Proxy configuration is supported; if direct access fails, one bounded fallback can be attempted when enabled.

Dataset fields

Records include the video ID and public watch URL, title, description and length, numeric and displayed view counts, publication text, channel name/ID/URL and thumbnail, verification flags, badges, duration in seconds, all observed thumbnails with dimensions, result rank/page, search URL, locale/country, source renderer, extraction provenance, and scrape time.

Only public YouTube HTML and embedded page data are read. The actor does not use private request endpoints, login state, CAPTCHA bypass, stealth, credential-bearing URLs, or opaque continuation replay. Continuation availability is bounded and reported through the run summary rather than replayed.

Verification

npm test
npx apify validate-schema
npx apify run --purge --input-file qa-inputs/youtube-movies-trending-scraper/local-validation.json
node validate-datasets.js

After local checks, deploy with apify actors push, call the latest build directly and with the authorized proxy input, and compare clean records, duplicate video IDs, diagnostics, and OUTPUT counts.