YouTube Gaming Trends Scraper

Collect ranked video cards from the public YouTube Gaming page. The actor reads the public HTML response and embedded initial data only; it does not use private YouTube client APIs, stealth, CAPTCHA solving, or browser fingerprint spoofing.

Input

Field	Default	Description
maxItems	50	Maximum unique video cards, from 1 to 200.
countryCode	US	Two-letter region for the public Gaming page.
locale	en-US	Page locale in language-country form.
includeDiagnostics	true	Emit exact four-field diagnostics for blocked or unusable pages.
enableProxyFallback	true	Try standard account-authorized Apify Proxy after direct access fails.
maxRetries	2	Bounded retries per route, from 0 to 3.
requestDelayMs	250	Bounded pacing setting.
requestTimeoutSecs	60	Public-page timeout, from 15 to 180 seconds.
proxyConfiguration	—	Standard Apify Proxy or credential-free HTTP/SOCKS proxy configuration.

Output

Each video record includes rank and section, canonical video URL/ID, title and description, description length, thumbnail URL and all public thumbnail variants, channel identity and URL, displayed and parsed views, publication text, duration and parsed seconds, live state, badges, public rich metadata, game/category labels when YouTube supplies them, region/locale, source-page URL, extraction method, metadata source, and timestamp. Optional values are omitted when the public page does not expose them.

Diagnostics contain exactly url, error, errorCode, and scrapedAt. The OUTPUT key-value record summarizes counts, failures/blocks, proxy state, locale, and duration.

Verification

npm test
npx apify validate-schema .actor/input_schema.json
npx apify run --purge --input-file qa-inputs/youtube-gaming-trends-scraper/local-validation.json
npm run validate-dataset
npx apify actors call <ACTOR_ID> --build latest --input-file qa-inputs/youtube-gaming-trends-scraper/cloud-validation.json --timeout 300 --json