TikTok Music Search API¶

Overview¶

Search TikTok music / sounds by keyword. Response: keyword, items[] (music_id, title, author, music_url, cover_url, link, duration in seconds), cursor, has_more.

Pricing¶

5 credits per request

Fixed cost per call.

Endpoint¶

URL: https://api.revidapi.com/paid/tiktok/music/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`	string	No	`0`	Starts at `0`; for page 2+, use the `cursor` from the previous response as `offset`
`count`	int	No	`20`	Number of results; do not exceed 20
`filter_by`	int	No	`0`	`0` = All, `1` = Title, `2` = Author
`sort_type`	int	No	`0`	`0` = Relatedness; `1` = Most used; `2` = Latest; `3` = Shortest duration; `4` = Longest duration
`region`	string	No	`US`	Region (default `US` = America). TikTok region codes or ISO 3166-1 alpha-2 (e.g. `VN` = Vietnam)

Examples (Vietnam market)¶

curl -X POST "https://api.revidapi.com/paid/tiktok/music/search?keyword=nhạc%20nền%20tiktok&offset=0&count=20&filter_by=0&sort_type=0&region=VN" \
  -H "x-api-key: YOUR_API_KEY"

Filter by title, sort by most used¶

curl -X POST "https://api.revidapi.com/paid/tiktok/music/search?keyword=remix%20việt&offset=0&count=15&filter_by=1&sort_type=1&region=VN" \
  -H "x-api-key: YOUR_API_KEY"

Next page (use previous `cursor` as `offset`)¶

curl -X POST "https://api.revidapi.com/paid/tiktok/music/search?keyword=lofi&offset=CURSOR_FROM_PREVIOUS_RESPONSE&count=20&sort_type=2&region=VN" \
  -H "x-api-key: YOUR_API_KEY"

Replace CURSOR_FROM_PREVIOUS_RESPONSE with the actual cursor value from the prior JSON response.

Response¶

Success (200)¶

{
  "keyword": "nhạc nền tiktok",
  "items": [
    {
      "music_id": "7629279488405506065",
      "title": "Sound title",
      "author": "creator",
      "music_url": "https://...",
      "cover_url": "https://...",
      "link": "https://...",
      "duration": 30
    }
  ],
  "cursor": "next_cursor_token",
  "has_more": true
}

Typical response fields¶

Field	Type	Description
`keyword`	string	Query keyword
`items`	array	Sound list
`cursor`	string	Use as `offset` for the next request
`has_more`	boolean	Whether more pages exist

Pagination¶

First call: offset=0.
Next pages: copy cursor from the response → set query offset → call again with the same keyword and filters.

Error responses¶

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

Usage notes¶

count max is 20 — do not send a higher value.
Use region=VN for Vietnam-focused content and ads.
After you have music_id, call TikTok Music Download (/paid/tiktok/music/download) for full stream URLs.
Combine with Music Trend to compare charting sounds vs search results.