Get trends (optional date range and region)
Returns trend groups within a specified date range. Defaults to the last 24 hours and the 'global' region (the worldwide feed).
Request
- Base URL: https://api.virlo.ai
- URL: https://api.virlo.ai/v1/trends
- Auth: HTTP bearer
Query parameters
Trend region to query. Defaults to 'global' — the worldwide feed, which preserves the historical behavior of this endpoint. Supported today: 'global', 'us', 'gb', 'au'; more regions will be added over time — see GET /v1/trends/regions for the current list. Unknown codes return a 400 listing the available regions.
Start date for filtering (ISO 8601). Defaults to 24 hours ago.
End date for filtering (ISO 8601). Defaults to now.
Maximum number of trend groups to return
Top N exemplar videos to include per trend ranking, ordered by views DESC. Use 0 to omit exemplars entirely.
Response
Successfully retrieved trend groups
Example response
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"title": "Trends for Mar 18",
"region": "global",
"local_date": "2026-07-06",
"trends": [
{
"ranking": 1,
"scrape_status": "success",
"exemplar_count": 141,
"top_exemplars": [
{
"video_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"url": "https://www.tiktok.com/@example/video/12345",
"platform": "tiktok",
"views": 1240000,
"thumbnail_url": "https://cdn.virlo.dev/thumbnails/abc.jpg",
"publish_date": "2026-05-14T17:11:59Z",
"author": {
"username": "jane.creator",
"avatar_url": "https://cdn.virlo.dev/avatars/abc.jpg",
"verified": true
}
}
],
"detected_at": "2026-07-06T11:12:03Z",
"last_seen_at": "2026-07-06T23:04:41Z",
"origin_region_codes": [
"gb",
"us"
],
"global_confidence": 0.92,
"velocity_today_count": 87,
"velocity_median_views": 240000,
"momentum": {
"score": 0.62,
"status": "rising",
"views_per_hour": 4200,
"updated_at": "2026-07-07T14:00:00.000Z"
},
"trend": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "AI-powered fitness coaching",
"description": "Creators are using AI tools to create personalized workout plans",
"trend_type": "content_format"
}
}
]
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.