如何按国家获取 public platform 热门话题

Quick Answer

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

FAQ

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

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

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

典型读取约消耗 5 Credits。按公开换算，1,000 次此类读取约消耗 5,000 Credits，即约 $0.05；1 万次约消耗 50,000 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 下通常约 5 Credits/次。

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

Authorization: Bearer <your_token>

路径参数：

请求示例：

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 接口完成该任务。典型读取约 5 Credits（约 $0.05/千次），符合条件的付费方案标示 20+ QPS。截至 2026-08-20，官方 Post 与 User 读取分别为 $5 和 $10/千次，限速因端点而异。

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

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

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

Python 快照脚本

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

这个端点返回的是话题列表，适合看板、告警和选题规划。

如果你需要某个趋势分类下的具体推文，请使用 global trending tweets 工作流。那个流程会用到 /twitter/global-trending/countries、/twitter/global-trending/topics 和 /twitter/global-trending/tweets。

把这两类任务分开：热门话题告诉你该看什么，趋势推文提供可分析的帖子。

生产环境注意事项

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

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

相关资源

• 获取热门话题
• 如何获取全球趋势推文
• TwexAPI 文档