InsightSocial API
TikTok

Hashtags › Popular

GET
/v1/tiktok/hashtags/popular

Returns TikTok's trending-hashtag board for one of 27 markets over 7, 30 or 90 days: each hashtag's rank, window post and view counts, daily popularity curve, industry board and top creators.

Use it for seed-free trend collection by market. One board is three hashtags; pass industry=all for the overall board plus all 15 industry boards in one call.

Metered: 120–1920 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

Re-running the exact same call within 1h is free.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

countryCode?string

Market to read the board for, as an ISO country code. One of the 27 markets TikTok publishes the board for. Defaults to US.

Value in

  • "US"
  • "FR"
  • "DE"
  • "IT"
  • "ES"
  • "GB"
  • "AR"
  • "AU"
  • "BR"
  • "CA"
  • "CO"
  • "EG"
  • "ID"
  • "IL"
  • "JP"
  • "KR"
  • "MY"
  • "MX"
  • "PH"
  • "SA"
  • "SG"
  • "ZA"
  • "TW"
  • "TH"
  • "TR"
  • "AE"
  • "VN"
period?string

Window in days: 7, 30 or 90. Defaults to 7. Each window is a different board, not a longer list.

Value in

  • "7"
  • "30"
  • "90"
industry?string

Which board to read. Omit for the overall board (3 hashtags). Pass an industry slug for that industry's board (3 hashtags), or all for the overall board plus all 15 industry boards in one call.

Value in

  • "all"
  • "education"
  • "vehicle-and-transportation"
  • "baby-kids-and-maternity"
  • "beauty-and-personal-care"
  • "tech-and-electronics"
  • "travel"
  • "household-products"
  • "pets"
  • "home-improvement"
  • "apparel-and-accessories"
  • "news-and-entertainment"
  • "games"
  • "food-and-beverage"
  • "sports-and-outdoor"
  • "health"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/tiktok/hashtags/popular"
{  "success": true,  "platform": "instagram",  "endpoint": "/v1/instagram/profile/posts",  "data": {    "items": [      "…"    ],    "dropped": 0  },  "pagination": {    "next_cursor": "is2.eyJwIjoyfQ",    "has_more": true,    "page_size": 12  },  "credits_used": 20,  "credits_remaining": 9980,  "request_id": "req_1a2b3c4d5e6f",  "cached": false,  "idempotent_replay": false,  "charge_reason": "miss",  "free_call": false}

Hashtag GET

Returns TikTok's own record for a hashtag, with its display name, its description where one exists, the live total views under the tag, and how many videos carry it. Use it to size a tag before pulling its posts. Pass the tag name and the id lookup happens for you, or pass hashtag_id when you already hold it. **20 credits** per call. Re-running the exact same call within 1h is free.

Location › Posts GET

Returns public TikTok videos tagged at a place, each with engagement counts, caption, author, and a playable URL. Use it with TikTok's own place id from a place page URL. An unknown place is a refunded not found, while a real place with nothing recent returns an empty list. **20 credits** per call. Re-running the exact same call within 6h is free. Paginates by `cursor` — see [Pagination](/docs/pagination).