List TikTok hashtag videos | TikTok API

Returns public videos for a hashtag, given the challenge_id from /v1/tiktok/hashtag →. Page with cursor and count.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

challenge_id*string

TikTok's own numeric id for the hashtag, from /tiktok/hashtag. A tag name is not accepted here — see the endpoint description.

cursor?|

Where to resume. 0 for the first page, then the next_cursor a previous response returned, verbatim. It is TikTok's own token, not a page number.

Range0 <= value

Default0

count?integer

How many videos to ask for. A ceiling, not a promise — 29-30 items came back for count=30 on every page measured.

Range1 <= value <= 50

Default30

curl -X GET "https://example.com/v1/tiktok/hashtag_videos?challenge_id=229207" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "entries": [      {        "id": "7497430262331182382",        "desc": "string",        "create_time": 0,        "author": {          "id": "string",          "unique_id": "tiktok",          "nickname": "string",          "sec_uid": "string",          "verified": true        },        "stats": {          "play_count": 578100,          "digg_count": 98800,          "comment_count": 0,          "share_count": 0        },        "stats_v2": {          "property1": null,          "property2": null        },        "hashtags": [          "string"        ],        "video": {          "cover": "string",          "duration": 0,          "ratio": "540p"        }      }    ],    "count": 0,    "next_cursor": "string",    "has_more": true  }}