TikTok Search Top

POST1 Credit
https://api.crawlkit.sh/v1/crawl/tiktok/search-top

Search TikTok top results for a query and return the normalized public post payloads currently exposed on the top tab snapshot.

Try on Playground

Authentication

Send your Crawlkit API key as a Bearer token in the Authorization header.

Authorization: Bearer ck_your_api_key

Request Parameters

Send these JSON body fields in your request payload.

NameTypeDescription
querystringSearch query text.

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-top', {2  method: 'POST',3  headers: {4    'Authorization': 'Bearer YOUR_API_KEY',5    'Content-Type': 'application/json'6  },7  body: JSON.stringify({8  "query": "gym motivation"9})10});11 12const { data } = await response.json();13console.log(data.posts[0]?.postUrl, data.pagination.hasMore);

Response

Success (200 OK): Returns service-specific structured payload.

Success response (200 OK)
1{2  "success": true,3  "data": {4    "query": "gym motivation",5    "posts": [6      {7        "id": "749201930333",8        "postUrl": "https://www.tiktok.com/@workoutlab/video/749201930333",9        "description": "No zero days.",10        "mediaType": "video"11      }12    ],13    "pagination": {14      "cursor": null,15      "hasMore": false16    },17    "timing": {18      "total": 249319    },20    "creditsUsed": 1,21    "creditsRemaining": 9222  }23}