TikTok Hashtags

The TikTok hashtags endpoint allows you to retrieve analytics for hashtags across TikTok videos only. Get insights into hashtag popularity, usage counts, and total view metrics specific to the TikTok platform.

GET/tiktok/hashtags

Get TikTok hashtags

Returns hashtag statistics for TikTok videos only within a specified date range (maximum 3 months). Aggregates data across TikTok videos within the 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: count or views. Default is count.
Name
sort
Type
string
Description
Sort direction: asc or desc. Default is desc.

Request

GET

/tiktok/hashtags

curl -G https://api.virlo.ai/tiktok/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": "#fyp",
      "count": 4618,
      "total_views": 7677774631
    },
    {
      "hashtag": "#foryou",
      "count": 1870,
      "total_views": 3083546272
    },
    {
      "hashtag": "#viral",
      "count": 1469,
      "total_views": 2350531914
    }
  ]
}

Error responses

The TikTok hashtags endpoint 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 - Date range exceeds 3 months - Invalid orderBy value (must be 'count' or 'views') - Invalid sort value (must be 'asc' or 'desc')
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.