API BXH nhạc trending TikTok (Music Trend)¶

Tổng quan¶

API trả về bảng xếp hạng nhạc trending (kiểu TikTok Ads). Response thường gồm pagination, sound_list, cached.

Giá cả¶

5 credits cho mỗi yêu cầu

Chi phí cố định mỗi lần gọi, không phụ thuộc limit (trong phạm vi cho phép của API).

Endpoint¶

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

Tham số gửi kèm query string trên URL (cùng kiểu với các endpoint POST .../paid/... khác trong tài liệu RevidAPI).

Yêu cầu¶

Headers¶

x-api-key: Bắt buộc. Lấy key tại revidapi.com.

Query parameters¶

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
`period`	int	Không	—	Khoảng thời gian tính theo ngày, vd. `7`, `30`, `120`
`page`	int	Không	`1`	Số trang
`limit`	int	Không	`20`	Số mục mỗi trang
`rank_type`	string	Không	—	Loại xếp hạng: `popular` = Phổ biến, `surging` = Tăng nhanh nhất
`new_on_board`	boolean	Không	`false`	Chỉ hiển thị nhạc trending mới lên bảng
`commercial_music`	boolean	Không	`false`	Chỉ hiển thị nhạc thương mại
`country_code`	string	Không	—	Mã quốc gia; Việt Nam: `VN` (vd. thêm `US`, `JP` khi cần so sánh thị trường)

Ví dụ (thị trường Việt Nam)¶

BXH phổ biến 30 ngày tại Việt Nam¶

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"

Nhạc đang “tăng nhanh” 7 ngày gần đây tại Việt Nam¶

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"

Phản hồi¶

Thành công (200)¶

Dạng response (minh họa — trường có thể khác tùy upstream):

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

Các trường response (điển hình)¶

Trường	Kiểu	Mô tả
`pagination`	object	Metadata phân trang
`sound_list`	array	Danh sách sound trending
`cached`	boolean	Có phục vụ từ cache hay không

Phản hồi lỗi¶

Status	Mô tả
401	Thiếu hoặc sai `x-api-key`
402	Không đủ credits
4xx/5xx	Tham số không hợp lệ hoặc lỗi upstream; xem body / `detail` nếu có

Ghi chú sử dụng¶

Việt Nam: đặt country_code=VN để lấy chart đúng thị trường trong nước (trend TikTok / Ads theo vùng).
rank_type: popular cho bài đang hot ổn định; surging cho bài đang bùng nổ trong period ngày gần nhất.
period=7 hoặc 30 thường dùng cho báo cáo tuần / tháng; 120 khi cần góc nhìn dài hơn.
Bật commercial_music=true khi chỉ cần kho nhạc dùng cho quảng cáo / brand-safe.
Giới hạn tần suất gọi; lỗi lặp lại nên có backoff.