AI向けドキュメント/LLM対応ドキュメント。 LLM、AIエージェント、コーディングアシスタントを使って開発していますか?リクエストを生成する前に必要な情報を把握できるよう、機械可読形式のAPIドキュメント全文を読み込ませてください。
Sorsa APIはどのような人に向いていますか?
Sorsaは、Xプラットフォームのデータにプログラムからアクセスしたいすべての人のためのサービスです。利用を始めるために、公式のX開発者アカウント、Twitter APIの承認、複雑なOAuth設定は必要ありません。 ソーシャルデータパイプラインを構築するバックエンド開発者、感情分析を行うデータサイエンティスト、ブランドへの言及を追跡するマーケター、コミュニティへの参加を検証するWeb3チーム、XデータをMakeやZapierなどの自動化ツールに接続するノーコード開発者、公開会話から学習データを収集するAIエンジニアなどに利用されています。クイックスタート
ベースURLApiKey ヘッダーに指定してください。OAuthフロー、Bearerトークン、コールバックURLは不要です。
レスポンス形式
すべてのエンドポイントはJSONを返します。
リクエスト例
AIを使って開発していますか?
Sorsaは、LLMを活用するエージェント、AIコーディングアシスタント、自動化ワークフローに簡単に組み込めるよう設計されています。エンドポイントを手作業で貼り付ける代わりに、ドキュメント全体をモデルに直接渡してください。- AI向けドキュメント — Sorsaのドキュメントをプログラムから利用する方法の概要です。
- ドキュメント索引(llms.txt) — 利用可能なページを簡潔にまとめた一覧です。エージェントは詳細を調べる前に全体像を把握できます。
- プレーンテキストのAPIリファレンス全文 — LLMが読み取れる完全な仕様を1つのファイルにまとめています。プロンプト、IDE、検索インデックスに取り込めます。
APIでできること
取得できるデータの概要を紹介します。完全なスキーマ、パラメータ、レスポンス例は、APIリファレンスを参照してください。ユーザー
ユーザープロフィール、オーディエンス指標、アカウント履歴、フォロワー・フォロー中のアカウント・認証済みフォロワーを含む関係グラフを取得します。プロフィールは1件ずつ、または最大100件のバッチで取得できます。 主なエンドポイント:GET /info、GET /info-batch、GET /about、GET /followers、GET /follows、GET /verified-followers
ツイート
ツイート本文、エンゲージメント指標、スレッド、返信、引用、リツイートしたユーザー、ユーザーのタイムライン、長文のX記事、地域別のトレンドにアクセスできます。ツイートは1件ずつ、または最大100件を一度に取得できます。 主なエンドポイント:POST /tweet-info、POST /tweet-info-bulk、POST /user-tweets、POST /comments、POST /quotes、POST /retweeters、POST /article、GET /trends
検索
Xの高度な検索構文(from:、to:、since:、until:、ハッシュタグなど)に完全対応したクエリでツイートやユーザーを検索できます。専用のメンション追跡やスペース検索も利用できます。無料のSearch Builderでクエリを視覚的に組み立て、検索演算子のリファレンスで詳細を確認してください。
主なエンドポイント:POST /search-tweets、POST /mentions、POST /search-users、GET /spaces
検証
フォロー、コメント、引用、リツイート、コミュニティへの参加といった操作が行われたかを確認できます。アクセス条件の判定やマーケティングキャンペーンの参加確認に役立ちます。 主なエンドポイント:POST /check-follow、GET /check-comment、POST /check-quoted、POST /check-retweet、POST /check-community-member
リスト
公開Xリストのメンバー、フォロワー、ツイートフィードを取得できます。 主なエンドポイント:GET /list-members、GET /list-followers、GET /list-tweets
コミュニティ
Xコミュニティのコンテンツやメンバー情報にアクセスし、コミュニティ内を検索できます。 主なエンドポイント:POST /community-tweets、POST /community-search-tweets、POST /community-members
暗号資産とWeb3の分析
アカウントのSorsa Score(インフルエンサー、プロジェクト、VCの間での人気度)、スコアの推移、フォロワーのカテゴリ別内訳、スコア上位のフォロワーとフォロー中アカウント、過去7日間の新しいフォロー活動を追跡できます。 主なエンドポイント:GET /score、GET /score-changes、GET /followers-stats、GET /top-followers、GET /top-following、GET /new-followers-7d、GET /new-following-7d
技術ユーティリティ
ユーザー名とユーザーIDの相互変換、プロフィールリンクからのID抽出、API利用枠の使用状況の確認ができます。無料のID Converterを使えば、ブラウザからIDを変換することもできます。 主なエンドポイント:GET /username-to-id、GET /id-to-username、GET /link-to-id、GET /key-usage-info
主な活用例
ブランドとメディアの監視。 ブランドや競合に関するメンション、キーワード、感情をリアルタイムで追跡します。 データパイプライン。 構造化されたXデータをBigQuery、PostgreSQL、S3などのデータウェアハウスにエクスポートします。 オーディエンス分析。 フォロワーの関係グラフを作成し、価値の高い接点を見つけ、クリエイターの成長を時系列で分析します。 アクセス条件とソーシャルアクションの検証。 キャンペーン、トークン配布、限定コンテンツへのアクセスを許可する前に、ユーザーがフォロー、リツイート、コメント、引用などのタスクを完了したか確認します。 AI・LLMの学習データ。 モデルのファインチューニング、感情分析、研究用データセットのために、高品質な公開会話データを収集します。 ノーコード・ローコードの自動化。 HTTPリクエストモジュールを使い、Sorsa APIをMake(Integromat)、Zapier、n8n、Pipedreamなどに接続します。コードを書かずに、アカウントの監視、新しいメンションを起点としたワークフローの実行、スプレッドシートやCRMへのXデータの同期ができます。 実装パターンやワークフローの詳しい例は、活用例ガイドを参照してください。コードを書かずに試す
Sorsaを試すためにコードを書く必要はありません。API Playgroundでは、ブラウザから各エンドポイントを呼び出し、実際のレスポンスを確認しながら、組み込み前にパラメータを試せます。 APIを利用した無料のツールも用意しています。- Search Builder — 高度なツイート検索クエリを視覚的に作成します。
- ID Converter — ユーザー名、ユーザーID、プロフィールリンクを相互変換します。
- Shadowban Check — アカウントがシャドウバンされているかを確認します。
- Media Downloader — ツイートから画像や動画をダウンロードします。
- Compare Users — 2つのアカウントの主要指標を並べて比較します。
- Recent Followers — アカウントの最新フォロワーを確認します。
- Engagement Calculator — 最近のツイートからエンゲージメント率を推定します。
- Follow Check — 2つのアカウントが互いにフォローしているか確認します。
- Location Check — Xアカウントの拠点となる国を調べます。
- Account Age Check — アカウントの作成日を確認します。
Sorsa APIが対応していないこと
Sorsaはデータの抽出と分析に特化した読み取り専用APIです。Xプラットフォーム上で次のような書き込み操作は行いません。- ツイート、返信、ダイレクトメッセージの投稿
- いいね、ブックマーク、リツイート
- アカウントのフォローやフォロー解除
- ユーザーアカウントに代わって行うあらゆる操作