Skip to main content
Sorsa APIでは、X(旧Twitter)の公開データを読み取り専用で取得できます。ツイート、ユーザープロフィール、フォロワーのつながり、エンゲージメント指標、コミュニティ情報などに対応しています。このページでは一般的な活用シナリオと、関連するエンドポイントやガイドを紹介します。必要な情報からすぐに始められます。

ソーシャルリスニングとブランド監視

ブランド、製品、業界についての投稿をリアルタイムで追跡します。否定的な反応の拡大を早期に把握し、キャンペーンの効果や世間の評価を分析できます。 主なエンドポイント:
  • /search-tweets:公開ツイート全体からキーワード、ハッシュタグ、フレーズを検索
  • /mentions:指定したアカウントへのメンションを追跡し、エンゲージメントで絞り込んでノイズを削減
  • /list-tweets:Xリストを使って複数アカウントをまとめて監視
ガイド: ツイート検索 | メンションの追跡 | リアルタイム監視 | 検索演算子

競合調査

競合のプロフィールを比較し、コンテンツ戦略やオーディエンス構成を分析して、競合に関する世間の反応を監視します。 主なエンドポイント:
  • /info/info-batch:1件または複数のアカウントのプロフィール(フォロワー、ツイート、自己紹介)のスナップショット
  • /user-tweets:競合のタイムラインを取得し、投稿内容の構成や反応の良い投稿を分析
  • /mentions:競合についてのユーザーの投稿をエンゲージメントで絞り込み
  • /followers/verified-followers:競合のフォロワーを取得して分析
  • /score:暗号資産エコシステムにおける影響力を比較(Web3・暗号資産関連アカウント向け)
ガイド: 競合分析 | フォロワーとフォロー中ユーザー | Sorsa Scoreと暗号資産分析

見込み客の獲得とオーディエンスの発見

プロフィール検索、関連アカウントのフォロワー取得、コミュニティのメンバー調査、特定の話題について積極的に投稿するユーザーの発見を通じて、見込み客、パートナー、コミュニティメンバーを探します。 主なエンドポイント:
  • /search-users:自己紹介のキーワード(職種、関心、専門分野)でアカウントを検索
  • /followers:競合や業界の主要アカウントのフォロワーを取得
  • /community-members:話題別のXコミュニティのメンバー一覧を取得
  • /search-tweets:製品で解決できる課題について投稿しているユーザーを発見
ガイド: ターゲット層の発見 | フォロワーとフォロー中ユーザー | リストとコミュニティ

マーケティングキャンペーンとプレゼント企画の参加確認

フォロー、リツイート、コメント、引用、コミュニティ参加などのキャンペーンを実施し、各参加者が条件を満たしたかを確認します。確認結果に基づいて報酬配布を自動化できます。 主なエンドポイント:
  • /check-follow:ユーザーがアカウントをフォローしたか
  • /check-retweet:特定の投稿をリツイートしたか
  • /check-comment:コメントを残したか
  • /check-quoted:引用ツイートをしたか
  • /check-community-member:コミュニティに参加したか
ガイド: マーケティングキャンペーンの確認

過去の調査とデータ収集

2006年以降の公開ツイートのアーカイブにアクセスできます。過去の出来事の分析、学習用データセットの構築、議論の変遷の研究、ブランドの全投稿履歴の確認に活用できます。 主なエンドポイント:
  • /search-tweetssince:until:演算子:任意の過去の期間を指定したキーワード検索
  • /user-tweets:ページネーションでアカウントのタイムライン全体を取得
  • /tweet-info-bulk:ツイートIDの一覧から、現在のエンゲージメント情報を含むデータを取得
ガイド: 過去のデータ | 検索演算子

リアルタイム監視と通知

特定のアカウントやキーワードに一致する新規ツイートを投稿後数秒で検出し、Slack、Discord、データベース、独自のWebhookへ通知できます。 主なエンドポイント:
  • /list-tweets:1回のポーリングにつき1リクエストでXリスト全体(最大5,000アカウント)を監視
  • /user-tweets:重要なアカウント1件を追跡
  • /search-tweetsorder: "latest":キーワードやハッシュタグをリアルタイムで監視
  • /mentions:新しい@メンションを取得
ガイド: リアルタイム監視

ツイートと投稿の分析

特定のツイートについて、返信・引用・リツイートしたユーザーとその内容を分析します。リーチを測定し、主要なコメント投稿者を見つけ、コンテンツの成果を比較できます。 主なエンドポイント:
  • /tweet-info/tweet-info-bulk:1件または複数のツイートの全指標を取得
  • /comments:ツイートへの全返信
  • /quotes:すべての引用ツイート
  • /retweeters:リツイートした全ユーザー
  • /article:X記事(長文投稿)の全文
ガイド: ツイートのエンゲージメント | X記事

オーディエンスの地域分布と属性

アカウントのオーディエンスがどこにいるかを把握します。フォロワーの国別分布を調べ、広告のターゲティング、インフルエンサーの選定、市場拡大の調査に活用できます。 主なエンドポイント:
  • /followers:フォロワー一覧を取得
  • /about:各アカウントに関連付けられた国を取得
ガイド: オーディエンスの地域分布

暗号資産とWeb3の分析

Sorsa独自のスコアリングは、影響力のある暗号資産分野のKOL、プロジェクト、VCからの認知を測定します。暗号資産関連アカウントの実質的な影響力を評価し、スコアの勢い、新興プロジェクト、不自然な成長を調べられます。 主なエンドポイント:
  • /score/score-changes:影響力スコアと週次・月次の変化量
  • /followers-stats:カテゴリー別のフォロワー内訳(インフルエンサー、プロジェクト、VC)
  • /top-followers/top-following:スコア上位20件
  • /new-followers-7d/new-following-7d:暗号資産関連アカウントの最近のフォロー状況
ガイド: Sorsa Scoreと暗号資産分析

AI・LLMの学習データ

大量のツイートを収集し、言語モデルのファインチューニング、感情分類モデルの学習、検索拡張生成(RAG)のパイプライン構築に利用できます。SorsaはMLのワークフローに直接渡せる整ったJSONを返します。 主なエンドポイント:
  • /search-tweets:話題、言語、期間を指定して大量のツイートを収集
  • /user-tweets:コーパス構築用にタイムライン全体を取得
  • /comments/quotes:質問と回答の組や議論などの会話データを収集
ガイド: ツイート検索 | 過去のデータ | API利用の最適化

SaaS・分析プラットフォームの開発

Sorsaのデータを使い、独自のソーシャル分析ツール、ダッシュボード、監視プラットフォームを構築できます。一律料金(返すデータ量にかかわらずAPI呼び出し1回を1リクエストとして計算)と毎秒20リクエストの制限により、1つのAPIキーで複数のエンドユーザーに対応できます。 主なエンドポイント: すべてのプランで全エンドポイントを利用できます。完全な仕様はAPIリファレンスを参照してください。 ガイド: API利用の最適化 | 料金 | レート制限

エンドポイント早見表

必要なデータが決まっている場合は、こちらで対応するエンドポイントを確認できます。

どこから始めればよいですか?

  1. APIキーを取得するクイックスタートに従ってください。新規アカウントには、有効期限なし・クレジットカード不要の無料リクエスト100件が含まれます。
  2. 検索を試す:次のコマンドをターミナルに貼り付けると、10秒ほどでデータを確認できます。
  1. コードを書かずに試すAPI Playgroundの画面から、任意のエンドポイントを試せます。
  2. 上記の一覧から用途に合うガイドを選ぶ
  3. 料金を確認する料金で月額費用を見積もります。