TikTok Music Trend API¶

Overview¶

This endpoint returns a trending music chart (TikTok Ads style). The response typically includes pagination, sound_list, and cached.

Pricing¶

5 credits per request

Fixed cost per call, regardless of limit (within allowed API range).

Endpoint¶

URL: https://api.revidapi.com/paid/music/trend
Method: POST

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

Request¶

Headers¶

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

Query parameters¶

Parameter	Type	Required	Default	Description
`period`	int	No	—	Time period in days, e.g. `7`, `30`, `120`
`page`	int	No	`1`	Page number
`limit`	int	No	`20`	Items per page
`rank_type`	string	No	—	`popular` = Popular, `surging` = Fastest rising
`new_on_board`	boolean	No	`false`	Only show newly trending music
`commercial_music`	boolean	No	`false`	Only show commercial music
`country_code`	string	No	—	Country code; Vietnam: `VN` (e.g. `US`, `JP` for other markets)

Examples (Vietnam market)¶

Popular chart — last 30 days in Vietnam¶

curl -X POST "https://api.revidapi.com/paid/music/trend?period=30&page=1&limit=20&rank_type=popular&country_code=VN" \
  -H "x-api-key: YOUR_API_KEY"

Surging tracks — last 7 days in Vietnam¶

curl -X POST "https://api.revidapi.com/paid/music/trend?period=7&page=1&limit=15&rank_type=surging&country_code=VN" \
  -H "x-api-key: YOUR_API_KEY"

curl -X POST "https://api.revidapi.com/paid/music/trend?period=30&page=2&limit=10&rank_type=popular&new_on_board=true&commercial_music=false&country_code=VN" \
  -H "x-api-key: YOUR_API_KEY"

Response¶

Success (200)¶

Illustrative shape (fields may vary by upstream):

{
  "pagination": {},
  "sound_list": [],
  "cached": false
}

Response fields (typical)¶

Field	Type	Description
`pagination`	object	Pagination metadata
`sound_list`	array	List of trending sound items
`cached`	boolean	Whether the response was served from cache

Error responses¶

Status	Description
401	Missing or invalid `x-api-key`
402	Insufficient credits
4xx/5xx	Invalid parameters or upstream error; check response body / `detail` if present

Usage notes¶

Vietnam: set country_code=VN for the domestic market chart (TikTok / Ads region).
rank_type: use popular for stable hot tracks; surging for fastest growth inside the chosen period.
period=7 or 30 is typical for weekly / monthly reporting; 120 for a longer window.
Set commercial_music=true when you only need the commercial / brand-safe catalogue.
Respect rate limits; use backoff on repeated errors.