Search TikTok videos

Search TikTok videos by keyword.

← All TikTok endpoints · Capability overview

GET/v1/tiktok/search/videos

https://api.vee3.io/v1/tiktok/search/videos

5 tokens

Search TikTok videos by keyword.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

search_tiktok_videos

Parameters6 fields

querystringRequired

Search keywords.

max length 512

regionstringOptional

Region code (for example us, jp, kr).

max length 8

countintegerRequired

Number of items to return (max 30).

Default: 10 · min 1, max 30

cursorstringOptional

Pagination cursor from a previous response.

max length 4096

publish_timeintegerOptional

Publish time filter: 0, 1, 7, 30, 90, or 180.

sort_bystringRequired

Sort order: relevance, like_count, or date_posted.

Default: "relevance"

Response7 fields

codeinteger

Upstream status code (0 = success).

msgstring

Upstream status message.

processed_timenumber

Upstream processing time in seconds.

dataobject

3 fields

Capability-specific payload from the upstream provider.

cursorstring

Pagination cursor when returned by the provider.

hasMoreboolean

Whether additional pages are available.

totalinteger

Total result count when provided by the upstream provider.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, tiktok_not_configured, tiktok_upstream_error, tiktok_download_empty

Example request

Python

import requests

url = "https://api.vee3.io/v1/tiktok/search/videos"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "query": "cooking",
    "region": "us",
    "sort_by": "like_count"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Matching videos with pagination cursor.

video_search_results.json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.847,
  "data": {
    "videos": [
      {
        "id": "7516594811734854943",
        "title": "make your money count",
        "author": {
          "id": "107955",
          "uniqueId": "tiktok",
          "nickname": "TikTok"
        },
        "play_count": 1240000,
        "digg_count": 98000
      }
    ],
    "cursor": "1781282535",
    "hasMore": true
  }
}