Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ出力はありません。フォームを送信してコンテンツを生成してください。
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
retweeters otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql の完全ガイド
1回のAPIコールで、任意の公開ツイートをリツイートしたユーザーの完全なリストを取得できます。
ApiPass の Twitter Graphql Retweeters API は、X（旧Twitter）上の特定のツイートをリツイートしたユーザー一覧を、開発者がプログラムから取得できるマネージドエンドポイントです。tweetId に加えて任意のページネーションおよびフィルタリングパラメータを送信すると、リツイートしたアカウントの構造化データセットを受け取れます。エンゲージメント分析、オーディエンス調査、コンテンツ拡散の追跡に最適です。非同期タスクモデルを採用しており、API がバックグラウンドで重い処理を実行します。model twitter/graphql/retweeters を指定して POST /api/v1/jobs/createTask でタスクを作成し、その後ポーリングするかコールバックを受け取って /api/v1/jobs/recordInfo 経由で結果を取得します。これにより、アプリケーションをレート制限や長時間実行されるリクエストから切り離し、大規模なリツイートユーザーデータの収集をシンプルかつ信頼性高く行えます。
Twitter 開発者アカウント、OAuth フロー、ローテーション用の認証情報を管理する必要はありません。単一の ApiPass Bearer API key ですべてのエンドポイントを利用できます。
デフォルトの channel: auto 設定では、リアルタイムの価格と安定性指標に基づいて、利用可能なプロバイダー間で各タスクを割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。
タスクを送信すると、taskId を即座に受け取れます。システムがバックグラウンドで取得処理を行うため、アプリが遅い上流レスポンスを待ってブロックされることはありません。
callBackUrl を指定すると、タスク完了と同時に ApiPass が結果をサーバーへプッシュします。ポーリングは不要です。
予算とSLA要件に合わせて、starter（超低コスト）、regular（標準、公式価格を大きく下回る）、official（ネイティブ Twitter API の安定性と速度）から選択できます。
結果は明確なタスクライフサイクル状態（waiting, queuing, generating, success, fail）を持つクリーンな JSON エンベロープ（code, message, data.resultJson）で返されるため、簡単に統合できます。
任意の公開 tweetId（例: 1694634492403843248）を渡すことで、その投稿に対するリツイートユーザー一覧を取得できます。
count パラメータ（デフォルト 20）を使用して、タスクごとに返されるリツイートユーザー記録数を制御し、速度または網羅性に合わせて最適化できます。
includePromotedContent（boolean）を切り替えることで、レスポンスにプロモート/広告関連エントリを含めるか除外し、オーガニックなエンゲージメントデータをクリーンに保てます。
特定の投稿を拡散するリーチの大きいアカウントを特定し、アプローチ候補として抽出できます。特定の投稿を拡散するリーチの大きいアカウントを特定し、アプローチ候補として抽出できます。
自社または競合のコンテンツを誰が拡散しているかを時系列で可視化できます。
リツイートユーザー一覧を CRM や ML システムに取り込み、類似オーディエンスを構築してターゲティングを改善できます。
注目している特定のツイートを重要なアカウントがリツイートしたときに、アラートや後続ワークフローをトリガーできます。
Twitter Official API はリツイートユーザーデータへ直接アクセスできますが、厳格な開発者承認、ティア別の利用上限、利用量に応じて急速に増大する固定価格といった大きな障壁があります。ApiPass は、よりシンプルな統合モデル、柔軟なプロバイダールーティング、そして大幅に低いコストで同じデータを提供する、効率的な代替手段です。
Twitter Official API では、承認済みの開発者アカウントが必要であり、リツイート検索エンドポイントにはティアごとの厳しい月間投稿上限とレート制限が適用されます。ApiPass はこれらすべてを抽象化します。API key でリクエストを送信し、実行したタスク分だけ支払うだけです。
Twitter Official API が単一の固定価格モデルを提供する一方で、ApiPass は starter、regular、official チャネル間でタスクを自動的にルーティングし、同じリツイートユーザーデータをわずかなコストで提供します。ネイティブサービスと同等性が必要な場合には、official も常に利用できます。
ブランドツイートの拡散を促進したインフルエンサーやコミュニティを測定できます。
競合の告知を誰がリツイートしているかを追跡し、支持者ネットワークを把握できます。
バイラル化した投稿やセンシティブな投稿の拡散者を素早く列挙し、対応戦略に活用できます。
情報拡散、誤情報、ネットワーク分析に関する研究向けに、構造化されたリツイート伝播データを収集できます。
ApiPass に登録し、ダッシュボードから Bearer token を生成します。この単一の key ですべてのエンドポイントを利用でき、Twitter 開発者アカウントや OAuth 設定は不要です。
model を twitter/graphql/retweeters に設定し、対象の tweetId と、count や includePromotedContent などの任意パラメータを含めて、POST リクエストを /api/v1/jobs/createTask に送信します。結果を自動で受け取るために callBackUrl を含めることもできます。API は進行状況の追跡に使える taskId を即座に返します。
ApiPass が callBackUrl に結果をプッシュするのを待つか、state フィールドが success になるまで GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID をポーリングします。完全なリツイートユーザー一覧は data.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 "tweetId": "string",
8 "count": "number",
9 "includePromotedContent": "boolean",
10 }
11 }
12}model必要string生成に使用するモデル名
"twitter/graphql/retweeters"
callBackUrlオプションstringタスク完了通知用のコールバック URL。省略した場合、コールバックは送信されません。
"https://your-domain.com/api/callback"
channelオプションstringchannel パラメータを使用して、APIPASS 内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASS は現在、3 つのプロバイダーオプションを提供しています:
channel パラメータのデフォルト値は auto です。有効な場合、APIPASS はリアルタイムの価格と安定性指標に基づいて、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルト値 auto のままにしてください。
利用可能なオプション：
auto
input オブジェクトには以下のパラメータが含まれます:
input.variables.tweetId必要string1694634492403843248
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/user-by-screen-name",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "tweetId": "1694634492403843248",
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
