Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ出力はありません。フォームを送信してコンテンツを生成してください。
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
list-latest-tweets-timeline otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql の完全ガイド
任意の公開 Twitter リストから最新ツイートのタイムラインを、GraphQL を活用した 1 回の API 呼び出しで取得できます。
ApiPass の Twitter Graphql List Latest Tweets Timeline API は、固有の listId で識別される特定の Twitter (X) リストのメンバーが投稿した最新ツイートを、開発者が取得できるマネージドエンドポイントです。Twitter の内部 GraphQL インフラストラクチャ上に構築され、ApiPass の統合 createTask / recordInfo タスクパイプラインを通じて公開されており、この API はツイートオブジェクト、投稿者メタデータ、エンゲージメント指標、メディア添付を含む構造化 JSON タイムラインを返します。Twitter の認証フロー、レート制限、未公開の GraphQL パラメータを直接扱う代わりに、対象の listId、任意の count、includePromotedContent フラグを指定してタスクを送信するだけで、タイムラインデータの準備が完了した時点でポーリングまたは webhook コールバックにより受け取れます。
Twitter の長い申請レビュー、プロジェクト承認、Elevated アクセスのゲートをスキップできます。単一の ApiPass API キーで認証し、すぐにリストタイムラインの取得を開始できます。
このエンドポイントは、タスクを作成してから結果を取得するパターンに従い、taskId を即座に返すため、長時間実行されるスクレイピングでアプリケーションがブロックされることはありません。結果は recordInfo のポーリング、または任意の callBackUrl webhook によって配信されます。
ApiPass は、リアルタイムの価格と安定性指標に基づいて、starter、regular、official の各プロバイダー間で各リクエストを自動的に割り当て、低コストと信頼性の高いパフォーマンスを両立します。手動のフェイルオーバーコードは不要です。
Twitter の高額な月額 Basic/Pro/Enterprise プランを回避できます。実際に実行したリストタイムラインタスクに対してのみ支払うため、プロトタイプにも本番ワークロードにも費用対効果に優れています。
レスポンスは Twitter の GraphQL スキーマと同一の、一貫した resultJson.resultObject.data.list.tweets_timeline 構造でラップされるため、カスタムの HTML/HAR パーサーを書くことなく統合できます。
すべてのタスクでライフサイクル状態 (waiting, queuing, generating, success, fail) と createTime、completeTime、costTime フィールドが公開されるため、リクエストのパフォーマンスを完全に可視化できます。
任意の count パラメータ (例: 20) を使用して、1 回の呼び出しで返されるツイート数を制御し、用途に応じて鮮度とペイロードサイズのバランスを取れます。
includePromotedContent: false に切り替えることで、スポンサー付き/プロモーションツイートを除外し、リストメンバーが投稿したオーガニック投稿のみのクリーンなストリームを受け取れます。
タスク作成時に callBackUrl を指定すると、ApiPass は完了したタイムラインをエンドポイントへ直接 POST するため、完了をポーリングする必要がなくなります。
ジャーナリストや業界専門家のリストからツイートを取得し、自社プロダクトやニュースレター内のリアルタイムニュースフィードを強化できます。
競合他社やインフルエンサーのリストを監視し、メンション、ハッシュタグ、トレンドをリアルタイムで表示できます。
Slack、Discord、Telegram の bot を構築し、プライベートなチームキュレーションリストから最新ツイートを配信して関係者へ情報共有できます。
トピック別のリストタイムラインを継続的に収集し、LLM のファインチューニング、感情分析、学術研究向けの高品質なコーパスを構築できます。
Twitter の公式リストタイムラインエンドポイントと比較して、ApiPass がアクセス、料金、統合をどのように簡素化するかをご確認ください。
Twitter の公式 GET /2/lists/:id/tweets エンドポイントでは、最初の呼び出し前に有料の Developer Portal サブスクリプション、プロジェクト作成、OAuth 2.0 設定が必要です。ApiPass はこれらすべてを単一の bearer token と、twitter/graphql/list-latest-tweets-timeline に設定した model フィールドで置き換えるため、数日ではなく数分で本番利用を開始できます。
Twitter の公式プランでは、厳しい月間投稿上限と段階的な料金体系が課され、月額数千ドル規模に膨らむ可能性があります。ApiPass はインテリジェントなプロバイダールーティング (auto channel) を備えたタスク単位の従量課金モデルを採用しているため、コストは利用量に応じて線形に増え、最低契約や予期しない超過料金はありません。
トレーダー、アナリスト、プロトコル創設者のキュレーションリストを監視し、市場を動かす可能性のあるツイートを公開直後に検出できます。トレーダー、アナリスト、プロトコル創設者のキュレーションリストを監視し、市場を動かす可能性のあるツイートを公開直後に検出できます。
顧客、パートナー、批評家のリストを追跡し、自社ブランドやプロダクトへの言及をほぼリアルタイムで把握できます。
編集リストの最新投稿を CMS、ブログのサイドバー、モバイルアプリのフィードに、手作業のコピー＆ペーストなしでミラーリングできます。
競合アカウントのリストからツイートを集約し、下流の NLP を実行して、製品ローンチ、採用告知、PR キャンペーンを追跡できます。
ApiPass にサインアップし、ダッシュボードに移動して bearer token を生成します。Twitter Developer account や OAuth ハンドシェイクは不要です。すべてのリクエストを認証するために必要な認証情報は ApiPass キーだけです。
model を twitter/graphql/list-latest-tweets-timeline に設定し、input.variables オブジェクト内に対象の listId を含めて、/api/v1/jobs/createTask に POST リクエストを送信します。返されるツイート数を制限する count、スポンサー付き投稿を除外する includePromotedContent、結果を webhook 経由で受け取りたい場合の callBackUrl などの任意パラメータも含めることができます。ApiPass はジョブ追跡に使用できる taskId を即座に返します。
ApiPass が完了したタイムラインを callBackUrl にプッシュするのを待つか、taskId を使って GET /api/v1/jobs/recordInfo をポーリングします。タスクの状態が success に遷移すると、完全なリストタイムラインが data.resultJson.resultObject.data.list.tweets_timeline 配下で利用可能になり、解析してアプリケーションへ統合できます。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
List の最新ツイートタイムラインを取得します。
この API は、次の構造の JSON ペイロードを受け付けます:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "listId": "string",
8 "count": "number",
9 "includePromotedContent": "boolean",
10 }
11 }
12}model必要string生成に使用するモデル名
"twitter/graphql/list-latest-tweets-timeline"
callBackUrlオプションstringタスク完了通知用のコールバック URL。省略した場合、コールバックは送信されません。
"https://your-domain.com/api/callback"
channelオプションstringchannel パラメータを使用して、APIPASS 内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASS は現在、3 つのプロバイダーオプションを提供しています:
channel パラメータのデフォルト値は auto です。有効にすると、APIPASS はリアルタイムの価格と安定性指標に基づき、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトの auto 値を保持してください。
利用可能なオプション：
auto
input オブジェクトには次のパラメータが含まれます:
input.variables.listId必要string44196397
input.variables.countオプションnumber20
input.variables.includePromotedContentオプションbooleanfalse
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/list-latest-tweets-timeline",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "listId": "123",
10 "count": 20,
11 "includePromotedContent": false,
12 }
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}codeステータスコード。200 は成功、その他は失敗を示します
messageレスポンスメッセージ。失敗時はエラーの説明が含まれます
data.taskIdタスクのステータスと結果を照会するためのタスク ID
