x/
search-communities

按关键词搜索 X 社区,返回每个匹配社区的名称、链接、横幅图、成员数和敏感内容标记,每次搜索最多 500 个社区。

X Communities Search API

关键词输入
每个社区的成员数
敏感内容标记
每条结果 0.7 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

X Communities Search

X 社区是用户在 X 上加入的主题小组,在搜索列表里,每个社区会显示名称、横幅图、成员数,以及是否被标记为敏感内容。用关键词去匹配这些列表,就能看出一个话题主要在哪些社区里讨论、哪些社区规模最大,以及哪些社区在点开之前就带有成人或敏感标签。

X Communities Search API 主要特性

  • 一个关键词,查出所有匹配社区在 query 里填一个词或短语,例如 bitcoin,X 为它列出的社区会逐条返回。
  • 名称与横幅图name 和 cover_url 给出每个社区的名称和横幅图,足够在列表里认出它,也可以直接展示在你自己的界面上。
  • 用成员数判断规模metrics.members_count 显示有多少人加入,在搜索结果里就能分清几十人的小群和几万人的大社区。
  • 敏感内容标记社区在 X 上被标记为敏感内容时,is_nsfw 为 true,方便在成人社区进入报告或展示给用户之前先做处理。
  • 稳定的 ID 与链接每条结果都带有数字社区 id 和 https://x.com/i/communities/<id> 格式的 url,多次搜索保持不变,可以作为你自己数据里的主键。

X Communities Search API 参数

参数必填描述
query必填用来搜索 X 社区的关键词,例如 bitcoin。
results_limit可选返回的社区数量,取 10 到 500 之间 10 的倍数,默认 20。

如何使用 X Communities Search API

搜索关键词,分页读取匹配的社区。

  1. 向 /v1/x/search-communities 发送 {"query": "bitcoin", "results_limit": 20}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 results.items 读取匹配的社区;has_more 为 true 时,用 results.next_cursor 请求下一页。
curl -X POST "https://api.socq.ai/v1/x/search-communities" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"bitcoin","results_limit":20}'

# 每条结果的 url 可以直接传给 X Community Members、X Community Moderators 或 X Community Posts。

X Communities Search API 最佳使用场景

  • 摸清一个话题在 X 上的聚集地: 搜索某个市场或爱好的核心词,收集社区名称、链接和成员数,看清相关讨论集中在哪些社区。
  • 挑出细分领域里最大的社区: 按 metrics.members_count 排序,选出规模足够大、值得赞助、发帖或深入研究的几个社区。
  • 保证社区清单的品牌安全: 在把社区清单交给客户或放进产品展示之前,删掉所有 is_nsfw 为 true 的记录。
  • 为成员和管理员导出提供入口: 把入选社区的 url 传给 X Community Members 或 X Community Moderators,从社区清单进一步拿到社区里的人。

X Communities Search API 使用建议

  • 同一个话题可以换几种说法搜索,例如 bitcoin 和 btc,再按 id 合并结果,因为一个社区可能同时匹配多个关键词。
  • 想跟踪社区的增长,就定期重复同一个 query,并在每个 id 下保存 metrics.members_count 和 collected_at。

除了 X Communities Search API,需要其他类型的 X 公开数据时,可以使用以下 API。

  • Twitter Search API — 按搜索表达式查找公开帖子,并支持 latest 或 top 排序和结果数量上限。
  • X Trends API — 按已知数字 WOEID 采集当前 X 公开趋势快照,保留来源排名、查询、描述和位置背景。
  • Twitter User Search API — 按关键词查找 X 公开账号。
  • X Community API — 通过社区链接读取主题说明、成员数量、规则和加入政策。
  • X Community Posts API — 读取社区里的公开帖子,获取正文、作者和互动计数。
  • X Community Members API — 把社区成员导出为完整的主页资料,含简介和粉丝数。

探索其他平台

还可以将 X 数据与其他已支持社交平台的公开数据结合使用。

X Communities Search API — 常见问题

X Communities Search API 是一个用于按关键词查找 X 社区的 API。它返回每个社区的 id、url、名称、横幅图、成员数和敏感内容标记。

把关键词放进 query,例如 bitcoin。匹配的社区会带着名称、链接和成员数返回,可以直接在 X 上打开,也可以交给其他社区接口继续查询。

可以,在你自己的代码里处理。每条结果都有 metrics.members_count,先拿到匹配结果,再排序或设定最低规模即可。

最多 500 个。results_limit 取 10 到 500 之间 10 的倍数,默认 20;结果用 next_cursor 逐页读取。

社区被 X 标记为含有敏感内容时为 true,否则为 false。

没有。搜索结果列出名称、横幅图、成员数和敏感标记;需要简介、规则和加入政策时,把 url 传给 X Community API。

说明没有社区与它匹配。任务仍然成功,返回空结果,不扣积分。