X / Twitter API
X / Twitter 趋势 API
获取全球、某个国家或某个城市当前的 X (Twitter) 趋势，按 X 的排名顺序返回，并包含解析后的地点。
POST/v1/run/twitter.trends
可用率
100.00%
30d · 489 次调用
请求数
505
30d · 按周，近 12 周
响应时间
1.3s
中位数 · 30d
服务商网络
按流量排序的服务商
试一试
发出你的第一个请求
requireFieldsarray可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `promoted`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个趋势确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"asOfUtc": 12.5,
"items": [
{
"isHashtag": true,
"name": "Example title",
"promoted": true,
"query": "example",
"rank": 1
}
],
"location": "example",
"locationId": "a1b2c3d4",
"url": "https://example.com/page"
},
"found": true,
"reason": "not_found"
}响应类型定义
interface TwitterTrendsResponse {
data: {
asOfUtc: number;
items: {
isHashtag?: boolean;
name: string;
promoted?: boolean;
query: string;
rank: number;
}[];
location: string;
locationId: string;
url?: string;
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/twitter.trends
curl -X POST https://api.getanyapi.com/v1/run/twitter.trends \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"limit":10,"location":"US"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| limit | integer | 10最多返回的排名趋势数量（1-50，默认 50）。 |
| location | string | "US"国家名称、城市名称或 ISO 国家代码。省略则返回全球趋势。 |
| requireFields | array | 可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `promoted`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个趋势确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。 |
| 响应 | ||
| data | object | The resolved location and its current ranked trends, or null when unavailable. |
| data.asOfUtc | number | 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. |
| data.items | object[] | 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. |
| data.items[].isHashtag可设为必填 | boolean | Whether the trend text is a hashtag. |
| data.items[].name | string | Trend text displayed by X. Populated whenever the provider has data for the entity. |
| data.items[].promoted可设为必填 | boolean | Whether X marks the trend as promoted. |
| data.items[].query | string | Search query corresponding to the trend. Populated whenever the provider has data for the entity. |
| data.items[].rank | integer | One-based position in X's trend ranking. Populated whenever the provider has data for the entity. |
| data.location | string | Resolved X trend-location name. Populated whenever the provider has data for the entity. |
| data.locationId | string | Resolved Yahoo WOEID used by X, exposed as a stable location identifier. Populated whenever the provider has data for the entity. |
| data.url | string | X search URL for the trend. |
| found | boolean | 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. |
| 价格 | ||
| 每次请求价格 | USD | US$0.0001 |
| 价格（/千次请求） | USD | US$0.10 |
常见问题
关于 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 调用中有 100.0% 成功，响应时间中位数为 1.3 秒，共测量 489 次调用。
费用：每千次请求 US$0.10 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。
获取全球、某个国家或某个城市当前的 X (Twitter) 趋势，按 X 的排名顺序返回，并包含解析后的地点。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。
过去 30 天，通过 AnyAPI 发起的 X / Twitter 趋势 API 调用中有 100.0% 成功，响应时间中位数为 1.3 秒，共测量 489 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。