toolzerhub API Docs

Get video trends

Returns a video's metric series. Douyin serves this only for videos currently on a board and inside its viewable window; anything older returns an empty result.

2 credits / requestBilled only on success
GET
/v2/douyin/billboard/videos/trends

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

aweme_id*string

Douyin video id, or any douyin.com video URL (/video/, /note/, an iesdouyin share link, or a ?modal_id= link).

Length1 <= length
option?|

Metric selector for the trend series.

Range0 <= value <= 10
Default7
date_window?integer

Sampling selector: 1 (hourly) or 2 (daily).

Default1

Value in

  • 1
  • 2
curl -X GET "https://example.com/v2/douyin/billboard/videos/trends?aweme_id=7448118827402972455" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "data": {      "list": []    }  }}