YouTube
Public read-only endpoints for YouTube metrics and leaderboards.
YouTube
List YouTube Metrics
GET /api/v1/youtube/<company_slug>/
Auth: API key or logged-in browser session required.
Returns stored YouTube metrics for a company, ordered by newest parse date first.
Query parameters:
| Parameter | Type | Description |
|---|---|---|
page |
integer | Page number |
page_size |
integer | Results per page, max 200 |
Response fields include: date_parsed, subscriber_count,
videos_count, views_count, company_slug, channel_id, channel_name,
subscriber_percent_growth, videos_percent_growth, and
views_percent_growth.
Get Latest YouTube Metrics
GET /api/v1/youtube/<company_slug>/latest/
Auth: API key or logged-in browser session required.
Returns the newest stored YouTube metrics snapshot for the company.
Returns 404 Not Found if the company has no stored YouTube metrics.
YouTube Leaderboard
GET /api/v1/youtube/leaderboard/
Auth: API key or logged-in browser session required.
Returns a ranked company leaderboard based on the latest active YouTube channel metrics.
Query parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
sort |
string | subscribers |
One of subscribers, views, videos, views_per_video, subscriber_growth, view_growth, video_growth |
months |
integer | 1 |
Growth comparison window, from 1 to 24 |
limit |
integer | 50 |
Number of results to return, max 200 |
offset |
integer | 0 |
Result offset |
stage |
string | - | Filter by current_stage; use public for public companies |
founded_after |
integer | - | Filter by founding year |
min_subscribers |
integer | - | Minimum subscriber count |
min_views |
integer | - | Minimum view count |
min_videos |
integer | - | Minimum video count |
min_views_per_video |
number | - | Minimum average views per video |
include_channels |
boolean | false |
Include per-channel rows |
Response:
{
"total_count": 100,
"limit": 50,
"offset": 0,
"sort": "subscribers",
"months": 1,
"results": [
{
"rank": 1,
"company_name": "Example Inc.",
"company_slug": "example",
"current_stage": "series-b",
"year_founded": 2018,
"latest_date": "2026-05-01",
"subscriber_count": 15000,
"videos_count": 120,
"views_count": 500000,
"views_per_video": 4166.67,
"subscriber_growth": 500,
"subscriber_growth_percent": 3.45,
"video_growth": 4,
"video_growth_percent": 3.45,
"view_growth": 25000,
"view_growth_percent": 5.26
}
]
}