Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有输出。提交表单以生成内容。
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
communities-fetch-one-query otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql 使用完整指南
使用 ApiPass 的异步、基于任务的 GraphQL 端点，通过 community ID 检索任意单个 X (Twitter) Community 的完整元数据。
ApiPass 上的 Twitter Graphql Communities Fetch One Query API 是对 X 内部 CommunitiesFetchOneQuery GraphQL 操作的封装，让你仅通过 communityId 即可获取特定 X Community 的完整资料——包括名称、描述、成员数量、版主、规则、横幅、加入策略和可见性。由于底层 Twitter GraphQL 操作会使用 communityId 和 withDmMuting 等变量调用，ApiPass 通过简洁、统一的任务式接口暴露完全相同的参数。你只需向 /api/v1/jobs/createTask 提交一个任务，model 设置为 twitter/graphql/communities-fetch-one-query，获取 taskId，然后轮询 /api/v1/jobs/recordInfo（或接收回调）即可获得完整填充的 community 对象——无需 OAuth 流程，无需处理速率限制，也无需自行逆向 X 的私有 GraphQL schema。
跳过 Twitter 的应用审核、企业级定价层级和 access-token 轮换——只需使用一个 ApiPass Bearer key 进行身份验证，即可立即开始获取 community 数据。
不同于官方 v2 REST API（不暴露完整的 Community 对象），ApiPass 复刻 x.com 自身使用的同一 CommunitiesFetchOneQuery 操作，让你获得 Web 应用可见的每一个字段。
发起任务后，可选择轮询结果或提供 callBackUrl——非常适合 serverless 函数、队列驱动的流水线以及高吞吐批量数据补全。
当 channel 设置为 auto 时，ApiPass 会根据实时价格和稳定性，在 starter、regular 和 official providers 之间自动分发你的请求，避免你支付过高成本或遇到容易中断的上游服务。
结果会以结构化的 resultJson 字符串返回，可直接解析并加载到数据库中——无需 HTML 抓取、无需无头浏览器、无需管理 cookie。
无论你是为查询工具获取一个 community，还是为研究数据集补全数万个 community，ApiPass 的按次调用定价都比维护抓取集群或签订 X Enterprise 合同更具成本优势。
传入任意有效的 communityId（例如 1517189118140325888），即可在一次往返中获得该 community 的完整 GraphQL 结构记录。
切换 withDmMuting boolean，用于控制响应中是否包含查询账号与 community 管理员之间的私信静音关系——这与 Twitter 原生 CommunitiesFetchOneQuery 操作使用的标志相同，该操作接受 communityId 和 withDmMuting 变量。
每个 job 都会经过明确的 waiting → queuing → generating → success / fail 状态，因此你的应用始终能准确了解请求所处阶段并做出相应处理。
构建可展示任意 X Community 封面图、描述、成员数量和版主列表的工具，用户只需粘贴 community 即可查看——非常适合 community 浏览器、目录网站，或嵌入聊天应用的“预览卡片”组件。
持续记录 community 的成员数量、规则和管理员名单，用于呈现增长趋势、里程碑提醒和版务变化——非常适合服务 community 运营者和社交媒体策略师的分析平台。
将此端点与 community-members 或 community-tweets 端点结合，可支持营销人员已在使用的潜客生成、竞争分析和受众研究工作流——把任意 community ID 转化为丰富的潜在客户信号。
定期重新获取 community 元数据，以检测政策变化、所有权转移或可见性切换（public ↔ closed）——帮助信任与安全团队、品牌安全供应商和 community 审计人员提前识别风险。
下面从数据覆盖范围和开发者体验两个方面，比较 ApiPass 的 Communities Fetch One Query 端点与 X 官方开发者平台实际可用能力的差异。
X 官方 API v2 并未提供可通过 ID 检索完整 Community 元数据的一等端点——Communities 在很大程度上仍是由内部 GraphQL 操作驱动的 x.com 应用功能。ApiPass 通过暴露 X Web 客户端使用的同一个 CommunitiesFetchOneQuery 操作来弥补这一缺口，因此你获得的是与 UI 中实际渲染内容一致的数据，而不是精简后的公开子集。
官方 API 需要付费的 X Developer 层级、应用审核、OAuth 2.0 用户上下文以及严格的按应用速率限制。ApiPass 用一个 Bearer token、异步任务队列和可在多个 providers 之间平衡成本与可靠性的 auto channel 路由取代了这一切——这意味着你可以在几分钟内从零进入生产，而不是花费数周时间。
解析 tweet 或链接中提到的任意 community ID，为你的监测信息流补充真实的 community 上下文（名称、规模、主题）。
当潜在客户在个人资料或你的 onboarding 表单中填写 X Community 时，将其补全到 CRM 中，包含描述、成员数量和管理员 handle。
构建可复现的 Community 元数据数据集，用于研究线上群体动态、主题聚类或平台治理。
跟踪与信任与安全调查或广告适配性评分相关的 communities 的成员政策、规则和管理员构成。
向 https://api.apipass.dev/api/v1/jobs/createTask 发送 POST 请求，并在 Authorization header 中携带你的 Bearer token。在 JSON body 中，将 model 设置为 twitter/graphql/communities-fetch-one-query，并包含一个 input 对象，其中包含目标 communityId（以及可选的 withDmMuting boolean）。如果希望自动接收结果，请添加指向你的 webhook 端点的 callBackUrl。
create-task 响应会返回 data.taskId 值（例如 task_12345678）。请保存此 ID，以便在下一步查询任务状态和结果——如果你提供了 callBackUrl，也可以直接等待回调触发。
向 https://api.apipass.dev/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID 发送 GET 请求，并携带你的 Bearer token。关注 state 字段从 waiting → queuing → generating 的变化；当其达到 success 时，解析 resultJson 字段即可获得完整的 community 对象——可直接持久化、展示或转发到下游。如果 state 返回 fail，请查看随附的失败详情以诊断并重试。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
获取单个社区查询
该 API 接受具有以下结构的 JSON 负载：
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "communityId":"string",
8 "withDmMuting": "boolean"
9 }
10 }
11}model必填string用于生成的模型名称
"twitter/graphql/communities-fetch-one-query"
callBackUrl可选string任务完成通知的回调 URL。如果省略，则不会发送回调。
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 内对应的提供商；这些提供商负责实际的图像和视频生成任务。APIPASS 目前提供三种提供商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用提供商之间自动分配任务，以平衡最低成本与可靠性能。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
input 对象包含以下参数：
input.communityId必填stringcommunityId
1517189118140325888
input.withDmMuting可选booleanwithDmMuting
false
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "twitter/graphql/communities-fetch-one-query",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "communityId": "1517189118140325888",
9 "withDmMuting": false
10 }
11 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}code状态码，200 表示成功，其他表示失败
message响应消息，失败时为错误描述
data.taskId任务 ID，用于查询任务状态和结果
