Skip to main content

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: What You Can Build with X/Twitter Data

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 | Track Mentions | Real-Time Monitoring | 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 - scrape 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 | Followers & Following | Sorsa Score & 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 | Followers & Following | Lists & 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

​
Historical Research & Data Collection

Access the full 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 | 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 up to 5,000 accounts with a single 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

​
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
  • /retweets - all users who retweeted
  • /article - full content of X Articles (long-form posts)
Guides: Tweet Engagement | 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

​
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

​
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 - scrape complete timelines for corpus building
  • /comments and /quotes - collect conversational data (question-answer pairs, debates)
Guides: Search Tweets | Historical Data | 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 (1 request = 1 request) 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 for the full specification. Guides: Optimizing API Usage | Pricing | Rate Limits

​
Quick Endpoint Finder

If you already know what data you need, find the right endpoint here:
I need…EndpointGuide
Tweets matching a keyword/search-tweetsSearch Tweets
Mentions of an account/mentionsTrack Mentions
A user’s profile data/info or /info-batchAPI Reference
An account’s followers/followersFollowers & Following
Who an account follows/followsFollowers & Following
A user’s tweet history/user-tweetsHistorical Data
Replies to a tweet/commentsTweet Engagement
Quote tweets of a tweet/quotesTweet Engagement
Who retweeted a tweet/retweetsTweet Engagement
Full metrics of a tweet/tweet-infoTweet Engagement
Metrics for 100 tweets at once/tweet-info-bulkOptimizing API Usage
Tweets from an X List/list-tweetsLists & Communities
Members of an X List/list-membersLists & Communities
Members of a Community/community-membersLists & Communities
Tweets in a Community/community-tweetsLists & Communities
Whether a user follows an account/check-followCampaign Verification
Whether a user retweeted/check-retweetCampaign Verification
Whether a user commented/check-commentCampaign Verification
Whether a user quoted/check-quotedCampaign Verification
Community membership check/check-community-memberCampaign Verification
An account’s country/aboutAudience Geography
Sorsa Score (crypto influence)/scoreSorsa Score & Crypto Analytics
Username to User ID/username-to-idID Conversion
User ID to Username/id-to-usernameID Conversion
Profile URL to User ID/link-to-idID Conversion
API key usage stats/key-usage-infoPricing
X Article content/articleX Articles
Users matching a bio keyword/search-usersTarget Audience Discovery
Verified followers of an account/verified-followersFollowers & Following
Followers of an X List/list-followersLists & Communities
Search tweets within a Community/community-search-tweetsLists & Communities
Follower breakdown by category/followers-statsSorsa Score & Crypto Analytics
Score changes over time/score-changesSorsa Score & Crypto Analytics
Top followers by Sorsa Score/top-followersSorsa Score & Crypto Analytics
Top following by Sorsa Score/top-followingSorsa Score & Crypto Analytics
New followers in last 7 days/new-followers-7dSorsa Score & Crypto Analytics
New following in last 7 days/new-following-7dSorsa Score & Crypto Analytics

​
Not Sure Where to Start?

  1. Get your API key - follow the Quickstart guide.
  2. Try a search - paste this into your terminal and see data in 10 seconds:
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"}'
  1. Explore without code - use the API Playground to test any endpoint through a visual interface.
  2. Pick a guide from the list above that matches your use case.
  3. Check pricing - see Pricing to estimate your monthly cost.