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
startDate- Type
- string
- Description
Start date for filtering (YYYY-MM-DD format). Required.
- Name
endDate- Type
- string
- Description
End date for filtering (YYYY-MM-DD format, maximum 3 months from startDate). Required.
- Name
limit- Type
- number
- Description
Maximum number of results (1-200). Default is 50.
- Name
orderBy- 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/hashtags \
-H "Authorization: Bearer {token}" \
-d startDate=2025-01-01 \
-d endDate=2025-03-31 \
-d limit=50 \
-d orderBy=views \
-d sort=desc
Response
{
"results": 3,
"data": [
{
"hashtag": "#okcthunder",
"count": 4733,
"total_views": 7866007203
},
{
"hashtag": "#northwest",
"count": 2310,
"total_views": 5304909974
},
{
"hashtag": "#strangerthings5",
"count": 1905,
"total_views": 3123449691
}
]
}
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 3 months).
Path parameters
- Name
hashtag- Type
- string
- Description
The hashtag to analyze (without # symbol). Example:
fyportech
Query parameters
- Name
startDate- Type
- string
- Description
Start date for filtering videos (YYYY-MM-DD format). Optional.
- Name
endDate- Type
- string
- Description
End date for filtering videos (YYYY-MM-DD format). Optional. If both dates provided, maximum 3 months range.
Request
curl -G https://api.virlo.ai/hashtags/fyp/performance \
-H "Authorization: Bearer {token}" \
-d startDate=2024-01-01 \
-d endDate=2024-03-31
Response
{
"hashtag": "fyp",
"videoCount": 206,
"totalViews": 1136934142,
"avgViews": 5519097.78,
"totalLikes": 96546584,
"avgLikes": 468672.74,
"totalComments": 866458,
"avgComments": 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 startDate and endDate are required for /hashtags endpoint - Date range exceeds 3 months - Invalid orderBy 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.