POST
/
v1
/
tiktok
/
search
curl -X POST https://api.zocialmine.com/v1/tiktok/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "cooking recipes",
    "cursor": "0"
  }'

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "7513452345255103751",
        "desc": "Easy cooking recipes for beginners #cooking #recipes",
        "createTime": 1700000000,
        "author": {
          "id": "6943345678901234567",
          "uniqueId": "chefname",
          "nickname": "Chef Name"
        },
        "stats": {
          "diggCount": 150000,
          "playCount": 2500000,
          "commentCount": 3200,
          "shareCount": 5000
        }
      }
    ],
    "hasMore": true,
    "cursor": "10"
  }
}
Search for TikTok videos by keyword. Returns a paginated list of videos matching the search query with cursor-based pagination. Cost: 1 credit per request.

​
Request

​
keyword
string
required
The search keyword or phrase.Example: "cooking recipes"
​
cursor
string
default:"0"
Pagination cursor. Use "0" for the first page, then pass the returned cursor value for subsequent pages.
​
webhook
string
A URL to receive the response via webhook. If provided, the request will be processed asynchronously and the result will be sent to this URL.

​
Response

​
status
string
"success" on successful request.
​
data
object
curl -X POST https://api.zocialmine.com/v1/tiktok/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "cooking recipes",
    "cursor": "0"
  }'

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "7513452345255103751",
        "desc": "Easy cooking recipes for beginners #cooking #recipes",
        "createTime": 1700000000,
        "author": {
          "id": "6943345678901234567",
          "uniqueId": "chefname",
          "nickname": "Chef Name"
        },
        "stats": {
          "diggCount": 150000,
          "playCount": 2500000,
          "commentCount": 3200,
          "shareCount": 5000
        }
      }
    ],
    "hasMore": true,
    "cursor": "10"
  }
}