> ## 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 へようこそ

Sorsa APIは、シンプルなRESTインターフェースを通じて、X（旧Twitter）の公開データに高速かつ構造化された形でアクセスできるサービスです。ユーザープロフィール、ツイート、検索、フォロー関係、リストやコミュニティのコンテンツ、暗号資産分野のオーディエンス分析を、1つのAPIキーで利用できます。OAuthやアプリの承認は不要で、予期しないレート制限に悩まされることもありません。

自分で構築・保守する必要のない、信頼できるXデータソースとして利用できます。公式Twitter APIに代わるマネージドサービスとして、公開されたXのコンテンツを大規模に抽出・監視・分析したい開発者、データエンジニア、アナリスト、研究者、グロースチーム、AIプロダクト開発者向けに設計されています。

> **AI向けドキュメント／LLM対応ドキュメント。** LLM、AIエージェント、コーディングアシスタントを使って開発していますか？リクエストを生成する前に必要な情報を把握できるよう、機械可読形式の[APIドキュメント全文](https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt)を読み込ませてください。

***

## Sorsa APIはどのような人に向いていますか？

Sorsaは、Xプラットフォームのデータにプログラムからアクセスしたいすべての人のためのサービスです。利用を始めるために、公式のX開発者アカウント、Twitter APIの承認、複雑なOAuth設定は必要ありません。

ソーシャルデータパイプラインを構築するバックエンド開発者、感情分析を行うデータサイエンティスト、ブランドへの言及を追跡するマーケター、コミュニティへの参加を検証するWeb3チーム、XデータをMakeやZapierなどの自動化ツールに接続するノーコード開発者、公開会話から学習データを収集するAIエンジニアなどに利用されています。

***

## クイックスタート

**ベースURL**

```text theme={null}
https://api.sorsa.io/v3
```

**認証**

すべてのリクエストで、APIキーを `ApiKey` ヘッダーに指定してください。OAuthフロー、Bearerトークン、コールバックURLは不要です。

**レスポンス形式**

すべてのエンドポイントはJSONを返します。

**リクエスト例**

```bash theme={null}
curl --request GET \
  --url "https://api.sorsa.io/v3/info?username=elonmusk" \
  --header "ApiKey: YOUR_API_KEY"
```

初めて利用する場合は、[クイックスタートガイド](https://docs.sorsa.io/ja/quickstart)に従ってAPIキーを取得し、3分以内に最初のリクエストを送信できます。

**無料で開始できます。** 新規アカウントには、クレジットカード不要・有効期限なしで、100回分の無料リクエストが付与されます。利用可能なすべてのエンドポイントにアクセスできるため、プランを選ぶ前に各エンドポイントを試せます。

***

## AIを使って開発していますか？

Sorsaは、LLMを活用するエージェント、AIコーディングアシスタント、自動化ワークフローに簡単に組み込めるよう設計されています。エンドポイントを手作業で貼り付ける代わりに、ドキュメント全体をモデルに直接渡してください。

* [AI向けドキュメント](https://docs.sorsa.io/ja/ai-docs) — Sorsaのドキュメントをプログラムから利用する方法の概要です。
* [ドキュメント索引（llms.txt）](https://docs.sorsa.io/llms.txt) — 利用可能なページを簡潔にまとめた一覧です。エージェントは詳細を調べる前に全体像を把握できます。
* [プレーンテキストのAPIリファレンス全文](https://api.sorsa.io/v3/static/sorsa_api_v3_documentation_en.txt) — LLMが読み取れる完全な仕様を1つのファイルにまとめています。プロンプト、IDE、検索インデックスに取り込めます。

***

## APIでできること

取得できるデータの概要を紹介します。完全なスキーマ、パラメータ、レスポンス例は、[APIリファレンス](https://docs.sorsa.io/ja/api-reference-guide)を参照してください。

### ユーザー

ユーザープロフィール、オーディエンス指標、アカウント履歴、フォロワー・フォロー中のアカウント・認証済みフォロワーを含む関係グラフを取得します。プロフィールは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](https://api.sorsa.io/playground/search-builder)でクエリを視覚的に組み立て、[検索演算子](https://docs.sorsa.io/ja/search-operators)のリファレンスで詳細を確認してください。

主なエンドポイント：`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](https://api.sorsa.io/playground/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データの同期ができます。

実装パターンやワークフローの詳しい例は、[活用例ガイド](https://docs.sorsa.io/ja/use-cases-overview)を参照してください。

***

## コードを書かずに試す

Sorsaを試すためにコードを書く必要はありません。[API Playground](https://api.sorsa.io/playground)では、ブラウザから各エンドポイントを呼び出し、実際のレスポンスを確認しながら、組み込み前にパラメータを試せます。

APIを利用した無料のツールも用意しています。

* [Search Builder](https://api.sorsa.io/playground/search-builder) — 高度なツイート検索クエリを視覚的に作成します。
* [ID Converter](https://api.sorsa.io/playground/id-converter) — ユーザー名、ユーザーID、プロフィールリンクを相互変換します。
* [Shadowban Check](https://api.sorsa.io/playground/shadowban-check) — アカウントがシャドウバンされているかを確認します。
* [Media Downloader](https://api.sorsa.io/playground/media-downloader) — ツイートから画像や動画をダウンロードします。
* [Compare Users](https://api.sorsa.io/playground/compare-users) — 2つのアカウントの主要指標を並べて比較します。
* [Recent Followers](https://api.sorsa.io/playground/recent-followers) — アカウントの最新フォロワーを確認します。
* [Engagement Calculator](https://api.sorsa.io/playground/engagement-calculator) — 最近のツイートからエンゲージメント率を推定します。
* [Follow Check](https://api.sorsa.io/playground/follow-check) — 2つのアカウントが互いにフォローしているか確認します。
* [Location Check](https://api.sorsa.io/playground/location-check) — Xアカウントの拠点となる国を調べます。
* [Account Age Check](https://api.sorsa.io/playground/account-age-check) — アカウントの作成日を確認します。

詳しいガイド、チュートリアル、移行手順は、[Sorsa Blog](https://api.sorsa.io/blog)をご覧ください。

***

## Sorsa APIが対応していないこと

Sorsaはデータの抽出と分析に特化した読み取り専用APIです。Xプラットフォーム上で次のような書き込み操作は行いません。

* ツイート、返信、ダイレクトメッセージの投稿
* いいね、ブックマーク、リツイート
* アカウントのフォローやフォロー解除
* ユーザーアカウントに代わって行うあらゆる操作

書き込みが必要な場合は、その操作に公式X APIを使用し、信頼性の高い大規模な読み取りにはSorsaを併用できます。

***

## 次のステップ

* [クイックスタート](https://docs.sorsa.io/ja/quickstart) — APIキーを取得し、最初のリクエストを送信します。
* [認証](https://docs.sorsa.io/ja/authentication) — v3 APIへのリクエストを認証する方法を学びます。
* [APIリファレンス](https://docs.sorsa.io/ja/api-reference-guide) — 利用可能なすべてのエンドポイントのパラメータとレスポンススキーマを確認します。
* [料金](https://docs.sorsa.io/ja/pricing) — プランとリクエストパッケージを確認します。すべてのアカウントには100回分の無料リクエストが付与されます。
* [レート制限](https://docs.sorsa.io/ja/rate-limits) — 利用枠とスロットリングについて確認します。
* [活用例ガイド](https://docs.sorsa.io/ja/use-cases-overview) — 実際の実装パターンとワークフローを確認します。