Top Hashtags

GET /v1/latest/{level}/hashtags/{limit}/{platform}/{region}/{category_id}

Returns a list of Hashtags and associated metrics.

Parameters

Name	Type	Required	Description
level	string	yes	Categorisation level. One of cat1, cat2.
limit	string	yes	Number of rows to return. One of top5, top10k.
platform	string	yes	One of tiktok.
region	string	yes	Region code for the market you want data from. One of us, gb, fr, kr, jp, global.
category_id	UUID	yes	Identifier of the category you want hashtags for.

Examples

Top 5 hashtags on tiktok for beauty in France

Request

Terminal

curl https://api.spate.nyc/v1/latest/cat1/hashtags/top5/tiktok/fr/6d408533-6979-43aa-80af-4d88bf0be860 \
  -H "Authorization: Bearer $SPATE_API_KEY" | jq

Response

200 OK

{
  "key": "/v1/2026w24/cat1/hashtags/top5/tiktok/fr/6d408533-6979-43aa-80af-4d88bf0be860",
  "credits_used": 10,
  "data": {
    "cat1_id": "6d408533-6979-43aa-80af-4d88bf0be860",
    "dashboard": "https://app.spate.nyc/explore/tiktok/hashtags/trends/6d408533-6979-43aa-80af-4d88bf0be860?country=FR",
    "hashtags": [
      {
        "hashtag": "#makeup",
        "rank": 1,
        "average_weekly_views": 146425765,
        "total_views": 40023482864,
        "wow": 0.011672193170693568,
        "qoq": -0.09978681185123361,
        "total_posts": 2425062,
        "paid": 0.0289
      },
      ...
    ],
    "call_cost": 10,
    "data_cost": 100
  }
}