TikTok Search Keyword
Search TikTok video results for a keyword and return normalized post payloads ready for analytics or ingestion.
Try on PlaygroundAuthentication
Send your Crawlkit API key as a Bearer token in the Authorization header.
Authorization: Bearer ck_your_api_keyRequest Parameters
Send these JSON body fields in your request payload.
| Name | Type | Description |
|---|---|---|
query | string | Search query text. |
cursor | number | Pagination cursor. |
Example Request
Use direct HTTP requests against the public API base URL.
Example request
1const response = await fetch('https://api.crawlkit.sh/v1/crawl/tiktok/search-keyword', {2 method: 'POST',3 headers: {4 'Authorization': 'Bearer YOUR_API_KEY',5 'Content-Type': 'application/json'6 },7 body: JSON.stringify({8 "query": "healthy recipes",9 "cursor": 0,10 "options": {11 "timeout": 3000012 }13})14});15 16const { data } = await response.json();17console.log(data.posts.length, data.posts[0]?.description);Response
Success (200 OK): Returns service-specific structured payload.
Success response (200 OK)
1{2 "success": true,3 "data": {4 "query": "healthy recipes",5 "posts": [6 {7 "id": "749201930120",8 "postUrl": "https://www.tiktok.com/@foodlab/video/749201930120",9 "description": "Three fast healthy dinners.",10 "mediaType": "video"11 }12 ],13 "pagination": {14 "cursor": 12,15 "hasMore": true16 },17 "timing": {18 "total": 255019 },20 "creditsUsed": 1,21 "creditsRemaining": 9322 }23}