X / Twitter 趋势 API
获取全球、某个国家或某个城市当前的 X (Twitter) 趋势，按 X 的排名顺序返回，并包含解析后的地点。
US$0.10/千次请求，按请求付费，无需订阅。
Trending
United States
Trending in United States
#NBAOpeningNight
Trending in United States
Federal Reserve
Promoted
iPhone 18
Trending in United States
#MondayMotivation
Trending in United States
Coachella 2027
{"rank": 1,"name": "#NBAOpeningNight","isHashtag": true,"query": "%23NBAOpeningNight","promoted": false,"url": "https://x.com/search?q=%23NBAOpeningNight"}
价格与服务商
X / Twitter 趋势 API 价格：一个 API，2 个可互换的服务商
最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。
试一试
一个请求获取 X / Twitter 趋势
这个示例展示了 13 个字段中的 12 个。查看全部字段
{
"found": true,
"data": {
"location": "United States",
"locationId": "23424977",
"asOfUtc": 1727366400,
"items": [
{
"rank": 1,
"name": "#NBAOpeningNight",
"isHashtag": true,
"query": "%23NBAOpeningNight",
"promoted": false,
"url": "https://x.com/search?q=%23NBAOpeningNight"
},
{
"rank": 2,
"name": "Federal Reserve",
"isHashtag": false,
"query": "%22Federal%20Reserve%22",
"promoted": false,
"url": "https://x.com/search?q=%22Federal%20Reserve%22"
},
{
"rank": 3,
"name": "iPhone 18",
"isHashtag": false,
"query": "%22iPhone%2018%22",
"promoted": true,
"url": "https://x.com/search?q=%22iPhone%2018%22"
},
{
"rank": 4,
"name": "#MondayMotivation",
"isHashtag": true,
"query": "%23MondayMotivation",
"promoted": false,
"url": "https://x.com/search?q=%23MondayMotivation"
},
{
"rank": 5,
"name": "Coachella 2027",
"isHashtag": false,
"query": "%22Coachella%202027%22",
"promoted": false,
"url": "https://x.com/search?q=%22Coachella%202027%22"
}
]
}
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-11-14 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- limitinteger
10
最多返回的排名趋势数量（1-50，默认 50）。
- locationstring
United States
国家名称、城市名称或 ISO 国家代码。省略则返回全球趋势。
- requireFieldsarray
可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `promoted`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个趋势确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。
响应
JSON，每个字段一个示例值。
The resolved location and its current ranked trends, or null when unavailable.
- asOfUtcnumber
1727366400
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
- locationstring
United States
Resolved X trend-location name. Populated whenever the provider has data for the entity.
- locationIdstring
23424977
Resolved Yahoo WOEID used by X, exposed as a stable location identifier. Populated whenever the provider has data for the entity.
Current trends in X's own ranking order. Distinct ranks may carry the same trend name. Populated whenever the provider has data for the entity.
- isHashtagboolean可设为必填
true
Whether the trend text is a hashtag.
- namestring
#NBAOpeningNight
Trend text displayed by X. Populated whenever the provider has data for the entity.
- promotedboolean可设为必填
false
Whether X marks the trend as promoted.
- querystring
%23NBAOpeningNight
Search query corresponding to the trend. Populated whenever the provider has data for the entity.
- rankinteger
1
One-based position in X's trend ranking. Populated whenever the provider has data for the entity.
- urlstring
https://x.com/search?q=%23NBAOpeningNight
X search URL for the trend.
- foundboolean
true
Whether X trends were resolved for the requested location.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
常见问题
关于 X / Twitter 趋势 API
AnyAPI 的 X / Twitter 趋势 API 只需一次 POST 请求 /v1/run/twitter.trends，就以统一格式的 JSON 返回 X / Twitter 数据。获取全球、某个国家或某个城市当前的 X (Twitter) 趋势，按 X 的排名顺序返回，并包含解析后的地点。AnyAPI 会在 2 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$0.10 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 X / Twitter 趋势 API 调用中有 99.8% 成功，响应时间中位数为 1.2 秒，共测量 3,535 次调用。