Hashtags
The hashtags endpoint allows you to retrieve analytics for hashtags across videos. Get insights into hashtag popularity, usage counts, and total view metrics.
Get hashtags
Returns hashtag statistics with optional date range filtering and flexible sorting options. Aggregates data across all videos or within a specific date range.
Query parameters
- Name
start_date- Type
- string
- Required
- *
- Description
Start date for filtering (YYYY-MM-DD format). Required.
- Name
end_date- Type
- string
- Required
- *
- Description
End date for filtering (YYYY-MM-DD format, maximum 90 days from start_date). Required.
- Name
limit- Type
- number
- Description
Maximum number of results (1-100). Default is 50.
- Name
order_by- Type
- string
- Description
Field to sort by:
countorviews. Default iscount.
- Name
sort- Type
- string
- Description
Sort direction:
ascordesc. Default isdesc.
Request
curl -G https://api.virlo.ai/v1/hashtags \
-H "Authorization: Bearer {token}" \
-d start_date=2025-01-01 \
-d end_date=2025-03-31 \
-d limit=50 \
-d order_by=views \
-d sort=desc
Response
{
"data": [
{
"hashtag": "#shorts",
"count": 10926,
"total_views": 869912593
},
{
"hashtag": "fyp",
"count": 7526,
"total_views": 2373785394
},
{
"hashtag": "#funny",
"count": 3616,
"total_views": 274258005
}
]
}
Get hashtag performance
Returns aggregated performance metrics (views, likes, comments) for videos containing the specified hashtag. This endpoint provides deeper analytics for individual hashtags, including video counts and engagement averages. Optionally filter by date range (maximum 90 days).
Path parameters
- Name
hashtag- Type
- string
- Required
- *
- Description
The hashtag to analyze (without # symbol). Example:
fyportech
Query parameters
- Name
start_date- Type
- string
- Description
Start date for filtering videos (YYYY-MM-DD format). Optional.
- Name
end_date- Type
- string
- Description
End date for filtering videos (YYYY-MM-DD format). Optional. If both dates provided, maximum 90 days range.
Request
curl -G https://api.virlo.ai/v1/hashtags/fyp/performance \
-H "Authorization: Bearer {token}" \
-d start_date=2024-01-01 \
-d end_date=2024-03-31
Response
{
"data": {
"hashtag": "fyp",
"video_count": 206,
"total_views": 1136934142,
"avg_views": 5519097.78,
"total_likes": 96546584,
"avg_likes": 468672.74,
"total_comments": 866458,
"avg_comments": 4206.11
}
}
Error responses
The hashtags endpoints may return the following error codes:
- Name
400 Bad Request- Description
Invalid parameters provided. Common causes include: - Invalid date format (must be YYYY-MM-DD) - Both start_date and end_date are required for /v1/hashtags endpoint - Date range exceeds 90 days - Invalid order_by value (must be 'count' or 'views') - Invalid sort value (must be 'asc' or 'desc') - Empty hashtag parameter
- Name
401 Unauthorized- Description
Missing or invalid API key. Ensure you're including your API key in the Authorization header.
- Name
404 Not Found- Description
(Performance endpoint only) No videos found with the specified hashtag in the database or date range.
- Name
429 Too Many Requests- Description
Rate limit exceeded. Your plan has specific rate limits per endpoint. Wait before making additional requests.