TikTok Video Search API¶

Overview¶

Search TikTok videos by keyword. Compact response: keyword, items[] (e.g. aweme_id, description, author, video_url, cover_url, share_url, duration, engagement metrics), cursor, has_more.

Pricing¶

5 credits per request

Fixed cost per call.

Endpoint¶

URL: https://api.revidapi.com/paid/tiktok/video/search
Method: POST

Send parameters as a query string on the URL (same pattern as other POST .../paid/... endpoints).

Request¶

Headers¶

x-api-key: Required. Get your key from revidapi.com.

Query parameters¶

Parameter	Type	Required	Default	Description
`keyword`	string	Yes	—	Search keyword
`offset`	int	No	`0`	Pagination offset
`count`	int	No	`20`	Number of results per request
`sort_type`	int	No	`0`	`0` = Relatedness, `1` = Most likes
`publish_time`	int	No	`0`	`0` = Unlimited; `1` = Last day; `7` = Last week; `30` = Last month; `90` = Last three months; `180` = Last half year
`region`	string	No	`US`	Region (default `US` = America). Use TikTok region codes or ISO 3166-1 alpha-2 country codes (e.g. `VN` = Vietnam)

Examples (Vietnam market)¶

curl -X POST "https://api.revidapi.com/paid/tiktok/video/search?keyword=review%20sản%20phẩm&offset=0&count=20&sort_type=0&publish_time=0&region=VN" \
  -H "x-api-key: YOUR_API_KEY"

Most liked videos in the last 7 days (VN)¶

curl -X POST "https://api.revidapi.com/paid/tiktok/video/search?keyword=ăn%20vặt&offset=0&count=15&sort_type=1&publish_time=7&region=VN" \
  -H "x-api-key: YOUR_API_KEY"

Next page (`offset=20`)¶

curl -X POST "https://api.revidapi.com/paid/tiktok/video/search?keyword=du%20lịch%20việt%20nam&offset=20&count=20&sort_type=0&region=VN" \
  -H "x-api-key: YOUR_API_KEY"

Response¶

Success (200)¶

{
  "keyword": "review sản phẩm",
  "items": [
    {
      "aweme_id": "7123456789012345678",
      "description": "...",
      "author": "...",
      "video_url": "https://...",
      "cover_url": "https://...",
      "share_url": "https://...",
      "duration": 15
    }
  ],
  "cursor": "next_cursor_token",
  "has_more": true
}

Typical response fields¶

Field	Type	Description
`keyword`	string	Query keyword
`items`	array	Video list
`cursor`	string	Cursor for next page (if present)
`has_more`	boolean	Whether more pages exist

Pagination¶

First call: offset=0.
Next pages: increase offset by the number of items already fetched (e.g. first page 20 → second page offset=20). If the response returns cursor, you may use it as offset per upstream behaviour.

Error responses¶

Status	Description
401	Missing or invalid `x-api-key`
402	Insufficient credits
4xx/5xx	Missing `keyword`, invalid parameters, or upstream error

Usage notes¶

Vietnam: set region=VN and Vietnamese keywords for domestic-market results.
sort_type=1 + publish_time=7 works well for weekly viral picks.
Use publish_time=30 or 90 for longer trend research.
Use returned share_url / video_url with Social Download or your automation workflow.