Douyin V2 API: Get the hot board

Returns hot.douyin.com's main board, either as a point-in-time snapshot or aggregated over a date range.

2 credits / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

page?integer

Page number starting at 1.

Range1 <= value

Default1

page_size?integer

Items per page.

Range1 <= value

Default10

range_type?string

snapshot reads the board as it stood at one moment, range aggregates across a date range.

Default"snapshot"

Value in

snapshot_time?string

Moment to read the board at, as yyyyMMddHHmmss. Used when range_type is snapshot.

start_date?string

Range start as yyyyMMdd. Used when range_type is range.

end_date?string

Range end as yyyyMMdd. Used when range_type is range.

tag?string

Comma-separated hot-topic category tags, from the billboard categories endpoint.

keyword?string

Optional term to filter the list by.

curl -X GET "https://example.com/v2/douyin/billboard/hot" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "data": {      "list": [        {          "hot_value": 9876543,          "title": "..."        }      ]    }  }}