Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ出力はありません。フォームを送信してコンテンツを生成してください。
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
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 は同じパラメータをクリーンで統一されたジョブベースのインターフェースとして公開します。model に twitter/graphql/communities-fetch-one-query を指定して /api/v1/jobs/createTask にタスクを送信し、taskId を受け取ったら、/api/v1/jobs/recordInfo をポーリングする（またはコールバックを受け取る）ことで、完全に展開された community オブジェクトを取得できます。OAuth フローも、レート制限の調整も、X の非公開 GraphQL スキーマを自分でリバースエンジニアリングする必要もありません。
Twitter のアプリケーション審査、エンタープライズ料金プラン、アクセストークンのローテーションを省略できます。単一の ApiPass Bearer key で認証し、すぐに community データの取得を開始できます。
完全な Community オブジェクトを公開していない公式 v2 REST API とは異なり、ApiPass は x.com 自身が使用している CommunitiesFetchOneQuery オペレーションと同じ内容を反映し、Web アプリが参照するすべてのフィールドを提供します。
タスクを起動し、結果をポーリングするか callBackUrl を指定して受け取れます。サーバーレス関数、キュー駆動のパイプライン、大量のバッチエンリッチメントに最適です。
channel を auto に設定すると、ApiPass はリアルタイムの価格と安定性に基づき、starter、regular、official の各プロバイダーへリクエストを自動的に振り分けます。過剰な支払いを避け、障害が起きやすいアップストリームに当たるリスクも抑えられます。
結果は構造化された resultJson 文字列として返されるため、そのままパースしてデータベースに読み込めます。HTML スクレイピング、ヘッドレスブラウザ、Cookie 管理は不要です。
ルックアップツール用に 1 つの community を取得する場合でも、研究データセット用に数万件を展開する場合でも、ApiPass の従量課金はスクレイピング基盤の維持や X Enterprise 契約にかかるコストを上回る効率を実現します。
有効な communityId（例: 1517189118140325888）を渡すだけで、community の完全な GraphQL 形式のレコードを 1 回の往復で取得できます。
withDmMuting boolean を切り替えることで、問い合わせ元アカウントと community 管理者の間のダイレクトメッセージのミュート関係をレスポンスに含めるかどうかを制御できます。これは、communityId と withDmMuting 変数を受け付ける Twitter の CommunitiesFetchOneQuery オペレーションでネイティブに使用されているものと同じフラグです。
すべてのジョブは明示的な waiting → queuing → generating → success / fail 状態を通過するため、アプリケーションはリクエストの現在位置を常に正確に把握し、それに応じて対応できます。
ユーザーが貼り付けた任意の X 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、非同期ジョブキュー、複数プロバイダー間でコストと信頼性のバランスを取る auto channel routing に置き換えます。つまり、数週間ではなく数分でゼロから本番環境へ進めます。
ツイートやリンクで言及された任意の community ID を解決し、実際の community コンテキスト（名前、規模、トピック）でモニタリングフィードを強化できます。
見込み客がプロフィールやオンボーディングフォームに X Community を記載している場合、その情報を説明、メンバー数、管理者のハンドル名とともに CRM に展開できます。
オンライン上のグループダイナミクス、トピッククラスタリング、プラットフォームガバナンスを研究するために、Community メタデータの再現可能なデータセットを構築できます。
トラスト＆セーフティ調査や広告適合性スコアリングに関連する communities のメンバーシップポリシー、ルール、管理者構成を追跡できます。
Authorization ヘッダーに Bearer token を入れて、https://api.apipass.dev/api/v1/jobs/createTask に POST リクエストを送信します。JSON body では、model を twitter/graphql/communities-fetch-one-query に設定し、対象の communityId（任意で withDmMuting boolean も）を含む input オブジェクトを指定します。結果を自動的に受け取りたい場合は、Webhook エンドポイントを指す callBackUrl を追加します。
create-task のレスポンスは data.taskId 値（例: task_12345678）を返します。この ID を保存しておくと、次のステップでタスクのステータスと結果を確認できます。callBackUrl を指定している場合は、コールバックが実行されるのを待つだけでも構いません。
Bearer token を使用して、https://api.apipass.dev/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID に GET リクエストを送信します。state フィールドが waiting → queuing → generating と進むのを確認し、success に到達したら resultJson フィールドをパースして完全な community オブジェクトを取得します。そのまま保存、表示、または下流へ転送できます。state が fail を返した場合は、付随する失敗の詳細を確認して原因を診断し、再試行してください。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
communities fetch one query
この 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オプションstringchannel パラメータを使用して、APIPASS 内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASS は現在、3 つのプロバイダーオプションを提供しています:
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
