> ## 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.

# Use Cases Overview

Sorsa API provides read-only access to public X (formerly Twitter) data: tweets, user profiles, follower graphs, engagement metrics, community data, and more. This page maps common use cases to the endpoints and guides that cover them, so you can jump straight to what you need.

***

## Social Listening & Brand Monitoring

Track what people say about your brand, product, or industry in real time. Detect negative sentiment before it escalates, measure campaign impact, and understand public perception.

**Key endpoints:**

* `/search-tweets` - search for any keyword, hashtag, or phrase across all public tweets
* `/mentions` - track every time a specific handle is tagged, with engagement filters to cut through noise
* `/list-tweets` - monitor multiple accounts at once via X Lists

**Guides:** [Search Tweets](https://docs.sorsa.io/search-tweets) | [Track Mentions](https://docs.sorsa.io/search-mentions) | [Real-Time Monitoring](https://docs.sorsa.io/real-time-monitoring) | [Search Operators](https://docs.sorsa.io/search-operators)

***

## Competitor Intelligence

Benchmark your competitors' profiles, analyze their content strategy, map their audience composition, and monitor what the public says about them.

**Key endpoints:**

* `/info` and `/info-batch` - profile snapshots (followers, tweets, bio) for one or many accounts
* `/user-tweets` - pull a competitor's timeline to analyze content mix and top-performing posts
* `/mentions` - see what users say about a competitor, filtered by engagement
* `/followers` and `/verified-followers` - extract and analyze who follows a competitor
* `/score` - compare crypto-ecosystem influence (for Web3/crypto accounts)

**Guides:** [Competitor Analysis](https://docs.sorsa.io/Competitor-Analysis) | [Followers & Following](https://docs.sorsa.io/followers-and-following) | [Sorsa Score & Crypto Analytics](https://docs.sorsa.io/sorsa-score-and-crypto-analytics)

***

## Lead Generation & Audience Discovery

Find potential customers, partners, or community members by searching user profiles, extracting follower lists from relevant accounts, mining community membership, or identifying people actively discussing specific topics.

**Key endpoints:**

* `/search-users` - find accounts by bio keywords (job titles, interests, niches)
* `/followers` - extract followers of a competitor or industry leader
* `/community-members` - get member lists from topic-based X Communities
* `/search-tweets` - find people actively tweeting about pain points your product solves

**Guides:** [Target Audience Discovery](https://docs.sorsa.io/target-audiences-Discovery) | [Followers & Following](https://docs.sorsa.io/followers-and-following) | [Lists & Communities](https://docs.sorsa.io/lists-and-communities)

***

## Marketing Campaigns & Giveaway Verification

Run engagement campaigns (follow, retweet, comment, quote, join community) and verify that each participant actually completed the required actions. Automate reward distribution based on verified completion.

**Key endpoints:**

* `/check-follow` - did the user follow your account?
* `/check-retweet` - did they retweet a specific post?
* `/check-comment` - did they leave a comment?
* `/check-quoted` - did they quote tweet?
* `/check-community-member` - did they join your community?

**Guide:** [Marketing Campaign Verification](https://docs.sorsa.io/Marketing-Campaign-Verification)

***

## Historical Research & Data Collection

Access the archive of public tweets dating back to 2006. Analyze past events, build training datasets, study how discourse evolved over time, or audit a brand's complete posting history.

**Key endpoints:**

* `/search-tweets` with `since:` and `until:` operators - keyword search within any historical window
* `/user-tweets` - paginate through an account's complete timeline
* `/tweet-info-bulk` - hydrate a list of tweet IDs with current engagement data

**Guides:** [Historical Data](https://docs.sorsa.io/historical-data) | [Search Operators](https://docs.sorsa.io/search-operators)

***

## Real-Time Monitoring & Alerts

Detect new tweets from specific accounts or matching specific keywords within seconds of posting. Route alerts to Slack, Discord, databases, or custom webhooks.

**Key endpoints:**

* `/list-tweets` - monitor a whole X List (up to 5,000 accounts) with one request per poll cycle
* `/user-tweets` - track a single VIP account
* `/search-tweets` with `order: "latest"` - monitor a keyword or hashtag in real time
* `/mentions` - catch new @mentions as they arrive

**Guide:** [Real-Time Monitoring](https://docs.sorsa.io/real-time-monitoring)

***

## Tweet & Post Analysis

Analyze engagement on specific tweets: who replied, who quoted, who retweeted, and what they said. Measure reach, identify top commenters, and benchmark content performance.

**Key endpoints:**

* `/tweet-info` and `/tweet-info-bulk` - get full metrics for one or many tweets
* `/comments` - all replies under a tweet
* `/quotes` - all quote tweets
* `/retweeters` - all users who retweeted
* `/article` - full content of X Articles (long-form posts)

**Guides:** [Tweet Engagement](https://docs.sorsa.io/tweet-engagement) | [X Articles](https://docs.sorsa.io/x-articles)

***

## Audience Geography & Demographics

Understand where an account's audience is located. Map follower distribution by country for ad targeting, influencer vetting, or market expansion research.

**Key endpoints:**

* `/followers` - extract the follower list
* `/about` - look up the country associated with each account

**Guide:** [Audience Geography](https://docs.sorsa.io/Audience-Geography)

***

## Crypto & Web3 Analytics

Evaluate the real influence of crypto accounts using Sorsa's proprietary scoring system, which measures recognition from influential crypto KOLs, projects, and VCs. Track score momentum, identify rising projects, and detect inorganic growth.

**Key endpoints:**

* `/score` and `/score-changes` - influence score and weekly/monthly deltas
* `/followers-stats` - follower breakdown by category (influencers, projects, VCs)
* `/top-followers` and `/top-following` - top 20 by score
* `/new-followers-7d` and `/new-following-7d` - recent follow activity among crypto accounts

**Guide:** [Sorsa Score & Crypto Analytics](https://docs.sorsa.io/sorsa-score-and-crypto-analytics)

***

## AI & LLM Training Data

Collect large tweet datasets for fine-tuning language models, training sentiment classifiers, or building retrieval-augmented generation (RAG) pipelines. Sorsa returns clean JSON that can be piped directly into ML workflows.

**Key endpoints:**

* `/search-tweets` - collect tweets by topic, language, and date range at scale
* `/user-tweets` - pull complete timelines for corpus building
* `/comments` and `/quotes` - collect conversational data (question-answer pairs, debates)

**Guides:** [Search Tweets](https://docs.sorsa.io/search-tweets) | [Historical Data](https://docs.sorsa.io/historical-data) | [Optimizing API Usage](https://docs.sorsa.io/optimizing-api-usage)

***

## SaaS & Analytics Platform Development

Build your own social analytics tool, dashboard, or monitoring platform on top of Sorsa's data layer. The flat pricing model (one API call counts as one request, regardless of how much data it returns) and 20 req/s rate limit make it feasible to serve multiple end users from a single API key.

**Key endpoints:** All endpoints are available on every plan. See the [API Reference](https://docs.sorsa.io/api-reference-guide) for the full specification.

**Guides:** [Optimizing API Usage](https://docs.sorsa.io/optimizing-api-usage) | [Pricing](https://docs.sorsa.io/pricing) | [Rate Limits](https://docs.sorsa.io/rate-limits)

***

## Quick Endpoint Finder

If you already know what data you need, find the right endpoint here:

| I need...                         | Endpoint                   | Guide                                                                                    |
| :-------------------------------- | :------------------------- | :--------------------------------------------------------------------------------------- |
| Tweets matching a keyword         | `/search-tweets`           | [Search Tweets](https://docs.sorsa.io/search-tweets)                                     |
| Mentions of an account            | `/mentions`                | [Track Mentions](https://docs.sorsa.io/search-mentions)                                  |
| A user's profile data             | `/info` or `/info-batch`   | [API Reference](https://docs.sorsa.io/api-reference-guide)                               |
| An account's followers            | `/followers`               | [Followers & Following](https://docs.sorsa.io/followers-and-following)                   |
| Who an account follows            | `/follows`                 | [Followers & Following](https://docs.sorsa.io/followers-and-following)                   |
| A user's tweet history            | `/user-tweets`             | [Historical Data](https://docs.sorsa.io/historical-data)                                 |
| Replies to a tweet                | `/comments`                | [Tweet Engagement](https://docs.sorsa.io/tweet-engagement)                               |
| Quote tweets of a tweet           | `/quotes`                  | [Tweet Engagement](https://docs.sorsa.io/tweet-engagement)                               |
| Who retweeted a tweet             | `/retweeters`              | [Tweet Engagement](https://docs.sorsa.io/tweet-engagement)                               |
| Full metrics of a tweet           | `/tweet-info`              | [Tweet Engagement](https://docs.sorsa.io/tweet-engagement)                               |
| Metrics for 100 tweets at once    | `/tweet-info-bulk`         | [Optimizing API Usage](https://docs.sorsa.io/optimizing-api-usage)                       |
| Tweets from an X List             | `/list-tweets`             | [Lists & Communities](https://docs.sorsa.io/lists-and-communities)                       |
| Members of an X List              | `/list-members`            | [Lists & Communities](https://docs.sorsa.io/lists-and-communities)                       |
| Members of a Community            | `/community-members`       | [Lists & Communities](https://docs.sorsa.io/lists-and-communities)                       |
| Tweets in a Community             | `/community-tweets`        | [Lists & Communities](https://docs.sorsa.io/lists-and-communities)                       |
| Whether a user follows an account | `/check-follow`            | [Campaign Verification](https://docs.sorsa.io/Marketing-Campaign-Verification)           |
| Whether a user retweeted          | `/check-retweet`           | [Campaign Verification](https://docs.sorsa.io/Marketing-Campaign-Verification)           |
| Whether a user commented          | `/check-comment`           | [Campaign Verification](https://docs.sorsa.io/Marketing-Campaign-Verification)           |
| Whether a user quoted             | `/check-quoted`            | [Campaign Verification](https://docs.sorsa.io/Marketing-Campaign-Verification)           |
| Community membership check        | `/check-community-member`  | [Campaign Verification](https://docs.sorsa.io/Marketing-Campaign-Verification)           |
| An account's country              | `/about`                   | [Audience Geography](https://docs.sorsa.io/Audience-Geography)                           |
| Sorsa Score (crypto influence)    | `/score`                   | [Sorsa Score & Crypto Analytics](https://docs.sorsa.io/sorsa-score-and-crypto-analytics) |
| Username to User ID               | `/username-to-id`          | [ID Conversion](https://docs.sorsa.io/ID-Conversion)                                     |
| User ID to Username               | `/id-to-username`          | [ID Conversion](https://docs.sorsa.io/ID-Conversion)                                     |
| Profile URL to User ID            | `/link-to-id`              | [ID Conversion](https://docs.sorsa.io/ID-Conversion)                                     |
| API key usage stats               | `/key-usage-info`          | [Pricing](https://docs.sorsa.io/pricing)                                                 |
| X Article content                 | `/article`                 | [X Articles](https://docs.sorsa.io/x-articles)                                           |
| Users matching a bio keyword      | `/search-users`            | [Target Audience Discovery](https://docs.sorsa.io/target-audiences-Discovery)            |
| Verified followers of an account  | `/verified-followers`      | [Followers & Following](https://docs.sorsa.io/followers-and-following)                   |
| Followers of an X List            | `/list-followers`          | [Lists & Communities](https://docs.sorsa.io/lists-and-communities)                       |
| Search tweets within a Community  | `/community-search-tweets` | [Lists & Communities](https://docs.sorsa.io/lists-and-communities)                       |
| Follower breakdown by category    | `/followers-stats`         | [Sorsa Score & Crypto Analytics](https://docs.sorsa.io/sorsa-score-and-crypto-analytics) |
| Score changes over time           | `/score-changes`           | [Sorsa Score & Crypto Analytics](https://docs.sorsa.io/sorsa-score-and-crypto-analytics) |
| Top followers by Sorsa Score      | `/top-followers`           | [Sorsa Score & Crypto Analytics](https://docs.sorsa.io/sorsa-score-and-crypto-analytics) |
| Top following by Sorsa Score      | `/top-following`           | [Sorsa Score & Crypto Analytics](https://docs.sorsa.io/sorsa-score-and-crypto-analytics) |
| New followers in last 7 days      | `/new-followers-7d`        | [Sorsa Score & Crypto Analytics](https://docs.sorsa.io/sorsa-score-and-crypto-analytics) |
| New following in last 7 days      | `/new-following-7d`        | [Sorsa Score & Crypto Analytics](https://docs.sorsa.io/sorsa-score-and-crypto-analytics) |

***

## Not Sure Where to Start?

1. **Get your API key** - follow the [Quickstart](https://docs.sorsa.io/quickstart) guide. Every new account includes 100 free requests, with no credit card required and no expiry.
2. **Try a search** - paste this into your terminal and see data in 10 seconds:

```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. **Explore without code** - use the [API Playground](https://api.sorsa.io/playground) to test any endpoint through a visual interface.
4. **Pick a guide** from the list above that matches your use case.
5. **Check pricing** - see [Pricing](https://docs.sorsa.io/pricing) to estimate your monthly cost.