> ## Documentation Index > Fetch the complete documentation index at: https://docs.sorsa.io/llms.txt > Use this file to discover all available pages before exploring further. # 活用シナリオの概要 Sorsa APIでは、X（旧Twitter）の公開データを読み取り専用で取得できます。ツイート、ユーザープロフィール、フォロワーのつながり、エンゲージメント指標、コミュニティ情報などに対応しています。このページでは一般的な活用シナリオと、関連するエンドポイントやガイドを紹介します。必要な情報からすぐに始められます。 *** ## ソーシャルリスニングとブランド監視 ブランド、製品、業界についての投稿をリアルタイムで追跡します。否定的な反応の拡大を早期に把握し、キャンペーンの効果や世間の評価を分析できます。 **主なエンドポイント：** * `/search-tweets`：公開ツイート全体からキーワード、ハッシュタグ、フレーズを検索 * `/mentions`：指定したアカウントへのメンションを追跡し、エンゲージメントで絞り込んでノイズを削減 * `/list-tweets`：Xリストを使って複数アカウントをまとめて監視 **ガイド：** [ツイート検索](https://docs.sorsa.io/ja/search-tweets) | [メンションの追跡](https://docs.sorsa.io/ja/search-mentions) | [リアルタイム監視](https://docs.sorsa.io/ja/real-time-monitoring) | [検索演算子](https://docs.sorsa.io/ja/search-operators) *** ## 競合調査 競合のプロフィールを比較し、コンテンツ戦略やオーディエンス構成を分析して、競合に関する世間の反応を監視します。 **主なエンドポイント：** * `/info`と`/info-batch`：1件または複数のアカウントのプロフィール（フォロワー、ツイート、自己紹介）のスナップショット * `/user-tweets`：競合のタイムラインを取得し、投稿内容の構成や反応の良い投稿を分析 * `/mentions`：競合についてのユーザーの投稿をエンゲージメントで絞り込み * `/followers`と`/verified-followers`：競合のフォロワーを取得して分析 * `/score`：暗号資産エコシステムにおける影響力を比較（Web3・暗号資産関連アカウント向け） **ガイド：** [競合分析](https://docs.sorsa.io/ja/Competitor-Analysis) | [フォロワーとフォロー中ユーザー](https://docs.sorsa.io/ja/followers-and-following) | [Sorsa Scoreと暗号資産分析](https://docs.sorsa.io/ja/sorsa-score-and-crypto-analytics) *** ## 見込み客の獲得とオーディエンスの発見 プロフィール検索、関連アカウントのフォロワー取得、コミュニティのメンバー調査、特定の話題について積極的に投稿するユーザーの発見を通じて、見込み客、パートナー、コミュニティメンバーを探します。 **主なエンドポイント：** * `/search-users`：自己紹介のキーワード（職種、関心、専門分野）でアカウントを検索 * `/followers`：競合や業界の主要アカウントのフォロワーを取得 * `/community-members`：話題別のXコミュニティのメンバー一覧を取得 * `/search-tweets`：製品で解決できる課題について投稿しているユーザーを発見 **ガイド：** [ターゲット層の発見](https://docs.sorsa.io/ja/target-audiences-Discovery) | [フォロワーとフォロー中ユーザー](https://docs.sorsa.io/ja/followers-and-following) | [リストとコミュニティ](https://docs.sorsa.io/ja/lists-and-communities) *** ## マーケティングキャンペーンとプレゼント企画の参加確認 フォロー、リツイート、コメント、引用、コミュニティ参加などのキャンペーンを実施し、各参加者が条件を満たしたかを確認します。確認結果に基づいて報酬配布を自動化できます。 **主なエンドポイント：** * `/check-follow`：ユーザーがアカウントをフォローしたか * `/check-retweet`：特定の投稿をリツイートしたか * `/check-comment`：コメントを残したか * `/check-quoted`：引用ツイートをしたか * `/check-community-member`：コミュニティに参加したか **ガイド：** [マーケティングキャンペーンの確認](https://docs.sorsa.io/ja/Marketing-Campaign-Verification) *** ## 過去の調査とデータ収集 2006年以降の公開ツイートのアーカイブにアクセスできます。過去の出来事の分析、学習用データセットの構築、議論の変遷の研究、ブランドの全投稿履歴の確認に活用できます。 **主なエンドポイント：** * `/search-tweets`と`since:`・`until:`演算子：任意の過去の期間を指定したキーワード検索 * `/user-tweets`：ページネーションでアカウントのタイムライン全体を取得 * `/tweet-info-bulk`：ツイートIDの一覧から、現在のエンゲージメント情報を含むデータを取得 **ガイド：** [過去のデータ](https://docs.sorsa.io/ja/historical-data) | [検索演算子](https://docs.sorsa.io/ja/search-operators) *** ## リアルタイム監視と通知 特定のアカウントやキーワードに一致する新規ツイートを投稿後数秒で検出し、Slack、Discord、データベース、独自のWebhookへ通知できます。 **主なエンドポイント：** * `/list-tweets`：1回のポーリングにつき1リクエストでXリスト全体（最大5,000アカウント）を監視 * `/user-tweets`：重要なアカウント1件を追跡 * `/search-tweets`と`order: "latest"`：キーワードやハッシュタグをリアルタイムで監視 * `/mentions`：新しい@メンションを取得 **ガイド：** [リアルタイム監視](https://docs.sorsa.io/ja/real-time-monitoring) *** ## ツイートと投稿の分析 特定のツイートについて、返信・引用・リツイートしたユーザーとその内容を分析します。リーチを測定し、主要なコメント投稿者を見つけ、コンテンツの成果を比較できます。 **主なエンドポイント：** * `/tweet-info`と`/tweet-info-bulk`：1件または複数のツイートの全指標を取得 * `/comments`：ツイートへの全返信 * `/quotes`：すべての引用ツイート * `/retweeters`：リツイートした全ユーザー * `/article`：X記事（長文投稿）の全文 **ガイド：** [ツイートのエンゲージメント](https://docs.sorsa.io/ja/tweet-engagement) | [X記事](https://docs.sorsa.io/ja/x-articles) *** ## オーディエンスの地域分布と属性 アカウントのオーディエンスがどこにいるかを把握します。フォロワーの国別分布を調べ、広告のターゲティング、インフルエンサーの選定、市場拡大の調査に活用できます。 **主なエンドポイント：** * `/followers`：フォロワー一覧を取得 * `/about`：各アカウントに関連付けられた国を取得 **ガイド：** [オーディエンスの地域分布](https://docs.sorsa.io/ja/Audience-Geography) *** ## 暗号資産とWeb3の分析 Sorsa独自のスコアリングは、影響力のある暗号資産分野のKOL、プロジェクト、VCからの認知を測定します。暗号資産関連アカウントの実質的な影響力を評価し、スコアの勢い、新興プロジェクト、不自然な成長を調べられます。 **主なエンドポイント：** * `/score`と`/score-changes`：影響力スコアと週次・月次の変化量 * `/followers-stats`：カテゴリー別のフォロワー内訳（インフルエンサー、プロジェクト、VC） * `/top-followers`と`/top-following`：スコア上位20件 * `/new-followers-7d`と`/new-following-7d`：暗号資産関連アカウントの最近のフォロー状況 **ガイド：** [Sorsa Scoreと暗号資産分析](https://docs.sorsa.io/ja/sorsa-score-and-crypto-analytics) *** ## AI・LLMの学習データ 大量のツイートを収集し、言語モデルのファインチューニング、感情分類モデルの学習、検索拡張生成（RAG）のパイプライン構築に利用できます。SorsaはMLのワークフローに直接渡せる整ったJSONを返します。 **主なエンドポイント：** * `/search-tweets`：話題、言語、期間を指定して大量のツイートを収集 * `/user-tweets`：コーパス構築用にタイムライン全体を取得 * `/comments`と`/quotes`：質問と回答の組や議論などの会話データを収集 **ガイド：** [ツイート検索](https://docs.sorsa.io/ja/search-tweets) | [過去のデータ](https://docs.sorsa.io/ja/historical-data) | [API利用の最適化](https://docs.sorsa.io/ja/optimizing-api-usage) *** ## SaaS・分析プラットフォームの開発 Sorsaのデータを使い、独自のソーシャル分析ツール、ダッシュボード、監視プラットフォームを構築できます。一律料金（返すデータ量にかかわらずAPI呼び出し1回を1リクエストとして計算）と毎秒20リクエストの制限により、1つのAPIキーで複数のエンドユーザーに対応できます。 **主なエンドポイント：** すべてのプランで全エンドポイントを利用できます。完全な仕様は[APIリファレンス](https://docs.sorsa.io/ja/api-reference-guide)を参照してください。 **ガイド：** [API利用の最適化](https://docs.sorsa.io/ja/optimizing-api-usage) | [料金](https://docs.sorsa.io/ja/pricing) | [レート制限](https://docs.sorsa.io/ja/rate-limits) *** ## エンドポイント早見表 必要なデータが決まっている場合は、こちらで対応するエンドポイントを確認できます。 | 必要なデータ | エンドポイント | ガイド | | :----------------------- | :------------------------- | :------------------------------------------------------------------------------ | | キーワードに一致するツイート | `/search-tweets` | [ツイート検索](https://docs.sorsa.io/ja/search-tweets) | | アカウントへのメンション | `/mentions` | [メンションの追跡](https://docs.sorsa.io/ja/search-mentions) | | ユーザーのプロフィール情報 | `/info` または `/info-batch` | [APIリファレンス](https://docs.sorsa.io/ja/api-reference-guide) | | アカウントのフォロワー | `/followers` | [フォロワーとフォロー中ユーザー](https://docs.sorsa.io/ja/followers-and-following) | | アカウントがフォローしているユーザー | `/follows` | [フォロワーとフォロー中ユーザー](https://docs.sorsa.io/ja/followers-and-following) | | ユーザーのツイート履歴 | `/user-tweets` | [過去のデータ](https://docs.sorsa.io/ja/historical-data) | | ツイートへの返信 | `/comments` | [ツイートのエンゲージメント](https://docs.sorsa.io/ja/tweet-engagement) | | ツイートの引用 | `/quotes` | [ツイートのエンゲージメント](https://docs.sorsa.io/ja/tweet-engagement) | | ツイートをリツイートしたユーザー | `/retweeters` | [ツイートのエンゲージメント](https://docs.sorsa.io/ja/tweet-engagement) | | ツイートの全指標 | `/tweet-info` | [ツイートのエンゲージメント](https://docs.sorsa.io/ja/tweet-engagement) | | 100ツイートの指標を一括取得 | `/tweet-info-bulk` | [API利用の最適化](https://docs.sorsa.io/ja/optimizing-api-usage) | | Xリスト内のツイート | `/list-tweets` | [リストとコミュニティ](https://docs.sorsa.io/ja/lists-and-communities) | | Xリストのメンバー | `/list-members` | [リストとコミュニティ](https://docs.sorsa.io/ja/lists-and-communities) | | コミュニティのメンバー | `/community-members` | [リストとコミュニティ](https://docs.sorsa.io/ja/lists-and-communities) | | コミュニティ内のツイート | `/community-tweets` | [リストとコミュニティ](https://docs.sorsa.io/ja/lists-and-communities) | | ユーザーがアカウントをフォローしたか | `/check-follow` | [キャンペーンの確認](https://docs.sorsa.io/ja/Marketing-Campaign-Verification) | | ユーザーがリツイートしたか | `/check-retweet` | [キャンペーンの確認](https://docs.sorsa.io/ja/Marketing-Campaign-Verification) | | ユーザーがコメントしたか | `/check-comment` | [キャンペーンの確認](https://docs.sorsa.io/ja/Marketing-Campaign-Verification) | | ユーザーが引用したか | `/check-quoted` | [キャンペーンの確認](https://docs.sorsa.io/ja/Marketing-Campaign-Verification) | | コミュニティへの参加確認 | `/check-community-member` | [キャンペーンの確認](https://docs.sorsa.io/ja/Marketing-Campaign-Verification) | | アカウントの国情報 | `/about` | [オーディエンスの地域分布](https://docs.sorsa.io/ja/Audience-Geography) | | Sorsa Score（暗号資産分野での影響力） | `/score` | [Sorsa Scoreと暗号資産分析](https://docs.sorsa.io/ja/sorsa-score-and-crypto-analytics) | | ユーザー名からユーザーIDへの変換 | `/username-to-id` | [ID変換](https://docs.sorsa.io/ja/ID-Conversion) | | ユーザーIDからユーザー名への変換 | `/id-to-username` | [ID変換](https://docs.sorsa.io/ja/ID-Conversion) | | プロフィールURLからユーザーIDへの変換 | `/link-to-id` | [ID変換](https://docs.sorsa.io/ja/ID-Conversion) | | APIキーの使用統計 | `/key-usage-info` | [料金](https://docs.sorsa.io/ja/pricing) | | X記事の内容 | `/article` | [X記事](https://docs.sorsa.io/ja/x-articles) | | 自己紹介のキーワードに一致するユーザー | `/search-users` | [ターゲット層の発見](https://docs.sorsa.io/ja/target-audiences-Discovery) | | アカウントの認証済みフォロワー | `/verified-followers` | [フォロワーとフォロー中ユーザー](https://docs.sorsa.io/ja/followers-and-following) | | Xリストのフォロワー | `/list-followers` | [リストとコミュニティ](https://docs.sorsa.io/ja/lists-and-communities) | | コミュニティ内のツイート検索 | `/community-search-tweets` | [リストとコミュニティ](https://docs.sorsa.io/ja/lists-and-communities) | | カテゴリー別のフォロワー内訳 | `/followers-stats` | [Sorsa Scoreと暗号資産分析](https://docs.sorsa.io/ja/sorsa-score-and-crypto-analytics) | | スコアの時系列変化 | `/score-changes` | [Sorsa Scoreと暗号資産分析](https://docs.sorsa.io/ja/sorsa-score-and-crypto-analytics) | | Sorsa Score上位のフォロワー | `/top-followers` | [Sorsa Scoreと暗号資産分析](https://docs.sorsa.io/ja/sorsa-score-and-crypto-analytics) | | Sorsa Score上位のフォロー中ユーザー | `/top-following` | [Sorsa Scoreと暗号資産分析](https://docs.sorsa.io/ja/sorsa-score-and-crypto-analytics) | | 過去7日間の新規フォロワー | `/new-followers-7d` | [Sorsa Scoreと暗号資産分析](https://docs.sorsa.io/ja/sorsa-score-and-crypto-analytics) | | 過去7日間に新しくフォローしたユーザー | `/new-following-7d` | [Sorsa Scoreと暗号資産分析](https://docs.sorsa.io/ja/sorsa-score-and-crypto-analytics) | *** ## どこから始めればよいですか？ 1. **APIキーを取得する**：[クイックスタート](https://docs.sorsa.io/ja/quickstart)に従ってください。新規アカウントには、有効期限なし・クレジットカード不要の無料リクエスト100件が含まれます。 2. **検索を試す**：次のコマンドをターミナルに貼り付けると、10秒ほどでデータを確認できます。 ```bash theme={null} curl -X POST https://api.sorsa.io/v3/search-tweets \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "your topic here", "order": "popular"}' ``` 3. **コードを書かずに試す**：[API Playground](https://api.sorsa.io/playground)の画面から、任意のエンドポイントを試せます。 4. 上記の一覧から用途に合う**ガイドを選ぶ**。 5. **料金を確認する**：[料金](https://docs.sorsa.io/ja/pricing)で月額費用を見積もります。