Skip to main content
GET
Tìm nhạc TikTok

Ủy quyền

Authorization
string
header
bắt buộc

API key của bạn, gửi ở header Authorization: Bearer <key>. Một key quản lý mọi hồ sơ trong tài khoản.

Tham số truy vấn

profile_id
string
bắt buộc

Id của hồ sơ thương hiệu cần thao tác. Lấy danh sách bằng GET /v1/profiles.

q
string
bắt buộc

Chữ trong tên bài hoặc tên nghệ sĩ, tối đa 80 ký tự. Gõ không dấu vẫn khớp, nhưng đ là một chữ riêng, không khớp với d; chữ khớp theo mẩu, không theo trọn từ.

country_code
string

Mã quốc gia hai chữ cái của bảng xếp hạng. Mặc định VN.

genre
string

Thể loại của bảng xếp hạng, ví dụ POP hoặc EASY_LISTENING. Mặc định ALL.

date_range
string

Khoảng thời gian của bảng xếp hạng: 1DAY, 7DAY, 30DAY hoặc 90DAY. Mặc định 7DAY.

limit
integer

Số bài tối đa trả về, từ 1 đến 100.

Phản hồi

Thành công.

Lớp vỏ phản hồi thì ổn định — một profile_id kèm phần nội dung — nhưng các trường bên trong chưa được ghim chặt trong tài liệu này.