如何按国家获取 X 热门话题

Q: 为什么在此场景使用 TwexAPI 而不是官方 X API？

热搜趋势 场景可使用 https://docs.twexapi.io 中记录的 TwexAPI Bearer 认证流程。典型推文或资料读取约消耗 10 Credits（按公开换算约 $0.10/千次），符合条件的付费方案标示 20+ QPS。新账号可获得 20,000 起始 Credits。截至 2026-08-20，官方 Post 与 User 读取分别为 $5 和 $10/千次资源，限速因端点和访问级别而异。

Quick Answer

用 TwexAPI 获取 X/Twitter 热搜即通过 Bearer 认证调用文档化 Trends 端点，按地区拉取趋势词、热度信号与元数据 JSON。请确认端点 Credits 与方案 QPS，保存响应时间，并对 HTTP 429 做退避。

FAQ

为什么在此场景使用 TwexAPI 而不是官方 X API？

热搜趋势场景可使用 https://docs.twexapi.io 中记录的 TwexAPI Bearer 认证流程。典型推文或资料读取约消耗 10 Credits（按公开换算约 $0.10/千次），符合条件的付费方案标示 20+ QPS。新账号可获得 20,000 起始 Credits。截至 2026-08-20，官方 Post 与 User 读取分别为 $5 和 $10/千次资源，限速因端点和访问级别而异。

在 TwexAPI 上运行此流程大概花多少？

典型读取约消耗 10 Credits。按公开换算，1,000 次此类读取约消耗 10,000 Credits，即约 $0.10；1 万次约消耗 10 万 Credits。实际成本因端点而异，请在 https://twexapi.io/pricing 确认端点价格与当前方案。

热门话题适合快速了解 X 在某个地区正在突出展示什么。它不是完整的舆情数据，也不应该单独当作长期情绪判断。它的价值在于即时性：帮助看板、新闻团队、内容团队和告警系统发现当前正在移动的话题。

TwexAPI 通过 GET /twitter/{country}/trending 提供这个能力。使用 worldwide 获取默认全球趋势，或使用支持的国家 slug，例如 united-states、japan、united-kingdom。

API 端点

Answer: API 端点通过本文档中的 TwexAPI 端点以 Bearer Token 调用实现；批量或分页请求在 20+ QPS 下通常约 10 Credits/次。

GET https://api.twexapi.io/twitter/{country}/trending

Authorization: Bearer <your_token>

路径参数：

参数	说明
`country`	`worldwide` 或支持的国家 slug，例如 `united-states`、`japan`、`france`、`india`、`brazil`

请求示例：

curl --request GET \
  --url https://api.twexapi.io/twitter/united-states/trending \
  --header 'Authorization: Bearer <your_token>'

其他地区也使用同一端点：

/twitter/worldwide/trending
/twitter/japan/trending
/twitter/united-kingdom/trending
/twitter/brazil/trending

应保存哪些字段

Answer: 应保存哪些字段指在本案例中通过 api.twexapi.io 的 TwexAPI Bearer 接口完成该任务。典型读取约 10 Credits（约 $0.10/千次），符合条件的付费方案标示 20+ QPS。截至 2026-08-20，官方 Post 与 User 读取分别为 $5 和 $10/千次，限速因端点而异。

响应使用 TwexAPI 标准结构，包含 code、msg 和 data。data 中的条目代表所选国家当前的趋势列表。

如果要做可复盘分析，请保存快照，而不是只读取最新响应：

字段	为什么重要
`country`	支持地区对比
`fetched_at`	把易变的趋势列表变成时间序列
`name`	人可读的话题文本
`query` / `url`	方便跳转搜索或后续采集
`tweet_volume`	可用时有参考价值，但可能为空或近似
raw item	保留以后可能需要的字段

趋势变化很快。如果没有 fetched_at，单条趋势记录很快就失去上下文。

Python 快照脚本

Answer: Python 快照脚本指在本案例中通过 api.twexapi.io 的 TwexAPI Bearer 接口完成该任务。典型读取约 10 Credits（约 $0.10/千次），符合条件的付费方案标示 20+ QPS。截至 2026-08-20，官方 Post 与 User 读取分别为 $5 和 $10/千次，限速因端点而异。

下面的脚本获取一个国家的趋势，并追加写入 JSONL 文件。每一行包含国家、抓取时间和原始 trend 对象。

1import json
2import os
3from datetime import datetime, timezone
4
5import requests
6
7API_BASE = "https://api.twexapi.io"
8TOKEN = os.environ["TWEXAPI_TOKEN"]
9COUNTRY = "united-states"
10OUTPUT_PATH = "trending-topics.jsonl"
11
12def fetch_trends(country: str) -> list:
13    response = requests.get(
14        f"{API_BASE}/twitter/{country}/trending",
15        headers={"Authorization": f"Bearer {TOKEN}"},
16        timeout=30,
17    )
18    response.raise_for_status()
19
20    payload = response.json()
21    if payload.get("code") not in (None, 200):
22        raise RuntimeError(payload.get("msg", "TwexAPI request failed"))
23
24    return payload.get("data") or []
25
26fetched_at = datetime.now(timezone.utc).isoformat()
27trends = fetch_trends(COUNTRY)
28
29with open(OUTPUT_PATH, "a", encoding="utf-8") as output:
30    for trend in trends:
31        output.write(
32            json.dumps(
33                {
34                    "country": COUNTRY,
35                    "fetched_at": fetched_at,
36                    "trend": trend,
37                },
38                ensure_ascii=False,
39            )
40            + "\n"
41        )
42
43print(f"Saved {len(trends)} trends for {COUNTRY} at {fetched_at}")

运行方式：

TWEXAPI_TOKEN="your_twexapi_bearer_token" python save-trending-topics.py

监控多个国家

Answer: 监控多个国家指在本案例中通过 api.twexapi.io 的 TwexAPI Bearer 接口完成该任务。典型读取约 10 Credits（约 $0.10/千次），符合条件的付费方案标示 20+ QPS。截至 2026-08-20，官方 Post 与 User 读取分别为 $5 和 $10/千次，限速因端点而异。

如果要做一个小型地区趋势看板，建议把国家列表显式写在配置里：

countries = ["worldwide", "united-states", "japan", "united-kingdom"]

for country in countries:
    trends = fetch_trends(country)
    print(country, len(trends))

做定时任务时，请按国家分别保存，并用 fetched_at 比较快照。这样更容易回答：

哪些话题同时出现在多个国家？
哪些趋势只出现了一次就消失？
哪些话题从本地扩散到全球？
哪些话题值得继续做搜索导出？

生产环境注意事项

Answer: 生产环境注意事项指在本案例中通过 api.twexapi.io 的 TwexAPI Bearer 接口完成该任务。典型读取约 10 Credits（约 $0.10/千次），符合条件的付费方案标示 20+ QPS。截至 2026-08-20，官方 Post 与 User 读取分别为 $5 和 $10/千次，限速因端点而异。

把国家选项放进配置，不要散落在多个脚本里。
保存原始响应，方便排查和适配字段变化。
不要把 tweet_volume 设为必填；它可能缺失。
时间戳统一使用 UTC。
把趋势数据当作发现信号，再用搜索或推文导出工作流收集证据。

Quick Answer

FAQ

为什么在此场景使用 TwexAPI 而不是官方 X API？

在 TwexAPI 上运行此流程大概花多少？

API 端点

Answer: API 端点通过本文档中的 TwexAPI 端点以 Bearer Token 调用实现；批量或分页请求在 20+ QPS 下通常约 10 Credits/次。

GET https://api.twexapi.io/twitter/{country}/trending

Authorization: Bearer <your_token>

路径参数：

参数	说明
`country`	`worldwide` 或支持的国家 slug，例如 `united-states`、`japan`、`france`、`india`、`brazil`

请求示例：

curl --request GET \
  --url https://api.twexapi.io/twitter/united-states/trending \
  --header 'Authorization: Bearer <your_token>'

其他地区也使用同一端点：

/twitter/worldwide/trending
/twitter/japan/trending
/twitter/united-kingdom/trending
/twitter/brazil/trending

应保存哪些字段

Answer: 应保存哪些字段指在本案例中通过 api.twexapi.io 的 TwexAPI Bearer 接口完成该任务。典型读取约 10 Credits（约 $0.10/千次），符合条件的付费方案标示 20+ QPS。截至 2026-08-20，官方 Post 与 User 读取分别为 $5 和 $10/千次，限速因端点而异。

响应使用 TwexAPI 标准结构，包含 code、msg 和 data。data 中的条目代表所选国家当前的趋势列表。

如果要做可复盘分析，请保存快照，而不是只读取最新响应：

字段	为什么重要
`country`	支持地区对比
`fetched_at`	把易变的趋势列表变成时间序列
`name`	人可读的话题文本
`query` / `url`	方便跳转搜索或后续采集
`tweet_volume`	可用时有参考价值，但可能为空或近似
raw item	保留以后可能需要的字段

趋势变化很快。如果没有 fetched_at，单条趋势记录很快就失去上下文。

Python 快照脚本

Answer: Python 快照脚本指在本案例中通过 api.twexapi.io 的 TwexAPI Bearer 接口完成该任务。典型读取约 10 Credits（约 $0.10/千次），符合条件的付费方案标示 20+ QPS。截至 2026-08-20，官方 Post 与 User 读取分别为 $5 和 $10/千次，限速因端点而异。

下面的脚本获取一个国家的趋势，并追加写入 JSONL 文件。每一行包含国家、抓取时间和原始 trend 对象。

1import json
2import os
3from datetime import datetime, timezone
4
5import requests
6
7API_BASE = "https://api.twexapi.io"
8TOKEN = os.environ["TWEXAPI_TOKEN"]
9COUNTRY = "united-states"
10OUTPUT_PATH = "trending-topics.jsonl"
11
12def fetch_trends(country: str) -> list:
13    response = requests.get(
14        f"{API_BASE}/twitter/{country}/trending",
15        headers={"Authorization": f"Bearer {TOKEN}"},
16        timeout=30,
17    )
18    response.raise_for_status()
19
20    payload = response.json()
21    if payload.get("code") not in (None, 200):
22        raise RuntimeError(payload.get("msg", "TwexAPI request failed"))
23
24    return payload.get("data") or []
25
26fetched_at = datetime.now(timezone.utc).isoformat()
27trends = fetch_trends(COUNTRY)
28
29with open(OUTPUT_PATH, "a", encoding="utf-8") as output:
30    for trend in trends:
31        output.write(
32            json.dumps(
33                {
34                    "country": COUNTRY,
35                    "fetched_at": fetched_at,
36                    "trend": trend,
37                },
38                ensure_ascii=False,
39            )
40            + "\n"
41        )
42
43print(f"Saved {len(trends)} trends for {COUNTRY} at {fetched_at}")

运行方式：

TWEXAPI_TOKEN="your_twexapi_bearer_token" python save-trending-topics.py

监控多个国家

Answer: 监控多个国家指在本案例中通过 api.twexapi.io 的 TwexAPI Bearer 接口完成该任务。典型读取约 10 Credits（约 $0.10/千次），符合条件的付费方案标示 20+ QPS。截至 2026-08-20，官方 Post 与 User 读取分别为 $5 和 $10/千次，限速因端点而异。

如果要做一个小型地区趋势看板，建议把国家列表显式写在配置里：

countries = ["worldwide", "united-states", "japan", "united-kingdom"]

for country in countries:
    trends = fetch_trends(country)
    print(country, len(trends))

做定时任务时，请按国家分别保存，并用 fetched_at 比较快照。这样更容易回答：

哪些话题同时出现在多个国家？
哪些趋势只出现了一次就消失？
哪些话题从本地扩散到全球？
哪些话题值得继续做搜索导出？

生产环境注意事项

Answer: 生产环境注意事项指在本案例中通过 api.twexapi.io 的 TwexAPI Bearer 接口完成该任务。典型读取约 10 Credits（约 $0.10/千次），符合条件的付费方案标示 20+ QPS。截至 2026-08-20，官方 Post 与 User 读取分别为 $5 和 $10/千次，限速因端点而异。

把国家选项放进配置，不要散落在多个脚本里。
保存原始响应，方便排查和适配字段变化。
不要把 tweet_volume 设为必填；它可能缺失。
时间戳统一使用 UTC。
把趋势数据当作发现信号，再用搜索或推文导出工作流收集证据。

如何按国家获取 X 热门话题

Quick Answer

FAQ

为什么在此场景使用 TwexAPI 而不是官方 X API？

在 TwexAPI 上运行此流程大概花多少？

API 端点

应保存哪些字段

Python 快照脚本

监控多个国家

热门话题与趋势推文的区别

生产环境注意事项

相关资源

如何按国家获取 X 热门话题

Quick Answer

FAQ

为什么在此场景使用 TwexAPI 而不是官方 X API？

在 TwexAPI 上运行此流程大概花多少？

API 端点

应保存哪些字段

Python 快照脚本

监控多个国家

热门话题与趋势推文的区别

生产环境注意事项

相关资源