# 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 t…

Canonical page: https://okdata.online/roles/trends-list/

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.

## on each platform

| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Douyin | [Douyin hot search board](https://okdata.online/apis/douyin/trends/list/) | `GET /v1/douyin/trends/list` | 50 | $0.002 per call · about 50 board entries per page |
| Xiaohongshu (RedNote) | [Xiaohongshu hot topics](https://okdata.online/apis/xiaohongshu/trends/list/) | `GET /v1/xiaohongshu/trends/list` | 20 | $0.02 per call · about 20 board entries per page |
| Bilibili | [Bilibili hot searches](https://okdata.online/apis/bilibili/trends/list/) | `GET /v1/bilibili/trends/list` | 50 | $0.002 per call · about 50 board entries per page |
| Weibo | [Weibo hot search](https://okdata.online/apis/weibo/trends/list/) | `GET /v1/weibo/trends/list` | 50 | $0.002 per call · about 50 board entries per page |
| X (Twitter) | [X trending topics](https://okdata.online/apis/x/trends/list/) | `GET /v1/x/trends/list` | 30 | $0.009 per call · about 30 board entries per page |
| Reddit | [Reddit trending searches](https://okdata.online/apis/reddit/trends/list/) | `GET /v1/reddit/trends/list` | 6 | $0.002 per call · about 6 board entries per page |
| Kuaishou | [Kuaishou hot list](https://okdata.online/apis/kuaishou/trends/list/) | `GET /v1/kuaishou/trends/list` | 51 | $0.002 per call · about 51 board entries per page |

## The object it returns: [Trend](https://okdata.online/docs/objects/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.

```bash
# 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.

## Other data types

- [Comments API](https://okdata.online/roles/posts-comments-list/)
- [Comment replies API](https://okdata.online/roles/comments-replies-list/)
- [Hashtag posts API](https://okdata.online/roles/topics-posts-list/)
- [Profile API](https://okdata.online/roles/accounts-get/)
- [Account posts API](https://okdata.online/roles/accounts-posts-list/)
- [Post detail API](https://okdata.online/roles/posts-get/)
- [Post search API](https://okdata.online/roles/posts-search/)
- [Trending posts API](https://okdata.online/roles/posts-trending/)
- [Account search API](https://okdata.online/roles/accounts-search/)
- [Post metrics API](https://okdata.online/roles/posts-metrics/)
- [Community posts API](https://okdata.online/roles/communities-posts-list/)
- [Ad detail API](https://okdata.online/roles/ads-get/)
- [Advertiser ads API](https://okdata.online/roles/advertisers-ads-list/)
- [Ad search API](https://okdata.online/roles/ads-search/)
- [Transcript API](https://okdata.online/roles/transcripts-get/)
- [Followers list API](https://okdata.online/roles/accounts-followers-list/)
- [Product detail API](https://okdata.online/roles/products-get/)
- [Product reviews API](https://okdata.online/roles/products-reviews-list/)
- [Product search API](https://okdata.online/roles/products-search/)
- [Creator search API](https://okdata.online/roles/creators-search/)
- [Creator profile API](https://okdata.online/roles/creators-get/)
- [Creator audience API](https://okdata.online/roles/creators-audience-get/)