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>路径参数：
| 参数 | 说明 |
|---|---|
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 接口完成该任务。典型读取约 5 Credits（约 $0.05/千次），符合条件的付费方案标示 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 接口完成该任务。典型读取约 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。
- 把趋势数据当作发现信号，再用搜索或推文导出工作流收集证据。