InsightSocial API
TikTok

TikTok Hashtags Popular API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/tiktok/hashtags/popular" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
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: 60–960 credits. We reserve the ceiling when the call starts and charge what it actually used when it finishes.

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"
since?string

Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off each page. This list is not in date order, so the walk does not stop at the date: keep following next_cursor, and each page costs what a page costs even when every row on it is filtered out. A row with no date is kept.

until?string

Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept.

dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/tiktok/hashtags/popular"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "items": [      {        "post": {          "id": "string",          "url": "http://example.com",          "kind": "string",          "content": {            "text": "string",            "media_urls": [              "http://example.com"            ],            "thumbnail_url": "http://example.com",            "duration_seconds": 0          },          "author": {            "id": "string",            "username": "string",            "display_name": "string",            "avatar_url": "http://example.com",            "verified": true          },          "engagement": {            "views": 0,            "likes": 0,            "comments": 0,            "shares": 0,            "saves": 0          },          "flags": {            "nsfw": true,            "spoiler": true,            "pinned": true,            "deleted": true,            "likes_hidden": true,            "comments_hidden": true,            "shares_hidden": true,            "views_hidden": true,            "saves_hidden": true          },          "published_at": "2019-08-24T14:15:22Z",          "language": "string",          "ext": {            "property1": null,            "property2": null          }        }      }    ],    "total": 0,    "truncated": true,    "ext": {      "property1": null,      "property2": null    }  }}

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.

Location › Posts GET

Returns public TikTok videos tagged at a place, each with engagement counts, caption, author, and a playable URL.