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 này vẫn nằm trên đường cũ

Các endpoint khác đã chuyển sang https://revidapi.com/v1/.... Riêng BXH nhạc thịnh hành hiện mới chỉ có trên đường cũ https://api.revidapi.com/paid/music/trend. Cứ dùng đúng như ví dụ dưới đây; khi có bản /v1, trang này sẽ được cập nhật.

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.