RoomScope

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.

GET/v1/trends

Hashtag và âm thanh thịnh hành, theo thứ hạng.

Scopetrend:readCreditĐọc dữ liệu cache

Tham số query

Tham số query · GET /v1/trends
NameTypeDescription
regionOptional
stringMã 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

  • 400 Tham số hoặc body không hợp lệ; code cho biết vấn đề.
  • 401 API key bị thiếu hoặc không xác định.
  • 402 Ví credit của workspace không đủ cho lệnh gọi; resetAt cho biết khi nào credit được reset.
  • 403 Key thiếu scope, hoặc gói không bao gồm tính năng này.
  • 429 Vượt tốc độ request (theo giây, theo phút hoặc theo ngày); hãy tuân theo Retry-After.
Trang này có hữu ích không?