Endpoints by data type
Trending topics API
7 endpoints on 7 platforms return trending topics as the same Trend object. A platform’s own trending board as it stands when you call: each entry’s rank, the topic or search term, the heat score the platform shows and a link. A call costs from $0.002 to $0.02, each endpoint at its own price; a failed call is free.
Trending topics · on each platform
| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Douyin | Douyin hot search board | GET /v1/douyin/trends/list | 50 | $0.002 per call · about 50 board entries per page |
| Xiaohongshu (RedNote) | Xiaohongshu hot topics | GET /v1/xiaohongshu/trends/list | 20 | $0.02 per call · about 20 board entries per page |
| Bilibili | Bilibili hot searches | GET /v1/bilibili/trends/list | 50 | $0.002 per call · about 50 board entries per page |
| Weibo hot search | GET /v1/weibo/trends/list | 50 | $0.002 per call · about 50 board entries per page | |
| X (Twitter) | X trending topics | GET /v1/x/trends/list | 30 | $0.009 per call · about 30 board entries per page |
| Reddit trending searches | GET /v1/reddit/trends/list | 6 | $0.002 per call · about 6 board entries per page | |
| Kuaishou | Kuaishou hot list | GET /v1/kuaishou/trends/list | 51 | $0.002 per call · about 51 board entries per page |
from $0.002 to $0.02 a call, each endpoint at its own price. A call that fails costs nothing.
The object it returns: Trend
Every endpoint above returns these fields with the same names and types. A field a platform does not show comes back null and is named in meta.unavailable.
| Field | Type | Meaning |
|---|---|---|
rank | integer | Position on the board, 1 is the top. |
name | string | The topic or search term. |
heat | number | null | The heat score the platform shows; scales differ by platform. |
url | string | null | Link to the topic page, if there is one. |
The same call on two platforms
Same parameters, same paging, same response shape. Only the path changes.
# Douyin
curl "https://api.okdata.online/v1/douyin/trends/list" \
-H "Authorization: Bearer $OKDATA_API_KEY"
# Xiaohongshu (RedNote)
curl "https://api.okdata.online/v1/xiaohongshu/trends/list" \
-H "Authorization: Bearer $OKDATA_API_KEY"What people use it for
- Save the board every hour and see how long a topic stays on it.
- Alert the team when a brand or product name shows up.
- Give an AI agent today’s boards before it drafts content ideas.
Questions
- Can I compare heat values across platforms?
- No. Each platform computes heat its own way and on its own scale, and some show none. Compare ranks and time on the board instead.
- Can I get yesterday’s board?
- The endpoints return the board as it is now. To keep history, call on a schedule and store each read; the free hot search pages on this site keep a daily archive for some boards.
- How often should I read a board?
- Boards move within the hour, so hourly is a common rhythm. Each read is one call, so 24 reads a day cost 24 times the price in the table.