Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ出力はありません。フォームを送信してコンテンツを生成してください。
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
user-by-rest-id otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql の完全ガイド
ApiPassの統合GraphQLエンドポイントを通じて、数値ユーザーIDを使用し、Twitterユーザープロフィールの完全なデータを即座に取得できます。
ApiPassのTwitter Graphql User By Rest ID APIは、数値のuserId（rest_idとも呼ばれます）を送信することで、包括的なTwitterユーザー情報を取得できる強力なエンドポイントです。スクリーンネームに基づく検索とは異なり、このエンドポイントは安定した数値識別子を使用してTwitterのGraphQLバックエンドに直接クエリします。この識別子は、ユーザーがハンドル名を変更しても変わりません。model twitter/graphql/user-by-rest-idを指定して/api/v1/jobs/createTaskへシンプルなPOSTリクエストを送信するとタスクIDを受け取り、その後/api/v1/jobs/recordInfoエンドポイントを通じて、表示名、スクリーンネーム、アバター、バナー、フォロワー数/フォロー数、認証ステータス、プロフェッショナルアカウント情報、ハイライトラベルなどを含む完全なプロフィール詳細を取得できます。ApiPassが認証、ルーティング、プロバイダー選択を自動的に処理するため、Twitterの複雑な内部APIに悩まされることなく、開発に集中できます。
変更される可能性のあるスクリーンネームではなく、永続的なrest_id（例：Elon Muskの44196397）でユーザーをクエリできるため、ユーザーがハンドル名を変更しても連携が壊れることはありません。
Twitterの複雑なOAuth 2.0フローを単一のBearer YOUR_API_KEYヘッダーに置き換え、新規プロジェクトの導入時の負担を大幅に軽減します。
デフォルトのautoチャネルは、リアルタイムの価格と安定性指標に基づいて、starter、regular、officialプロバイダー間でリクエストをインテリジェントに割り当て、手動設定なしでコストと信頼性のバランスを取ります。
オプションのcallBackUrlに対応したcreate-taskとquery-taskのパターンにより、高負荷時でもタイムアウトしにくい、スケーラブルでノンブロッキングなパイプラインを構築できます。
is_blue_verified、professionalデータ、highlights_info、affiliates_highlighted_label、relationship_perspectivesなど、40以上のユーザーフィールドを1回の呼び出しで取得できます。追加のエンドポイントは不要です。
officialチャネルはTwitter自身の料金に合わせた従量課金制で、高ボリュームかつ重要度の低いワークロード向けには、より低コストの階層も利用できます。
core（name、screen_name、created_at）、avatar、legacy（followers、friends、statuses、listed counts）、verification、professional、dm_permissions、highlights_info、tipjar_settingsを含む、完全なGraphQL user.result構造を返します。
withHighlightedLabel booleanを切り替えることで、affiliates_highlighted_labelブロックを含めるか除外するかを選択できます。ブランド提携や認証済みビジネスバッジを表示する際に便利です。
すべてのタスクは明確なライフサイクル状態（waiting、queuing、generating、success、fail）を進行し、各レスポンスにはcreateTime、completeTime、costTimeの指標が含まれます。
安定したrest_idで追跡される数千人のクリエイターについて、フォロワーの増加、エンゲージメントシグナル、認証ステータスを継続的に監視できます。
表示名、プロフィールリンク、プロフェッショナルカテゴリ、ビジネスラベルなど、認証済みのTwitterプロフィールデータで顧客レコードを拡充し、B2Bアウトリーチワークフローを強化できます。
アカウント年齢（created_at）、フォロワー対フォロー比率、blue認証ステータスを検証し、ボット、詐欺、なりすましの試みを検出できます。
競合アカウントの指標を時系列でスナップショットし、成長推移やコンテンツパフォーマンスのシグナルを比較する競合追跡プロダクトを構築できます。
Twitterの公式APIはユーザー検索エンドポイントへの直接アクセスを提供しますが、大規模に統合するには、OAuthの複雑さ、階層で制限された料金、限られたフィールド公開など、大きな負担が伴います。ApiPassは同じ基盤GraphQLインフラを開発者に使いやすいインターフェースでラップし、よりスマートなルーティング、より豊富なペイロード、柔軟なコスト階層を提供します。
Twitterの公式API v2 GET /2/users/:idエンドポイントでは、OAuth 2.0 Bearerトークン、アプリ登録、プロジェクト設定、階層別アクセス承認が必要です。ApiPassはこれらすべてを単一のAPIキーに置き換えます。登録してキーを生成すれば、数分以内に呼び出しを開始できます。開発者ポータルでの審査も、アプリ単位のレート制限交渉も不要です。
Twitterの公式エンドポイントでは、アクセス階層ごとに公開されるフィールドが制限されており、高ボリュームの階層は高額な月額サブスクリプションの対象になります。ApiPassは、より豊富なGraphQLレスポンス（highlights_info、affiliates_highlighted_label、professional、relationship_perspectivesを含む）を提供し、starter、regular、officialチャネルから選択できます。安定性がミッションクリティカルな場合にのみofficial料金を支払い、低い階層を使った一括検索では最大90%のコストを削減できます。
エアドロップ資格やNFTホワイトリストアクセスを付与する前に、ウォレットに紐づくTwitterアカウントをrest_idで確認し、偽装されたスクリーンネームの差し替えを回避できます。
記者やOSINTアナリストは、アーカイブされた数値IDを現在のアカウント状態に解決し、公人のプロフィール、経歴、認証ステータスが時間の経過とともにどのように変化するかを追跡できます。
広告クリックやリファラルリンクから収集したユーザーIDを完全なプロフィールスナップショットに解決し、フォロワー階層やプロフェッショナルカテゴリに基づいて、キャンペーン成果を特定のオーディエンスセグメントに関連付けられます。
ユーザーがTwitter IDを使ってサポートに問い合わせた際、即座にプロフィールを取得して本人確認を行い、is_blue_verifiedステータスを確認し、高価値アカウントに合わせた対応ができます。
ApiPassに登録し、ダッシュボードへ移動してBearer APIキーを生成します。アプリ審査プロセスもOAuth設定も待機期間もなく、登録から数分以内に呼び出しを開始できます。
modelをtwitter/graphql/user-by-rest-idに設定し、対象の数値ユーザーIDをinput.variablesオブジェクト内に含めて、createTaskエンドポイントへPOSTリクエストを送信します。必要に応じてwithHighlightedLabelフラグを切り替えてアフィリエイトバッジデータを含めることができ、タスク完了後にApiPassから自動的に結果をサーバーへプッシュしたい場合はcallBackUrlを指定できます。レスポンスには、結果の取得に使用する一意のtaskIdが返されます。
taskIdをクエリパラメータとして指定し、recordInfoエンドポイントへGETリクエストを送信します。stateフィールドがsuccessを返すまでエンドポイントをポーリングします（またはコールバックを待ちます）。その時点で、コアID、アバター、フォロワー指標、認証ステータス、プロフェッショナルアカウント詳細、ハイライトラベルを含む完全なTwitterユーザープロフィールが、ネストされたresultJsonオブジェクト内で利用可能になり、アプリケーションに解析・統合できる状態になります。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
ユーザーのツイートを取得するタスクを作成します
このAPIは、次の構造のJSONペイロードを受け付けます:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 // Input parameters
7 }
8}model必要string生成に使用するモデル名
"twitter/simple/user-tweets"
callBackUrlオプションstringタスク完了通知用のコールバックURL。省略した場合、コールバックは送信されません。
"https://your-domain.com/api/callback"
channelオプションstringchannel パラメータを使用して、APIPASS 内の対応するプロバイダーを指定できます。これらのプロバイダーは、実際の画像および動画生成タスクを処理します。APIPASS は現在、次の3つのプロバイダーオプションを提供しています:
channel パラメータのデフォルト値は auto です。有効にすると、APIPASS はリアルタイムの価格と安定性指標に基づいて、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトの auto 値を維持してください。
利用可能なオプション：
auto
input オブジェクトには次のパラメータが含まれます:
input.user_id必要stringユーザーID
最良の結果を得るには、被写体、スタイル、ライティング、構図を記述してください
44196397
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/simple/user-tweets",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "user_id": "44196397"
9 }
10 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}codeステータスコード。200 は成功、その他は失敗を示します
messageレスポンスメッセージ。失敗時はエラー内容を示します
data.taskIdタスクのステータスと結果を照会するためのタスクID
