X / Twitter API
X / Twitter 搜索社群 API
按关键词搜索 X (Twitter) 社群，获取其 ID、名称、主题和成员数，支持游标分页。通过它可以找到要传给 twitter.community 或 twitter.community_tweets 的社群 URL。
POST/v1/run/twitter.search_communities
可用率
100.00%
30d · 29 次调用
请求数
29
30d · 按周，近 12 周
响应时间
0.5s
中位数 · 30d
试一试
发出你的第一个请求
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"communities": [
{
"id": "a1b2c3d4",
"memberCount": 12500,
"name": "Example title",
"nsfw": true,
"topic": "example",
"url": "https://example.com/page"
}
],
"nextCursor": "example"
},
"found": true,
"reason": "not_found"
}响应类型定义
interface TwitterSearchCommunitiesResponse {
data: {
communities: {
id: string;
memberCount: number;
name: string;
nsfw: boolean;
topic: string;
url: string;
}[];
nextCursor: string | null;
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/twitter.search_communities
curl -X POST https://api.getanyapi.com/v1/run/twitter.search_communities \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"artificial intelligence"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| query | string | "artificial intelligence"用于匹配 X (Twitter) 社群名称和主题的关键词（例如 artificial intelligence）。 |
| cursor | string | 来自上一次响应 nextCursor 的不透明分页游标。第一页请省略；传入它以获取下一页社群。 |
| 响应 | ||
| data | object | The page of matching communities, or null when nothing was found. |
| data.communities | object[] | Matching X (Twitter) communities. Search returns a summary record; pass url to twitter.community for the full detail, or to twitter.community_tweets for its posts. Populated whenever the provider has data for the entity. |
| data.communities[].id | string | Community identifier. Populated whenever the provider has data for the entity. |
| data.communities[].memberCount | integer | Number of members in the community. |
| data.communities[].name | string | Community name. Populated whenever the provider has data for the entity. |
| data.communities[].nsfw | boolean | Whether the community is flagged as not safe for work. |
| data.communities[].topic | string | The community's primary topic label (may be empty). |
| data.communities[].url | string | Canonical URL of the community on X. Pass it to twitter.community or twitter.community_tweets. Populated whenever the provider has data for the entity. |
| data.nextCursor | string | Opaque cursor for the next page of communities, or null when this lane has no more. Pass it back as cursor to continue. |
| found | boolean | True when the search returned at least one community; false when nothing matched. |
| reason | "not_found" | Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost. |
| 价格 | ||
| 每次请求价格（上限） | USD | US$0.0011 |
| 价格（/千条结果） | USD | US$0.11 |
常见问题
关于 X / Twitter 搜索社群 API
AnyAPI 的 X / Twitter 搜索社群 API 只需一次 POST 请求 /v1/run/twitter.search_communities，就以统一格式的 JSON 返回 X / Twitter 数据。按关键词搜索 X (Twitter) 社群，获取其 ID、名称、主题和成员数，支持游标分页。通过它可以找到要传给 twitter.community 或 twitter.community_tweets 的社群 URL。无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千条结果 US$0.11，单次请求最多 US$0.0011，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 X / Twitter 搜索社群 API 调用中有 100.0% 成功，响应时间中位数为 0.5 秒，共测量 29 次调用。
费用：每千条结果 US$0.11，单次请求最多 US$0.0011，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。
按关键词搜索 X (Twitter) 社群，获取其 ID、名称、主题和成员数，支持游标分页。通过它可以找到要传给 twitter.community 或 twitter.community_tweets 的社群 URL。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。
过去 30 天，通过 AnyAPI 发起的 X / Twitter 搜索社群 API 调用中有 100.0% 成功，响应时间中位数为 0.5 秒，共测量 29 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。