Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ出力はありません。フォームを送信してコンテンツを生成してください。
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
audio-space-search otherTwitter | Starter | 0.01per post | $0.00005 | - | - |
twitter-api-graphql の完全ガイド
1回のAPI呼び出しで、ライブ配信中、近日開催予定、過去の音声会話を含むTwitter（X）Spacesを検索・発見できます。
ApiPassのTwitter Graphql Audio Space Search APIは、開発者が柔軟なキーワードクエリとステータスフィルターを使用して、Twitterのライブ音声会話機能であるTwitter Spacesをプログラムで検索できるマネージドエンドポイントです。Twitterの内部GraphQLレイヤー上に構築されており、Webインターフェースをスクレイピングしたり、Twitterの認証の複雑さを管理したりすることなく、特定のトピック、キーワード、状態（Upcoming、Live、Pastなど）に一致するSpacesを取得できます。ApiPassはワークフロー全体を、シンプルな2ステップのタスクベースシステムにまとめています。POST /api/v1/jobs/createTaskで検索リクエストを送信し、GET /api/v1/jobs/recordInfoで構造化されたJSON結果を取得します。このAPIは、Twitterの音声エコシステムを対象とした音声コンテンツ発見ツール、ソーシャルリスニングダッシュボード、リアルタイム監視パイプラインの構築に最適です。
すべてのApiPassエンドポイントで一貫したcreate-task / query-taskパターンを採用しているため、統合の挙動を予測しやすく、コードベース全体で標準化しやすくなります。
デフォルトのautoチャネルは、リアルタイムの価格と安定性指標に基づいて、starter、regular、officialプロバイダー間でリクエストを自動的に割り当て、手動調整なしでコストと信頼性のバランスを取ります。
OAuthフロー、開発者アカウントの承認、レート制限の調整を省略し、ApiPass Bearerトークンを使用するだけで利用できます。
キーワード（query）で検索し、UpcomingなどのSpaceステータス（filter）で絞り込むことで、ユースケースに関連する予定済みセッションに集中できます。
任意のcallBackUrlを指定すると、タスク完了時に自動通知を受け取れるため、本番システムでポーリングループを実装する必要がなくなります。
超低コストの一括実験にはstarter階層を、ネイティブAPI価格で最大限の安定性が必要な場合はofficial階層を、同じインターフェースから選択できます。
自由入力のクエリとfilterパラメーター（例: Upcoming）を組み合わせて、必要なSpacesだけを正確に取得できます。
長時間実行される検索はtaskIdを使って非同期に処理され、タスク状態（waiting、queuing、generating、success、fail）により処理状況を完全に把握できます。
結果は整理されたresultJson.resultObjectペイロード内で返され、すぐに解析、保存、または下流の分析処理へ直接渡すことができます。
暗号資産、AI、スポーツなど特定のトピックに関する近日開催予定のSpacesを提示するキュレーションフィード。
ツイートだけでなく、ライブ音声で行われているブランド言及や業界の会話を監視できます。
ホストがトレンドトピックを特定し、自分のSpacesをスケジュールする最適な時間を見つけるのに役立ちます。
競合他社や業界リーダーが音声イベントを開始するタイミングを追跡し、参加パターンを分析できます。
ApiPassがTwitter公式のSpaces検索エンドポイントと比べて、アクセス、価格設定、スケーラビリティをどのように簡素化するかを確認し、プロジェクトに最適な選択ができます。
Twitterの公式APIでは、承認済みの開発者アカウント、上位アクセス階層、厳格なレート制限が必要で、有料プランは小規模チームにとって非常に高額になる場合があります。ApiPassは同じ機能を、申請プロセス不要のシンプルなBearerトークンリクエストとして提供し、数分で開発を開始できます。
Twitterの公式APIは、アクセス階層ごとに単一の固定料金体系を提供します。ApiPassでは、starter、regular、officialプロバイダーを動的に選択できます。またはデフォルトでautoを使用できるため、ワークロードに応じてコストと信頼性を個別にスケールできます。
キーワードベースのSpace検索を集約し、主流のフィードに現れる前に新たな会話トピックを検出できます。
カンファレンスのハッシュタグ、製品ローンチ、危機イベントに関連するすべてのSpacesをリアルタイムで追跡できます。
ジャーナリストや研究者は、進行中のニュースやテーマに関連するライブ音声ディスカッションを発見できます。
従来のツイートベースの言及と並行して、Twitterの音声エコシステム内でブランドやキャンペーンのキーワードがどの程度出現しているかを測定できます。
ApiPassに登録し、ダッシュボードからAPIキーを生成します。すべてのリクエストでAuthorizationヘッダーのBearerトークンとして使用します。
modelをtwitter/graphql/audio-space-searchに設定し、/api/v1/jobs/createTaskへPOSTリクエストを送信します。検索パラメーターはinput.variables内に指定し、queryキーワードと、結果を絞り込むためのUpcomingなどの任意のfilterを含めます。タスク完了時に自動通知を受け取るため、任意のcallBackUrlを含めることもできます。レスポンスでは、結果取得に使用する一意のtaskIdが返されます。
taskIdをクエリパラメーターとして指定し、/api/v1/jobs/recordInfoへGETリクエストを送信します。stateフィールドを監視し、successが返されると、Space検索結果がdata.resultJson.resultObject内で利用可能になり、解析してアプリケーションに統合できます。Step 2でcallBackUrlを指定している場合、ApiPassが結果をエンドポイントへ自動的にプッシュするため、ポーリングは不要です。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
Twitter Spacesを検索
このAPIは、次の構造のJSONペイロードを受け付けます:
1{
2 "model": "string",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "variables": {
7 "filter": "string",
8 "query": "string"
9 }
10 }
11}model必要string生成に使用するモデル名
"twitter/graphql/audio-space-search"
callBackUrlオプションstringタスク完了通知用のコールバックURL。省略した場合、コールバックは送信されません。
"https://your-domain.com/api/callback"
channelオプションstringchannelパラメータを使用して、APIPASS内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASSでは現在、3つのプロバイダーオプションを提供しています:
channelパラメータのデフォルト値はautoです。有効な場合、APIPASSはリアルタイムの価格と安定性指標に基づいて、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと安定したパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトのauto値を維持してください。
利用可能なオプション：
auto
inputオブジェクトには次のパラメータが含まれます:
input.variables.filterオプションstringUpcoming
input.variables.queryオプションstringa
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 "filter": "Upcoming",
10 "query": "a"
11 }
12 }
13 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}codeステータスコード。200は成功、その他は失敗を示します
messageレスポンスメッセージ。失敗時はエラー内容を示します
data.taskIdタスクのステータスと結果を照会するためのタスクID
