API referenceTikTok
TikTok search suggestions
Autocomplete terms TikTok offers for a partial query.
Read from TikTok directly (the data source has no suggestion surface), so it spends no credit.
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-search-suggestions-v4" \ -H "Content-Type: application/json" \ -d '{ "query": "coff" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "query": "coff", "region": null, "suggestions": [ { "group_id": "4928213053111302118", "language": "en", "position": 0, "score": 0.025821721, "text": "coffee" }, { "group_id": "6689047709170559128", "language": "en", "position": 1, "score": 0.00042322397, "text": "coffee camp porterville" }, "… 8 more items in the full response" ] }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "tiktok-search-suggestions-v4", "billable": true, "duration_ms": 1700 }}