如何获取 X（推特）各国热门话题
用 2 个接口：X 趋势榜 → X 帖子搜索。下面的示例一共 3 次调用，合计 $0.0200；失败的调用不收费。
拿到 X（推特）趋势榜前 30 个话题和名次，可以是全球的，也可以是 10 个国家里任意一个的；再看某个话题下大家在发什么。
第 1 步：X 趋势榜
不传 region 是全球榜；要某个国家的，传两个字母的国家代码：US、GB、CA、AU、IN、JP、DE、FR、BR、MX。每条有话题名 name 和名次 rank，下一步用 name。
curl "https://api.dataxapi.com/v1/x/trends/list" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.x.trends.list() print(result["data"]["items"])
import { DataXAPI } from "@dataxapi/sdk";
const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.x.trends.list();
console.log(result.data.items);dataxapi call x.trends.list
录制的返回
{
"code": "ok",
"request_id": "86caa2be-f053-4926-a0ef-f572a73d938b",
"data": {
"items": [
{ "name": "Weekend hiking", "rank": 1 },
// … 另有 29 条
]
},
"page": {
"next_cursor": null,
"cursor_expires_at": null,
"has_more": false,
"returned": 30
},
"warnings": [],
"meta": {
"capability": "x.trends.list",
"result_status": "complete",
"fetched_at": "2026-10-13T03:29:53.000Z",
"cached": false,
"replayed": false,
"unavailable": { "id": "platform", "heat": "capability" },
"billing": {
"amount": "0.009",
"currency": "USD",
"balance_after": "9.991"
}
}
}取自 2026-10-13 03:29 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。
X 趋势榜 · $0.0090 / 一次 · 参数、字段和报错见接口页 →
第 2 步：X 帖子搜索
把某个话题的 name 作为 query 搜帖子，看大家在说什么。
curl -G "https://api.dataxapi.com/v1/x/posts/search" \ --data-urlencode "query=weather forecast" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.x.posts.search(query="weather forecast") print(result["data"]["items"])
import { DataXAPI } from "@dataxapi/sdk";
const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.x.posts.search({ query: "weather forecast" });
console.log(result.data.items);dataxapi call x.posts.search 'query=weather forecast'录制的返回
{
"code": "ok",
"request_id": "f56e2410-206b-4506-a850-44cf2be4613e",
"data": {
"items": [
{
"id": "1860387339653354774",
"url": "https://x.com/i/status/1860387339653354774",
"type": "video",
"text": "My honest take on weather forecast, a month in.",
"lang": "en",
"published_at": "2026-10-12T00:44:12.000Z",
"author": {
"id": "118815899823132376",
"username": "trail_and_lens",
"name": "Maya Chen",
"avatar_url": "https://pbs.twimg.com/profile_images/1838837416644987075/31t9r3Fm_normal.jpg",
"verified": true,
"followers": 7425
},
"metrics": {
"likes": 238,
"comments": 37,
"favorites": 145,
"views": 8357,
"reposts": 121
},
"images": [],
"hashtags": [],
"mentions": [
{
"id": "124366312906800227",
"username": "fieldnotes_studio",
"name": "Field Notes Studio"
}
],
"post_id": null,
"parent_id": null
},
// … 另有 19 条
]
},
"page": {
"next_cursor": "c1.0BcduLiC6vViwQfDR_nS6Twlb6kjko4Qpbx3fUDt",
"cursor_expires_at": "2026-10-12T20:10:39.000Z",
"has_more": true,
"returned": 20
},
"warnings": [],
"meta": {
"capability": "x.posts.search",
"result_status": "complete",
"fetched_at": "2026-10-12T19:10:39.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"title": "platform",
"metrics.shares": "platform",
"is_pinned": "capability",
"root_id": "platform"
},
"billing": {
"amount": "0.002",
"currency": "USD",
"balance_after": "9.998"
}
}
}取自 2026-10-12 19:10 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。
X 帖子搜索 · $0.0020 / 一次 · 参数、字段和报错见接口页 →
示例花多少钱
取全球榜和美国榜各一次，再搜一页某个话题下的帖子
价格是生成本页时的现行价格。失败的调用、不存在的对象都不收费。
在 AI 里做（MCP）
把 DataXAPI 接进你的 AI 客户端，只要接一次。之后直接说要什么，代理自己找到这些接口、看好价格，用你的余额调用。
这样说: 用 DataXAPI 取 X 当前的美国榜和全球榜，告诉我哪些话题两个榜上都有。
代理发给 call 工具的参数
{
"capability": "x.trends.list",
"idempotency_key": "<a new UUID>"
}用 Skill 做
要知道的
- 趋势榜是每 5 分钟刷新一次的快照，
meta.fetched_at写明是什么时候取的。 - 每个话题只有名字和名次，没有帖子数、热度，也没有编号。
- 只有这 10 个国家和全球榜；传别的代码会按参数错误拒绝，不会执行。
- 趋势榜返回空不计费；帖子搜索返回空页照常计费。