API referenceTikTok
TikTok hashtag search
Keyword search over hashtags, with each hashtag's post and view totals.
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 }}