Skip to main content
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 - 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 | 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 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 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

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 | 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 - pull 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 (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 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:

Not Sure Where to Start?

  1. Get your API key - follow the 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:
  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.