Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ出力はありません。フォームを送信してコンテンツを生成してください。
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
search-timeline otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql の完全ガイド
Twitter のタイムラインをプログラムから検索し、キーワード、ハッシュタグ、または高度なクエリでリアルタイムのツイート結果を取得できます。
ApiPass の Twitter Graphql Search Timeline API は、Twitter のネイティブクライアントで使われているものと同じ GraphQL スキーマを通じて、開発者が Twitter（X）の検索タイムラインをクエリできるタスクベースのエンドポイントです。model twitter/graphql/search-timeline を指定して /api/v1/jobs/createTask に POST リクエストを送信することで、生の検索クエリ（キーワード、ハッシュタグ、演算子、またはユーザーハンドル）を送信し、一致するツイート、投稿者プロフィール、メディアエンティティ、エンゲージメント指標、ページネーションカーソルを含む構造化 JSON ペイロードを受け取れます。この API は Latest など複数の結果モードをサポートし、完全な GraphQL レスポンスを返すため、OAuth、レート制限、スクレイピング基盤の管理といった複雑さなしに、Twitter 自身の検索インターフェースを支えるのと同じ深さのデータを取得できます。
時間のかかる申請、承認、昇格アクセスのプロセスを省略できます。1 つの ApiPass API キーだけで、すぐにエンドポイントを利用できます。
tweet_results、user_results、メディアバリアント、表示回数、ハイライト範囲など、Twitter のネイティブ Web クライアントが使用するものとまったく同じリッチなデータ構造を取得できます。
デフォルトの channel: auto 設定により、ApiPass はリアルタイムの価格と安定性に基づいて starter、regular、official プロバイダー間でリクエストを自動的に分散し、コストと信頼性の最適なバランスを実現します。
検索ジョブを送信し、ポーリングまたは callBackUrl 経由のコールバックで結果を受け取れるため、大規模クロール、バッチパイプライン、長時間実行されるワークロードに最適です。
cursor パラメータを使って、単一ページで返される範囲を超えた数千件の一致ツイートをたどれます。
予算に合ったプロバイダー階層を選択できます。超低コストの starter、費用対効果の高い regular、または Twitter 自身のサービスと同一料金でプレミアムな安定性を備えた official から選べます。
rawQuery パラメータは、単純なキーワード（"twitter"）から、複雑な Twitter 検索演算子、ハッシュタグ、from: フィルター、日付範囲、言語フラグまで受け付けます。
product パラメータを使って Latest などの検索プロダクトを切り替え、時系列で新しいツイートを取得できます。また、count（デフォルト 40）でページサイズを制御できます。
各エントリには、全文、メディア（画像、GIF、動画バリアント）、ユーザープロフィール詳細、タイムスタンプ、返信数・リツイート数・お気に入り数、表示回数、会話スレッド関連フィールドが含まれます。
ブランドへの言及、競合の動き、または速報ニュースのキーワードを監視し、分析ツール上に表示できます。
生のツイートストリームを NLP モデルに入力し、製品、選挙、市場イベントに関するセンチメントの変化を追跡できます。
キャッシュタグ（$BTC、$TSLA）やインフルエンサーのハンドルを監視し、関連ツイートに基づいてアラート、取引、Discord/Telegram 通知をトリガーできます。
ブログ、ライブイベントページ、ジャーナリスト向けリサーチダッシュボード用に、ハッシュタグやトピック別のツイート埋め込みを自動でキュレーションできます。
検索リクエストにおけるアクセス要件と返されるデータの深さについて、ApiPass と Twitter の公式開発者プラットフォームの違いを比較します。
Twitter の公式 v2 Search API では、1 件のリクエストを発行する前に、有料の開発者サブスクリプション（Basic、Pro、または Enterprise tier）、プロジェクト承認、OAuth 2.0 のセットアップが必要です。ApiPass では Bearer API キーだけで利用でき、サインアップ後数分でタスクを作成できます。基本的な検索アクセスに対するゲートキーピング階層はありません。
Twitter の公式 REST v2 エンドポイントは、リクエストした tweet.fields / user.fields によって制限されたフラットなフィールド選択型 JSON を返し、多くの内部シグナルを省略します。ApiPass は Twitter 自身の Web クライアントを反映した生の GraphQL レスポンス（search_by_raw_query.search_timeline.timeline.instructions）を返し、views.count、edit_control、highlights.textHighlights、clientEventInfo、完全な media video_info.variants など、よりリッチなオブジェクトを公開します。これらは公式 API では非表示、またはプレミアム階層が必要なデータです。
自社、製品 SKU、または経営陣への言及を継続的に検索し、ネガティブなセンチメントをカスタマーサポートのワークフローに振り分けます。
特定のトピック、ハッシュタグ、または位置情報に関する大規模な過去またはリアルタイムのツイートデータセットを収集し、定量調査に活用できます。
ニッチなキーワードを検索し、結果に含まれる投稿者を followers_count、favourites_count、エンゲージメントでランク付けして、特定分野の新興オピニオンリーダーを特定できます。
競合キャンペーンのハッシュタグやスローガンを検索し、プラットフォーム全体で使われているリーチ、エンゲージメント、クリエイティブの切り口をベンチマークできます。
ApiPass にサインアップし、ダッシュボードから Bearer token を生成します。この 1 つのキーですべてのリクエストを認証できるため、OAuth フローや Twitter 開発者申請は不要です。
model を twitter/graphql/search-timeline に設定して /api/v1/jobs/createTask エンドポイントへ POST リクエストを送信し、input.variables 内に検索パラメータを含めます。少なくとも rawQuery を指定し、必要に応じて count、product、cursor などのフィールドを追加します。任意で callBackUrl を指定すると、ジョブ完了時にプッシュ通知を受け取れます。
Step 2 で返された taskId を使って /api/v1/jobs/recordInfo エンドポイントをクエリします。タスクの state が success になったら、resultJson フィールドを解析して一致するツイートの全リストを取得し、必要に応じて返されたページネーションカーソルを使って追加ページを取得します。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
タイムラインを検索します。
この API は、以下の構造の JSON ペイロードを受け付けます。
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "rawQuery": "string",
8 "count": "number",
9 "cursor": "string",
10 "querySource": "string",
11 "product": "string",
12 "includePromotedContent": "boolean",
13 }
14 }
15}model必要string生成に使用するモデル名
"twitter/graphql/search-timeline"
callBackUrlオプションstringタスク完了通知用のコールバック URL。省略した場合、コールバックは送信されません。
"https://your-domain.com/api/callback"
channelオプションstringchannel パラメータを使用して、APIPASS 内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASS は現在、3 つのプロバイダーオプションを提供しています。
channel パラメータのデフォルト値は auto です。有効にすると、APIPASS はリアルタイムの価格と安定性指標に基づいて、利用可能なプロバイダー間でタスクを自動的に割り当て、低コストと安定したパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトの auto 値を保持してください。
利用可能なオプション：
auto
input オブジェクトには、以下のパラメータが含まれます。
input.variables.rawQuery必要stringinput.variables.countオプションnumber40
input.variables.cursorオプションstringinput.variables.querySourceオプションstringtyped_query
input.variables.productオプションstringLatest
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/search-timeline",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "variables": {
9 "rawQuery": "twitter",
10 "count": 40,
11 "cursor": "",
12 "querySource": "typed_query",
13 "product": "Latest",
14 "includePromotedContent": false,
15 }
16 }
17 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}codeステータスコード。200 は成功、その他は失敗を示します
messageレスポンスメッセージ。失敗時はエラーの説明が含まれます
data.taskIdタスクのステータスと結果を照会するためのタスク ID
