API referenceTikTok
TikTok hashtag search
Keyword search over hashtags, with each hashtag's post and view totals.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 1.5s.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/tiktok-hashtag-search-v4" \ -H "Content-Type: application/json" \ -d '{ "keywords": "travel", "cursor": "0", "count": 30 }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "cursor": "30", "has_more": true, "hashtags": [ { "cover_url": "https://p16-amd-va.tiktokcdn.com/obj/musically-maliva-obj/6cd3395377af1ebf701faaf40d449c8c", "description": "🌟The world is a book and those who don't travel read only one page 🏄🌴Now recollect your best travel memories from your camera roll, 📷and share the stories behind!", "hashtag_id": "7884", "hashtag_link": "https://www.tiktok.com/tag/Travel", "is_challenge": false, "is_commerce": false, "is_pgc_show": false, "is_strong_music": false, "name": "Travel", "post_count": 91762544, "type": 2, "view_count": 754967830291 }, { "cover_url": "https://p16-amd-va.tiktokcdn.com/obj/tiktok-obj/1be619956a5dc1f939d89a5f7468c94f.jpeg", "description": "Uncovering the world’s hidden gems. 🔍✈️", "hashtag_id": "1598183468378114", "hashtag_link": "https://www.tiktok.com/tag/TravelTikTok", "is_challenge": false, "is_commerce": false, "is_pgc_show": false, "is_strong_music": false, "name": "TravelTikTok", "post_count": 17666112, "type": 2, "view_count": 186530401319 }, "… 28 more items in the full response" ], "keywords": "travel" }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "tiktok-hashtag-search-v4", "billable": true, "duration_ms": 934 }}