Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ出力はありません。フォームを送信してコンテンツを生成してください。
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
user-by-screen-name otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql の完全ガイド
単一の screen_name を渡すだけで、X（Twitter）の完全なユーザープロフィールデータを即座に取得できます。OAuth も、レート制限の悩みも、手動の GraphQL 署名も不要です。
ApiPass の Twitter Graphql User By Screen Name API は、X 内部の UserByScreenName GraphQL オペレーションを、クリーンな非同期 REST インターフェースとして提供するマネージドエンドポイントです。guest tokens、query IDs、feature flags、頻繁に変わる GraphQL hashes を扱う代わりに、screen_name（例: elonmusk）を model twitter/graphql/user-by-screen-name とともに /api/v1/jobs/createTask へ POST するだけで、ApiPass が taskId を返します。その taskId は /api/v1/jobs/recordInfo でポーリングでき、または callBackUrl 経由で自動受信できます。レスポンスには、rest_id、表示名、自己紹介、フォロワー数/フォロー数、認証ステータス、プロフィール画像とバナー画像、作成日、所在地、固定ツイート、ハイライトラベル、セーフティモード関連フィールドを含む完全なユーザーオブジェクトが含まれます。内部では、ApiPass の channel: auto ルーターが各リクエストを starter、regular、official の各プロバイダーへリアルタイムに分散し、コスト、安定性、速度のバランスを最適化します。そのため、/graphql/.../UserByScreenName パスを直接扱うことなく、本番運用レベルの Twitter ユーザーデータを取得できます。
X の開発者ポータル手続きをすべて省略できます。必要なのは Authorization: Bearer YOUR_API_KEY ヘッダー 1 つだけです。アプリ審査、consumer keys、access tokens は不要です。
X の従量課金モデルでは、ユーザープロフィール検索は 1 件あたり約 $0.010 かかります。また、無料枠は新規開発者には提供されておらず、既存ユーザーも従量課金へ移行されています。ApiPass のマルチプロバイダールーティングは、最も安価で安定したチャネルへ自動的に割り当てます。
デフォルトの channel: auto により、APIPASS はライブの価格情報と安定性指標に基づいて、各タスクを starter、regular、official の各プロバイダーへ割り当てます。手動調整なしで、価格と信頼性の最適なバランスを得られます。
デフォルトでは id/name/username のみを返し、追加フィールドや expansions を列挙する必要がある X API v2（X API v2 版はデフォルトで user id、name、username フィールドのみを返し、追加フィールドをリクエストするには fields および expansions パラメータを使用する必要があります）とは異なり、この GraphQL エンドポイントは、豊富な完全ユーザーオブジェクトを 1 回の呼び出しで返します。
ファイアアンドフォーゲット形式のタスクは taskId を即座に返します。callBackUrl を指定すると、結果の準備ができた瞬間に ApiPass がサーバーへプッシュします。サーバーレスやキューベースのアーキテクチャに最適です。
自前のコードで 15 分のローリングウィンドウを管理する必要も、guest-token の更新ロジックも、GraphQL query-hash の変更追随も不要です。ApiPass が上流の複雑さをすべて吸収するため、アプリケーションをシンプルに保てます。
screen_name: "elonmusk" を渡すだけで、完全なユーザーオブジェクトを受け取れます。これには、ほぼすべての他の Twitter GraphQL エンドポイント（UserTweets、Followers、Following、UserMedia など）で必要となる正規の数値ユーザー ID である rest_id も含まれます。
input.variables オブジェクト内で withSafetyModeUserFields と withHighlightedLabel を直接切り替えることで、レスポンスに表示される拡張プロフィールフィールド（セーフティモードのメタデータ、ハイライトされたクリエイターラベル）を制御できます。
すべてのリクエストは、/api/v1/jobs/recordInfo で照会可能な一貫した waiting → queuing → generating → success / fail のステートマシンを通過します。createTime、completeTime、costTime、resultJson は予測可能なスキーマで返されます。
任意の @handle を、下流のパイプラインで必要となる安定した数値 rest_id に変換します。
フォロワー数、認証バッジ、自己紹介のキーワード、アカウント年齢、ハイライトラベルを取得し、プロフィールを大規模にスコアリング・ランキングできます。
サインアップ、キャンペーン、KOL パートナーシップの承認前に、送信された Twitter ハンドルが存在し、アクティブで、保護されておらず、想定されるメタデータと一致することを自動的に検証します。
Twitter ハンドルを含む任意の連絡先レコードに、プロフィール画像、所在地、Web サイト URL、フォロワー数、作成日をミリ秒単位で付加できます。
X の公式 API は、開発者承認、段階制料金、少ないデフォルトフィールドによってユーザー検索を制限しています。一方 ApiPass は、シンプルな 1 回の自動ルーティング・タスク単位課金の呼び出しで、完全な GraphQL プロフィールオブジェクトを提供します。
公式の GET /2/users/by/username/:username エンドポイントでは、query params でフィールドを手動展開する必要があり、デフォルトでは id、name、username のみが返されます。追加フィールドには fields と expansions パラメータが必要です。ApiPass の GraphQL ラッパーは、ネイティブの完全なユーザーオブジェクト（固定ツイート、プロフェッショナルアカウント情報、認証タイプ、ハイライトラベルを含む）を、fields= の列挙なしで 1 回の呼び出しで返します。
X はアクセスを利用量ベースのモデルに統合しており、投稿の作成は約 0.010、投稿の読み取りは約 0.005、ユーザープロフィール検索と DM 読み取りはそれぞれ約 $0.010 かかり、さらに月間上限が重なります。ApiPass は成功したタスクに対してのみ課金し、デフォルトで最も低コストかつ安定したプロバイダーへルーティングし、開発者ポータルでの申請ステップも不要です。
ツイートのストリームに含まれるすべてのメンションハンドルを完全なプロフィールへ解決し、アナリストがフォロワー規模、認証ステータス、アカウント年齢でフィルタリングできるようにします。
トークン、NFT、ホワイトリスト枠を発行する前に、ウォレットに紐づいた Twitter ハンドルが実在し、十分に古く、フォロワー数のしきい値を満たしていることを確認します。
調査対象の任意の公開アカウントについて、信頼できるメタデータ（作成日、所在地、プロフィール履歴のシグナル、ハイライトラベル）をすばやく取得できます。
候補者の Twitter ハンドルに自己紹介、Web サイト URL、フォロワー数を付加し、開発者アドボケイト、デザイナー、クリエイターへのアプローチに活用できます。
ApiPass にサインアップし、ダッシュボードから YOUR_API_KEY を取得します。開発者ポータルでの申請、OAuth 設定、アプリ審査は不要です。単一の bearer token でプラットフォーム上のすべてのモデルを利用できます。
model を twitter/graphql/user-by-screen-name に設定し、対象ハンドルを input.variables.screen_name（例: elonmusk）内に指定して、https://api.apipass.dev/api/v1/jobs/createTask へ POST リクエストを送信します。必要に応じて withSafetyModeUserFields と withHighlightedLabel を含めてレスポンスを拡張し、ApiPass からサーバーへ結果を自動プッシュしたい場合は callBackUrl を渡します。API は task_12345678 のような taskId を即座に返します。
ApiPass が完了済みペイロードを callBackUrl へ POST するのを待つか、bearer token を使って https://api.apipass.dev/api/v1/jobs/recordInfo?taskId=task_12345678 をポーリングします。data.state が success になると、rest_id、自己紹介、フォロワー数とフォロー数、認証ステータス、プロフィール画像、作成日、リクエストした任意フィールドを含む完全なユーザープロフィールが data.resultJson.resultObject 内で利用可能になります。これで、Twitter GraphQL ユーザーデータを本番環境で取得できるようになります。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
screen_name でユーザー情報を取得します
この API は、以下の構造の JSON ペイロードを受け付けます:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "screen_name": "string",
8 "withSafetyModeUserFields": "boolean",
9 "withHighlightedLabel": "boolean",
10 }
11 }
12}model必要string生成に使用するモデル名
"twitter/graphql/user-by-screen-name"
callBackUrlオプションstringタスク完了通知用のコールバック URL。省略した場合、コールバックは送信されません。
"https://your-domain.com/api/callback"
channelオプションstringchannel パラメータを使用して、APIPASS 内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASS は現在、3 つのプロバイダーオプションを提供しています:
channel パラメータのデフォルト値は auto です。有効にすると、APIPASS はリアルタイムの料金と安定性指標に基づき、利用可能なプロバイダー間でタスクを自動的に割り当て、低コストと信頼性の高いパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトの auto 値を使用してください。
利用可能なオプション：
auto
input オブジェクトには以下のパラメータが含まれます:
input.variables.screen_name必要stringelonmusk
input.variables.withSafetyModeUserFieldsオプションbooleantrue
input.variables.withHighlightedLabelオプション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 "screen_name": "elonmusk",
10 "withSafetyModeUserFields": true,
11 "withHighlightedLabel": true
12 }
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}codeステータスコード。200 は成功、その他は失敗を示します
messageレスポンスメッセージ。失敗時はエラーの説明が含まれます
data.taskIdタスクのステータスと結果を照会するためのタスク ID
