Finewisdom API Hub
首页 › 数据接口 › Twitter/X › tw_trending

Twitter/X热榜接口tw_trending

tw_trending 是 Finewisdom 的Twitter/X热榜接口:获取推特趋势话题。单价 ¥0.1 / 次,成功才计费,注册赠 20 次。

注册领 20 次免费额度catalog.jsonMCP

参数

该接口无需参数。

调用示例

把 token 换成你的即可,所有参数走 query string。

GET https://finewisdom.top/api?token=fw_xxx&method=tw_trending

Python 调用

import requests

resp = requests.get(
    "https://finewisdom.top/api",
    params={"token": "fw_xxx", "method": "tw_trending"},
    timeout=60,
)
payload = resp.json()
if payload.get("status") == "success":
    data = payload["data"]
else:
    print(payload["message"])  # 失败不计费

返回结构

统一信封。status 为 success 才计费,失败 / 空结果不扣费。

{
  "status": "success",
  "message": "...",
  "data": { ... }
}

示例只展示统一信封,data 内字段以实际返回为准——建议先用 1 次调用看结构,再写解析。

Token 在控制台注册后自动生成,形如 fw_xxx,不要写进代码仓库或日志。

计费与限流

单价 ¥0.1 / 次,只在 status=success 时扣费;失败、超时、空结果都不计费。限流 1 次/秒/IP,超出返回 429。

新用户注册赠 20 次免费调用,余额不过期。

常见问题

这个接口调用失败会扣钱吗?

不会。返回 status=error 或 api_error 时不计费,预扣的额度会自动退回。只有当 status=success 才算一次成功调用。

单价多少,怎么计费?

¥0.1 / 次,按成功调用次数计费,没有月费、没有最低消费。翻页每翻一页各算一次调用。

同平台其他接口

tw_keyword_search¥0.1搜索推文tw_post_comments¥0.1获取推文评论(回复)tw_post_detail¥0.1获取推文详情tw_user_info¥0.1获取推特用户信息tw_user_posts¥0.1获取用户推文列表(screen_name 与 rest_id 二选一)