# X 趋势：实时榜单和接口

> 全球或某个国家的趋势话题。可以用你的 key 实时读取X（推特）榜单，或调用 x.trends.list，每次 $0.009。

网页版：https://okdata.online/zh/tools/hot-search/x/

X 的全球或单个国家趋势话题，X 展示帖子数的会一并返回。

按小时变化，各国不同；用 country 参数指定国家。

## 每日存档

- [2026-11-12](https://okdata.online/zh/tools/hot-search/x/2026-11-12/)

## 每条数据包含

- `rank`, `name`, `heat`, `url`

## 费用

读一次就是一次调用：$0.009/次 · 每页约 30 条榜单。每小时读一次、读一整天是 24 次调用，共 $0.216。

```bash
curl "https://api.okdata.online/v1/x/trends/list" \
  -H "Authorization: Bearer $OKDATA_API_KEY"
```

[X 趋势接口文档](https://okdata.online/zh/apis/x/trends/list/)

每个榜单的每日存档页即将上线；在那之前，可以定时调用、自己保存历史。