推特/Twitter(X)社交搜索 API

最后更新: 2026-06-22

推特/Twitter(X)社交搜索 API 让 Agent 用 social_twitter 查推特账号资料、近期推文和话题讨论，按账号、关键词、语言和时间检索，社媒调研、竞品动态和话题素材直接可用。

数据覆盖：账号资料/近期推文/关键词搜索三种读取模式

source	social_twitter
计费	单次调用 ¥0.07（¥7 / 100 次），约 20 条推文，每条约 ¥0.0035
典型 filters	mode, username, lang, since
query	完整自然语言意图，如 “AI agent product launch”
返回格式	默认 markdown，可请求 return.format=json
适用任务	社媒调研、竞品动态、话题与素材检索

什么时候用社交搜索 API

三种读取模式怎么选

POST https://api.huohuaapi.com/v1/search
{
  "source": "social_twitter",
  "purpose": "查 AI agent 新品发布相关推文",
  "filters": {
    "mode": "search",
    "lang": "en"
  },
  "query": "AI agent product launch"
}

把这个数据源接入你的 Agent

方式一(推荐):装成 Claude Code / Codex 技能,Agent 需要时自动调用。

curl -fsSL https://skills.huohuaapi.com/social_twitter/install.sh | sh

方式二:直接调 API(token 到控制台开通该数据源)。

curl -s "https://api.huohuaapi.cn/v1/search" \
  -H "Authorization: Bearer $HUOHUA_DATA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source":"social_twitter","query":"...","filters":{}}'

默认入口 https://api.huohuaapi.cn/v1(国内直连),海外或连接失败改用 https://api.huohuaapi.com/v1;功能与计费一致。

收费 · ¥7 / 100 次:按成功返回计费(空结果/报错不扣费),从余额扣减,已含你的 token。使用前请先登录 / 注册获取 API Key;Agent 可直接用本页链接安装 skill。

常见问题

用社交搜索 API 需要先注册吗？

可以先免注册充值获取 API Key 再调用；已有账号则在控制台开通数据源后调用。

推特 API（Twitter API）怎么调用？

用火花的推特 API：POST https://api.huohuaapi.com/v1/search，传 source=social_twitter、mode 和 query，即可查推特（X/Twitter）账号资料、近期推文和话题，OpenAI 兼容、零配置。

推特 API 多少钱？

推特 API 单次调用 ¥0.07（¥7 / 100 次），单次约 20 条推文，平均每条约 ¥0.0035，按成功返回计费。

推特 / Twitter API 有中转、agent、skill 吗？

火花就是推特 API 中转：一个 OpenAI 兼容入口中转调用 X/Twitter 数据，免去官方申请；可作为 skill 装进 Claude Code 等 Agent 直接用，也可 POST /v1/search 调用。

filters 和 query 怎么分工？

filters 放确定条件（年份、类型、地区、对象等）；query 放完整自然语言意图，承接难以参数化的语义。

返回结果能直接引用吗？

可以。默认返回带来源的 markdown，适合 Agent 直接引用；需要结构化时请求 return.format=json。

空结果或 invalid_filter 怎么排查？

先放宽 filters、核对字段名与取值，再用更聚焦的 query 重试；仍为空说明该条件下暂无匹配材料。

和模型 API 有什么区别？

模型 API 走 /v1 生成文本；数据 API 走 /v1/search 用 social_twitter 检索可引用材料，二者可在同一 Agent 流程组合。

这个数据 API 有 skill 吗、能直接给 Agent / Claude Code 用吗？

可以。除了直接 POST /v1/search，还提供 skill 包：装进 Claude Code、Codex、Cline 等 Agent 后，Agent 会自动用 social_twitter 检索，无需手写请求。