RoomScope

อัปเดตล่าสุด

เทรนด์

แฮชแท็กและเสียงที่กำลังเป็นเทรนด์แยกตามภูมิภาค

ทุกการดำเนินการยืนยันตัวตนด้วย API key (Authorization: Bearer <key>) และข้อผิดพลาดใช้โครงสร้างร่วมที่อธิบายไว้ใน ข้อผิดพลาด. สร้างจากเอกสาร OpenAPI ของ API

GET/v1/trends

แฮชแท็กและเสียงที่กำลังเป็นเทรนด์ เรียงตามอันดับ

สโคปtrend:readเครดิตอ่านข้อมูลแคช

พารามิเตอร์ query

พารามิเตอร์ query · GET /v1/trends
NameTypeDescription
regionOptional
stringรหัสภูมิภาค
Default: US
typeOptional
"hashtag" | "sound"เฉพาะเทรนด์ประเภทเดียว

คำขอ

curl "https://api.toktokdata.live/v1/trends" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

ผลลัพธ์

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  }}

ข้อผิดพลาด

  • 400 พารามิเตอร์หรือ body ไม่ถูกต้อง code จะระบุปัญหา
  • 401 ไม่มี API key หรือไม่รู้จัก API key
  • 402 กระเป๋าเครดิตของเวิร์กสเปซมีไม่พอสำหรับการเรียกนี้ resetAt บอกเวลาที่เครดิตจะรีเซ็ต
  • 403 คีย์ไม่มีสโคปที่ต้องการ หรือแพ็กเกจไม่รวมฟีเจอร์นี้
  • 429 เกินอัตราคำขอ ให้ปฏิบัติตาม Retry-After
หน้านี้มีประโยชน์หรือไม่