TikTok Video Search

1 credit

Search for TikTok videos by keyword.

POST/api/v1/tools/tiktok/video/search

Parameters

querystringrequired

Search query.

maxResultsnumber

Maximum results. Defaults to 100.

fieldsstring[]

Fields per result. Available: id, desc, createTime, author, stats. Use ["*"] for all.

Response Schema

dataobject

TikTok video search result

resultsobject[]

Array of video search results.

countnumber

Number of results returned

metaobject

Request metadata

toolstring

Tool name (tiktok-video-search)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/tiktok/video/search \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "cooking recipes",
    "maxResults": 20
  }'

Response Example

{
  "data": {
    "results": [
      {
        "id": "7340002000000000001",
        "desc": "Easy 15-minute pasta recipe #cooking #recipes #foodtok",
        "createTime": 1713859200,
        "author": {
          "uniqueId": "quickmeals",
          "nickname": "Quick Meals"
        },
        "stats": {
          "diggCount": 98000,
          "shareCount": 4500,
          "commentCount": 2100,
          "playCount": 1800000
        }
      },
      {
        "id": "7340002000000000002",
        "desc": "The best homemade pizza dough recipe #pizza #cooking",
        "createTime": 1713772800,
        "author": {
          "uniqueId": "pizzamaster",
          "nickname": "Pizza Master"
        },
        "stats": {
          "diggCount": 156000,
          "shareCount": 8900,
          "commentCount": 3400,
          "playCount": 3200000
        }
      }
    ],
    "count": 2
  },
  "meta": {
    "tool": "tiktok-video-search",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}