Trends
The trends endpoint provides access to trending topics organized into groups. Each group contains ranked trends with detailed information about trending content.
Get trends
Returns trend groups within a specified date range. Each group contains ranked trends that were active at that time. Defaults to the last 24 hours to capture the most recent trends (typically generated at 1am UTC daily).
Query parameters
- Name
startDate- Type
- string
- Description
Start date for filtering (ISO 8601 format like
2025-10-14T00:00:00.000Zor simplified2025-10-14). Defaults to 24 hours ago.
- Name
endDate- Type
- string
- Description
End date for filtering (ISO 8601 format like
2025-10-16T23:59:59.999Zor simplified2025-10-16). Defaults to now.
- Name
limit- Type
- number
- Description
Maximum number of trend groups to return (1-10). Default is 5.
Request
curl -G https://api.virlo.ai/trends \
-H "Authorization: Bearer {token}" \
-d startDate=2025-10-14 \
-d endDate=2025-10-16 \
-d limit=5
Response
{
"results": 1,
"data": [
{
"id": "b88c0c23-8501-4975-a1e9-b7c1160c6342",
"title": "Trends for Oct 15th",
"trends": [
{
"id": "132ea402-804d-4515-b706-f3ff9c698c5e",
"trend_id": "8ab75d1a-cb50-4885-b9b3-2e4ede2a3620",
"trend_group_id": "b88c0c23-8501-4975-a1e9-b7c1160c6342",
"ranking": 1,
"trend": {
"id": "8ab75d1a-cb50-4885-b9b3-2e4ede2a3620",
"name": "NBA Season Opening Night",
"description": "The 2025-26 NBA season officially tipped off with opening night games, marking LeBron James' first season opener absence since 2002 due to injury. Fans are celebrating the return of basketball with highlights, predictions, and reactions to the new season.",
"trend_type": "content"
}
},
{
"id": "e4b183c8-a704-4add-bd14-43f11a27b92d",
"trend_id": "63f0c8a1-f0f3-42ff-92bf-c2be4c61dc90",
"trend_group_id": "b88c0c23-8501-4975-a1e9-b7c1160c6342",
"ranking": 2,
"trend": {
"id": "63f0c8a1-f0f3-42ff-92bf-c2be4c61dc90",
"name": "Inside the NBA Returns to ESPN After 23 Years",
"description": "The iconic Inside the NBA crew is officially back on ESPN for the first time in 23 years, and basketball fans are celebrating. The beloved show with its legendary chemistry and hilarious moments is returning to a new network, marking a historic shift in NBA broadcasting that has everyone nostalgic.",
"trend_type": "content"
}
}
]
}
]
}
Get trends digest
Returns today's trend groups based on current date in EST/EDT timezone. This endpoint ensures that at 9pm EST (1am UTC next day), we still show today's EST trends.
Request
curl https://api.virlo.ai/trends/digest \
-H "Authorization: Bearer {token}"
Response
{
"results": 1,
"data": [
{
"id": "def-456",
"title": "Trends for Oct 22nd",
"trends": [
{
"id": "trend-2",
"trend_id": "t-456",
"trend_group_id": "def-456",
"ranking": 1,
"trend": {
"id": "t-456",
"name": "Winter Fashion Hauls",
"description": "Creators showcasing affordable winter wardrobe essentials and styling tips",
"trend_type": "fashion"
}
},
{
"id": "trend-3",
"trend_id": "t-789",
"trend_group_id": "def-456",
"ranking": 2,
"trend": {
"id": "t-789",
"name": "Holiday Baking Tutorials",
"description": "Step-by-step guides for festive cookies and desserts",
"trend_type": "cooking"
}
}
]
}
]
}
Error responses
The trends endpoints may return the following error codes:
- Name
400 Bad Request- Description
Invalid parameters provided. Common causes include: - Invalid date format (must be ISO 8601 format for
/trends) - Invalid limit value (must be 1-10)
- Name
401 Unauthorized- Description
Missing or invalid API key. Ensure you're including your API key in the Authorization header.
- Name
429 Too Many Requests- Description
Rate limit exceeded. Your plan has specific rate limits per endpoint. Wait before making additional requests.