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
搜索关键词,分页读取匹配的社区。
- 向 /v1/x/search-communities 发送 {"query": "bitcoin", "results_limit": 20}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 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。
相关 API
除了 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 — 把社区成员导出为完整的主页资料,含简介和粉丝数。
- Twitter Tweet Scraper API
- Twitter Profile Scraper API
- Twitter User Tweets Scraper API
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- Twitter Mentions API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Moderators API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API