List hashtag videos (v3)
List videos posted with a hashtag, with captions, counts, authors and sounds. Needs the numeric hashtag_id from /v3/tiktok/hashtag/info →. Paginate with cursor and has_more. An unknown hashtag returns data: null.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
hashtag_id*string
Numeric hashtag ID, from the id field of /v3/tiktok/hashtag/info.
Match
^\d{1,25}$count?integer
Videos to request per page, 1 to 50. Hashtag pages hold at most about 20 videos.
Range
1 <= value <= 50Default
20cursor?string
cursor from the previous response. Omit for the first page and send it unchanged for later pages.
Match
^\d{1,20}$curl -X GET "https://example.com/v3/tiktok/hashtag/videos?hashtag_id=3301" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "items": [ { "id": "7696256568160963854", "url": "https://www.tiktok.com/@astro_alexandra/video/7696256568160963854", "description": "The soil and dust on the planet Mars is TOXIC to humans and plants #space #Astronomy #Science #nasa #learnbiologyontiktok ", "created_at": "2026-10-13T20:46:20.000Z", "author": { "id": "6807464177264886790", "sec_uid": "MS4wLjABAAAALpVBeL5TFs1TejgbuexrI-ajfZb5oILOA0md6cS7VI64PCb43Qzx-xVYY2j8Fdj1", "username": "astro_alexandra", "nickname": "ASTRO ALEXANDRA 🪐", "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e454a1e11f0d6eaa62e1da3469473974~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&refresh_token=95373fdd&x-expires=1792249200&x-signature=LZdLW1MS2b0UOeLaxquYEPcO67U%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=c0f880ed&idc=useast5&sc=avatar&s=CHALLENGE_AWEME", "verified": false }, "stats": { "plays": 1211085, "likes": 181272, "comments": 6231, "shares": 5195, "saves": 11352 }, "video": { "duration": 68.867, "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/osMi5ASDqCmeBKSFEAApnAEEED9OfzugtRIJDb~tplv-tiktokx-dmt-logom:tos-useast5-i-0068-tx/oIgAWEpMqDApmeakADCBDQEzFAiESIfRJEIQOo.image?dr=8594&refresh_token=8290a64f&x-expires=1792249200&x-signature=M93oZR1KQDZfGaLnVlNI7hvLfdw%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=c0f880ed&idc=useast5&s=CHALLENGE_AWEME&sc=cover&biz_tag=tt_video", "width": 720, "height": 1280 }, "music": { "id": "7696256579796060942", "title": "original sound - astro_alexandra", "author": "ASTRO ALEXANDRA 🪐" }, "hashtags": [ "space", "astronomy", "science", "nasa", "learnbiologyontiktok" ] }, { "id": "7695495231692672270", "url": "https://www.tiktok.com/@astro_alexandra/video/7695495231692672270", "description": "JAXA’s Martian Moon eXploration (MMX) mission is launching THIS MONTH?! #space #Astronomy #Science #nasa #LearnonTikTokContest ", "created_at": "2026-10-11T19:32:15.000Z", "author": { "id": "6807464177264886790", "sec_uid": "MS4wLjABAAAALpVBeL5TFs1TejgbuexrI-ajfZb5oILOA0md6cS7VI64PCb43Qzx-xVYY2j8Fdj1", "username": "astro_alexandra", "nickname": "ASTRO ALEXANDRA 🪐", "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e454a1e11f0d6eaa62e1da3469473974~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&refresh_token=95373fdd&x-expires=1792249200&x-signature=LZdLW1MS2b0UOeLaxquYEPcO67U%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=c0f880ed&idc=useast5&sc=avatar&s=CHALLENGE_AWEME", "verified": false }, "stats": { "plays": 181554, "likes": 35219, "comments": 547, "shares": 652, "saves": 1564 }, "video": { "duration": 78.967, "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oMAeAeQ2GHGVLAdI7XIy8pIHlEkQ8eBAcojphA~tplv-tiktokx-dmt-logom:tos-useast5-i-0068-tx/oQALeKAlfAE08QDYABjV4DEx5iHkiIApneAIsz.image?dr=8594&refresh_token=c9106ddd&x-expires=1792249200&x-signature=nARFHU5NieCk8irsq6J474kRqzk%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=c0f880ed&idc=useast5&sc=cover&biz_tag=tt_video&s=CHALLENGE_AWEME", "width": 720, "height": 1280 }, "music": { "id": "7695495322235177741", "title": "original sound - astro_alexandra", "author": "ASTRO ALEXANDRA 🪐" }, "hashtags": [ "space", "astronomy", "science", "nasa", "learnontiktokcontest" ] } ], "count": 2, "cursor": "20", "has_more": true }}