Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ出力はありません。フォームを送信してコンテンツを生成してください。
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
tweet-detail otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql の完全ガイド
単一のツイート ID を使用して、コンテンツ、エンゲージメント指標、返信、会話コンテキストを含む完全なツイート詳細を取得します。
ApiPass の Twitter Graphql Tweet Detail API は、開発者が一意のツイート ID を使用して、X（旧 Twitter）上の任意の公開ツイートに関する包括的な情報を取得できる強力なエンドポイントです。ApiPass の統合ジョブシステムを通じて twitter/graphql/tweet-detail モデルを呼び出すことで、ツイート本文、投稿者情報、メディア添付、エンゲージメント統計（いいね、リツイート、返信、表示回数）、会話スレッド、引用ツイート、コミュニティノート（Birdwatch）、リッチな記事コンテンツを含む構造化 JSON データを受け取れます。この API は Twitter の内部 GraphQL スキーマを活用しており、従来の REST エンドポイントで利用できるものよりはるかに豊富なデータフィールドにアクセスできます。同時に、認証の複雑さ、プロキシ管理、レート制限処理を抽象化します。
Twitter 公式 API ティアの長い承認プロセスを省略できます。ApiPass API キーだけですぐに開始できます。
1 回のリクエストで、Birdwatch ノート、音声ツイート、コミュニティコンテキスト、記事のリッチコンテンツ、完全な会話スレッドなど、Graphql レベルのフィールドにアクセスできます。
デフォルトの channel: auto 設定では、リアルタイムの価格と安定性指標に基づいてプロバイダー間でタスクを自動的に割り当て、コスト効率と信頼性の両方を確保します。
プロジェクト固有のニーズに応じて予算とパフォーマンスのバランスを取るために、starter、regular、official の各ティアから選択できます。
ジョブを送信すると即座にタスク ID を受け取り、結果をポーリングするか、ApiPass から完了データを webhook URL にプッシュさせることができます。
withCommunity、withBirdwatchNotes、withVoice、withArticlePlainText などの boolean フラグを使用してレスポンスペイロードを細かく調整し、必要なデータだけを取得できます。
対象ツイートだけでなく、その完全な返信ツリー、引用ツイート、親スレッドも取得できます。会話ビューアや感情分析ツールの構築に最適です。
埋め込み画像、動画、音声メモ、長文記事コンテンツを抽出できます。リッチコンテンツの状態やプレーンテキスト抽出に対応した専用トグルを利用できます。
ツイートに紐づく文脈付きのファクトチェックやコミュニティ投稿ノートを取得し、アプリケーションに信頼性シグナルを組み込めます。
ブログ、ニュースサイト、チャットアプリケーション向けに、カスタムのツイートプレビューウィジェットや埋め込みカードを提供できます。
返信チェーンをマッピングし、議論内の主要なインフルエンサーを特定し、エンゲージメントの流れを可視化するツールを構築できます。
ジャーナリズム、研究、法的文書化のために、重要なツイートとその完全な返信コンテキストを永続的かつ検索可能なアーカイブとして作成できます。
エンゲージメント指標を含む構造化されたツイートデータを、LLM のファインチューニングワークフローや感情分類モデルに投入できます。
アクセス障壁、価格、データの深さの観点から ApiPass が Twitter 公式 API とどのように比較されるか、そして開発者が移行している理由をご覧ください。
Twitter の公式 v2 API には、有料の開発者サブスクリプション、厳格な月間ツイート上限、アプリケーション審査プロセスが必要です。ApiPass は API キーのみで利用でき、成功したタスクごとに課金され、予算重視のプロジェクト向けに超低コストティアの starter チャネルも提供します。
公式の GET /2/tweets/:id エンドポイントは、選択された expansions を含むフラットなオブジェクトを返します。ApiPass の GraphQL エンドポイントは Twitter 自身の内部データ構造を反映しており、Birdwatch ノート、コミュニティコンテキスト、V2 タイムラインモジュール、クイックプロモート適格性フラグなど、公開 REST API では利用できないネストされたフィールドを公開します。
ブランドや業界に言及する影響力の大きいツイートを追跡し、完全な会話スレッドを取得して、世論の感情をリアルタイムで把握できます。
調査報道の記者は、完全な返信コンテキスト、コミュニティノート、メタデータを含むツイートを取得し、情報源の検証や引用に利用できます。
マーケティングプラットフォームは、スポンサー付きツイートが公開されていることを検証し、時間経過に伴うエンゲージメントの成長を測定し、コミュニティノートの状態を確認できます。
完全な会話階層を抽出することで、バイラルな Twitter スレッドを構造化された記事や学習教材に変換するプラットフォームを構築できます。
ApiPass にサインアップし、ダッシュボードに移動して、認証用の Bearer token を生成します。この単一のキーで、別途 Twitter Developer アカウントを必要とせず、すべての ApiPass エンドポイントにアクセスできます。
model を twitter/graphql/tweet-detail に設定し、input.variables オブジェクト内に対象の focalTweetId を指定して、/api/v1/jobs/createTask に POST リクエストを送信します。withCommunity、withBirdwatchNotes、withVoice などのトグルを有効にすることでレスポンスをさらにカスタマイズでき、必要に応じて callBackUrl を指定して webhook 経由で結果を受け取ることもできます。API は追跡用の taskId を即座に返します。
返された taskId を使用して /api/v1/jobs/recordInfo をクエリします。エンドポイントをポーリングするか、コールバックが実行されるのを待ちます。state フィールドが success を返したら、resultJson.resultObject を解析して、コンテンツ、エンゲージメント指標、返信、会話コンテキストを含む完全なツイート詳細ペイロードにアクセスします。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
ツイートの詳細を取得
この API は、以下の構造の JSON ペイロードを受け付けます:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "focalTweetId": "string",
8 "referrer": "string",
9 "controller_data": "string",
10 "with_rux_injections": "boolean",
11 "includePromotedContent": "boolean",
12 "withCommunity": "boolean",
13 "withQuickPromoteEligibilityTweetFields": "boolean",
14 "withBirdwatchNotes": "boolean",
15 "withVoice": "boolean",
16 "withV2Timeline": "boolean",
17 },
18 "fieldToggles": {
19 "withArticleRichContentState": "boolean",
20 "withArticlePlainText": "boolean",
21 },
22 }
23}model必要string使用するモデル名
"twitter/graphql/tweet-detail"
callBackUrlオプションstringタスク完了通知用のコールバック URL。省略した場合、コールバックは送信されません。
"https://your-domain.com/api/callback"
channelオプションstringchannel パラメータを使用して、APIPASS 内の対応するプロバイダーを指定できます。これらのプロバイダーは、実際の画像および動画生成タスクを処理します。APIPASS は現在、3 つのプロバイダーオプションを提供しています:
channel パラメータのデフォルト値は auto です。有効にすると、APIPASS はリアルタイムの価格と安定性指標に基づいて、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。独自のルーティング要件がない限り、デフォルト値の auto のままにしてください。
利用可能なオプション：
auto
入力オブジェクトには以下のパラメータが含まれます:
input.variables.focalTweetId必要string1694634492403843248
input.variables.referrerオプションstringprofile
input.variables.controller_dataオプションstringDAACDAABDAABCgABAAAAAAAAAAAKAAkAAAABFPY0+AAAAAA=
input.variables.with_rux_injectionsオプションbooleanfalse
input.variables.includePromotedContentオプションbooleanfalse
input.variables.withCommunityオプションbooleantrue
input.variables.withQuickPromoteEligibilityTweetFieldsオプションbooleantrue
input.variables.withBirdwatchNotesオプションbooleantrue
input.variables.withVoiceオプションbooleantrue
input.withV2Timeline.withVoiceオプションbooleantrue
input.fieldToggles.withArticleRichContentStateオプションbooleantrue
input.fieldToggles.withArticlePlainTextオプションbooleantrue
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/user-by-screen-name",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "focalTweetId": "1694634492403843248",
10 "referrer": "profile",
11 "controller_data": "DAACDAABDAABCgABAAAAAAAAAAAKAAkAAAABFPY0+AAAAAA=",
12 "with_rux_injections": false,
13 "includePromotedContent": false,
14 "withCommunity": true,
15 "withQuickPromoteEligibilityTweetFields": true,
16 "withBirdwatchNotes": true,
17 "withVoice": true,
18 "withV2Timeline": true,
19 },
20 "fieldToggles": {
21 "withArticleRichContentState": true,
22 "withArticlePlainText": true,
23 }
24 }
25 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}codeステータスコード。200 は成功、その他は失敗
messageレスポンスメッセージ。失敗時はエラーの説明
data.taskIdタスクのステータスと結果を照会するためのタスク ID
