TikTok Search Hashtag API

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

Example request

curl "https://api.insightsocial.app/v1/tiktok/search/hashtag?hashtag=fyp" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"

Returns TikTok videos posted under a given hashtag, each with caption, view, like, comment and share counts, author details, and a thumbnail.

Use it to track one tag such as a campaign or challenge; use search when you want a free text keyword rather than a tag.

10 credits per call.

Paginates by cursor: see Pagination.

Authorization

apiKey

x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

hashtag*string

Hashtag to search for without the # symbol

region?string

Two-letter country code that localises the results. It does not filter by country: use post.ext.region.

cursor?integer

Cursor to get more videos. Get 'cursor' from previous response.

trim?boolean

Accepted for compatibility; the response is already the canonical shape, so this flag has no effect.

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

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.

min_views?integer

Keep only rows with at least this many views (post.engagement.views). A row whose view count is unknown is discarded, so every returned row meets the floor.

Range0 <= value

max_age_days?integer

Keep only rows published within this many days (post.published_at), 1 to 3650. A row with no date is discarded.

Range1 <= value <= 3650

sort_rows?"views"

views: return the kept rows ordered by view count, highest first, across every page walked. Rows without a view count go last.

Value in

"views"

max_pages?integer

1 to 5 (default 1). Walk up to this many pages in one call and return the rows from all of them (after any filter). Each page walked is billed as one call to this endpoint; the whole walk counts once against your rate limit.

Range1 <= value <= 5

Response Body

`application/json`

curl -X GET "https://api.insightsocial.app/v1/tiktok/search/hashtag?hashtag=string"

{  "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    }  }}

TikTok Search Hashtag API reference

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

402application/json

404application/json

409application/json

429application/json

500application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`