Cập nhật lần cuối
Xu hướng
Hashtag và âm thanh thịnh hành theo khu vực.
Mọi thao tác đều xác thực bằng API key (Authorization: Bearer <key>) và lỗi dùng chung envelope được mô tả trong Lỗi. Được tạo từ tài liệu OpenAPI của API.
Liệt kê xu hướng của một khu vực
GET
/v1/trendsHashtag và âm thanh thịnh hành, theo thứ hạng.
Scopetrend:readCreditĐọc dữ liệu cache
Tham số query
| Name | Type | Description |
|---|---|---|
regionOptional | string | Mã khu vực. Default: US |
typeOptional | "hashtag" | "sound" | Chỉ một loại xu hướng. |
Request
curl "https://api.next.toktokdata.live/v1/trends" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"Response
200 OK
{ "data": { "region": "VN", "trends": [ { "trendType": "hashtag", "trendId": "1690000000000000001", "title": "#livestream", "rank": 1, "videoCount": 18400, "viewCount": 92000000 }, { "trendType": "sound", "trendId": "7300000000000000002", "title": "Original sound - linh.live", "rank": 2, "videoCount": 5100, "viewCount": 31000000 } ] }, "provenance": { "observedAt": "2026-11-01T10:36:44.935Z", "freshness": "near_realtime", "source": "public_trends_discover", "sourceKind": "derived", "coverageStatus": "observed", "methodologyVersion": "trends-v1", "window": null }}Lỗi
400Tham số hoặc body không hợp lệ;codecho biết vấn đề.401API key bị thiếu hoặc không xác định.402Ví credit của workspace không đủ cho lệnh gọi;resetAtcho biết khi nào credit được reset.403Key thiếu scope, hoặc gói không bao gồm tính năng này.429Vượt tốc độ request (theo giây, theo phút hoặc theo ngày); hãy tuân theoRetry-After.
Trang này có hữu ích không?