Primary Data Source
All YouTube data on Top1Trend is sourced from the YouTube Data API v3, which is Google's official programmatic interface for accessing YouTube data. This ensures that our analytics are accurate and reflect the true state of YouTube's trending system.
Videos.list Endpoint
Used to retrieve video metadata including title, description, channel info, category, duration, and publish date.
Videos.list (chart=mostPopular)
Used to fetch the trending videos list for each region. Returns the top 50 trending videos per region.
Channels.list Endpoint
Used to retrieve channel information including subscriber count, total views, and channel description.
VideoCategories.list Endpoint
Used to map category IDs to human-readable category names (Music, Gaming, Entertainment, etc.).
Regional Coverage
YouTube's trending system is region-specific. Each country has its own trending list that reflects local viewer preferences. We track the following regions:
US
United States
VN
Vietnam
JP
Japan
KR
South Korea
GB
United Kingdom
DE
Germany
FR
France
BR
Brazil
IN
India
ID
Indonesia
Note: YouTube's trending algorithm varies by region and considers factors beyond just view count, including watch time, rate of growth, and diversity of viewership.
Data Freshness
| Data Type | Update Frequency | Typical Delay |
|---|---|---|
| Trending Rankings | Every 6 hours | < 30 minutes |
| View Counts | Every 6 hours | 1-2 hours (YouTube delay) |
| Like Counts | Every 6 hours | 1-2 hours (YouTube delay) |
| Comment Counts | Every 6 hours | 1-2 hours (YouTube delay) |
| Channel Info | Daily | Up to 24 hours |
| All-Time Rankings | Daily | Calculated at 01:00 UTC |
Note on YouTube's Data Delay: YouTube's API provides data with a built-in delay, typically 1-2 hours for public metrics. This is a YouTube limitation, not a Top1Trend limitation. Real-time view counts are not available via the public API.
Data Storage & Privacy
What We Store
- Video metadata (title, description, duration, category)
- Channel information (name, subscriber count)
- Public metrics (views, likes, comments)
- Trending history (rank, date, region)
- Calculated scores and analytics
What We Don't Store
- Video content itself (we link to YouTube)
- User personal information from YouTube
- Private or unlisted video data
- YouTube user cookies or tracking data
Infrastructure
Our data is stored in a PostgreSQL database hosted on Supabase's secure infrastructure. All connections are encrypted with TLS, and we follow industry-standard security practices.
Top1Trend operates in full compliance with YouTube's API Services Terms of Service. We:
- Respect YouTube's rate limits and quotas
- Only access publicly available data through official endpoints
- Clearly attribute YouTube as the data source
- Do not attempt to circumvent access controls
- Maintain an up-to-date privacy policy as required
For more information, see the YouTube API Services Terms of Service.