YouTube bulk report (thumbnail CTR, cards, end screens)
youtube_bulk_reportObtain YouTube thumbnail impressions, CTR, and related bulk reports. Scheduling creates a job; data becomes available within 48 hours.
Instructions
THE ONLY PLACE YOUTUBE PUBLISHES THUMBNAIL IMPRESSIONS AND THUMBNAIL CTR. This is a different API from youtube_channel_report — YouTube’s bulk Reporting API — and for a product that generates thumbnails it is the number that says whether the thumbnail actually worked. Reports: thumbnails (impressions + CTR per video per day) · thumbnails_by_source (the same, split by traffic source, traffic source DETAIL, device and OS) · cards (per-card impressions, clicks and click rate by card_id) · end_screens (per end-screen element) · traffic_source (with the UNCAPPED traffic_source_detail — youtube_channel_report caps that at 25 rows) · basic. IT IS SCHEDULED, NOT ON-DEMAND, AND THIS IS THE ONE THING YOU MUST EXPLAIN TO THE USER: the first call SCHEDULES a job and returns NO DATA. YouTube then writes one CSV per 24-hour Pacific day — the first within 48 hours — plus a backfill of the 30 days before scheduling, and files expire after 60 days. It can NEVER answer about a period before the job existed, so "we have no thumbnail history yet" is a real and correct answer on day one. An unknown report name is refused with the list. Zero rows means missing data for that window, never zero impressions. Read-only, 0 credits.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | how many recent daily files to read (1–14, default 7) | |
| since | No | YYYY-MM-DD — only files whose data starts on or after this | |
| until | No | YYYY-MM-DD — only files whose data starts before this | |
| report | No | default thumbnails | |
| schedule | No | false = do not create the job if it is missing; just report that none exists |