YouTube
Company YouTube metrics, history, channels, and individual videos.
YouTube
Get Company YouTube Data
GET /api/v1/companies/<company_slug>/youtube/
Auth: API key or logged-in browser session required.
Returns company-level YouTube totals aggregated across active channels. Free accounts receive the current subscriber, video, and cumulative view totals plus up to the three most recent stored calendar-month snapshots. Free access is limited to two calls per hour for this endpoint.
Accelerate, Lead, and active Trial access also receives channel breakdowns, month-over-month growth, and older history.
Paid history parameters:
| Parameter | Type | Description |
|---|---|---|
start_date |
date | Earliest snapshot date, YYYY-MM-DD |
end_date |
date | Latest snapshot date, YYYY-MM-DD |
page |
integer | Page number |
page_size |
integer | Results per page, max 200 |
Explicit Free requests for paid history return 403 Forbidden with the
youtube_paid_access_required error code.
List Company YouTube Videos
GET /api/v1/companies/<company_slug>/youtube/videos/
Auth: Accelerate, Lead, or active Trial access required.
Returns visible individual videos newest-first. Private, deleted, and unavailable records are excluded.
Query parameters: start_date, end_date, channel_slug, is_short,
live_status, order_by, page, and page_size.
Get a Company YouTube Video
GET /api/v1/companies/<company_slug>/youtube/videos/<video_id>/
Auth: Accelerate, Lead, or active Trial access required.
Returns detailed video metadata, engagement counts, description, tags, thumbnails, live-event timestamps, and transcript text.
Legacy YouTube Metrics
GET /api/v1/youtube/<company_slug>/
Returns stored channel metric rows. Free responses are restricted to the three recent month buckets and omit channel and growth fields. Paid responses retain the full historical response.
GET /api/v1/youtube/<company_slug>/latest/
Returns the newest stored channel metric. Free responses contain only the permitted count fields; paid responses also contain channel and growth fields.
YouTube Leaderboard
GET /api/v1/youtube/leaderboard/
Returns company rankings using the latest active-channel metrics. Supported
parameters are sort, months, limit, offset, stage, founded_after,
the minimum metric filters, and include_channels.
Global Video Search
GET /api/v1/youtube/videos/
Searches visible videos across tracked companies. companies, space, and
stage selectors intersect. Date, Shorts, live-status, minimum-view,
performance ordering, and standard pagination parameters are supported. The
response includes observation-time rates and views per day. Accelerate, Lead,
or active Trial access is required.
Composite YouTube Research
GET /api/v1/companies/<company_slug>/youtube/research/
Returns evidence-only target videos, channel history and collection coverage, disjoint direct-competitor and similar-stage benchmarks, 12 completed weeks of normalized trends, and date-scoped Hacker News evidence. Transcript availability is reported without embedding transcript bodies. Accelerate, Lead, or active Trial access is required.