# Is there an API for the Douyin hot search list?

> Get Douyin's hot search board (抖音热榜) as JSON with rank, keyword and heat value, how often to poll it, what it costs, and how to find the videos behind each topic.

Canonical page: https://okdata.online/answers/douyin-hot-search-api/

**Short answer: **Yes. The okdata Douyin hot search endpoint returns the current board, about 50 rows with rank, keyword and heat value, in one call for $0.002. Polling it every hour costs $0.048 a day, and the videos behind a topic are one video search away at $0.02 per page.

A newsroom wants a Slack message whenever a topic about their beat climbs into Douyin's top 10. A brand team wants a morning digest of the board with anything relevant to the category flagged. Both need the board as data on a schedule, and scraping the app's hot list page means signatures, device parameters and a browser. One API call returns the whole board as JSON.

## The endpoint

[Douyin hot search board](/apis/douyin/trends/list/) takes no parameters. One call returns the current main hot search list, about 50 rows, each with:

- `rank`, the position on the board;
- `name`, the hot word as Douyin shows it;
- `heat`, Douyin's hot value;
- `url`, a douyin.com search link for that word.

## What polling costs

| Frequency | Calls per day | Per day | Per 30 days |
|---|---|---|---|
| Every hour | 24 | $0.048 | $1.44 |
| Every 15 minutes | 96 | $0.192 | $5.76 |
| Hourly, plus 1 search page for 3 new topics a day | 27 | $0.108 | — |

## Example

```bash
curl -s "https://api.okdata.online/v1/douyin/trends/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  | jq -r '.data.items[:10][] | "\(.rank). \(.name)  \(.heat)"'
```

To see the videos behind a hot word, pass `name` to [video search](/apis/douyin/videos/search/) with `sort=most_liked`.

## Things to know

- This is the main hot search board. Douyin's other boards (entertainment, society, challenges, music) are not in the catalog.
- The first row can be a pinned topic Douyin places at the top; it may have no heat value, so `heat` is null. Rank follows the board's order.
- There is no history in the response. Store each snapshot with `meta.fetched_at` to build one.
- Rate limits apply per key; the `X-RateLimit-Remaining` header tells your poller how much burst is left before it should wait.

## Alternatives

The hot list in the Douyin app is free for a person to look at. Hot-list aggregator sites show several Chinese boards side by side and suit casual monitoring. 抖音热点宝 in the creator tools adds analysis for creators. For alerts and archives in your own systems, the API is simpler. Weibo's board is also available if you watch both ([Weibo hot search](/apis/weibo/trends/list/)); see [trend research](/solutions/trend-research/) for a combined setup.

## Endpoints used

- [Douyin hot search board](https://okdata.online/apis/douyin/trends/list/) `douyin.trends.list`: $0.002 per call · about 50 board entries per page
- [Douyin video search](https://okdata.online/apis/douyin/videos/search/) `douyin.videos.search`: $0.02 per call · about 20 videos per page

Updated 2026-11-12