AI Docs / LLM-ready documentation. Building with an LLM, AI agent, or coding assistant? Point it at our machine-readable docs so it has full context before generating any request: the AI Docs (llms.txt).
Who is Sorsa API for?
Sorsa is built for anyone who needs programmatic access to X platform data. You do not need an official X developer account, Twitter API approval, or complex OAuth setup to get started. Common profiles include backend developers building social data pipelines, data scientists running sentiment analysis, growth marketers tracking brand mentions, Web3 teams verifying community engagement, no-code builders connecting X data to automation tools like Make or Zapier, and AI engineers collecting training datasets from public conversations.Quick start
Base URLApiKey header with every request. No OAuth flows, no bearer tokens, no callback URLs.
Response format
All endpoints return JSON.
Example request
Building with AI?
Sorsa is designed to be easy to wire into LLM-powered agents, AI coding assistants, and automated workflows. Instead of pasting endpoints by hand, feed your model the full documentation context directly:- AI Docs page - an overview of how to consume Sorsa documentation programmatically.
- Documentation index (llms.txt) - a compact map of every available page, so an agent can discover the docs before exploring further.
- Full plain-text API reference - the complete, LLM-readable specification in a single file. Drop it into your prompt, IDE, or retrieval index.
API capabilities
A high-level overview of what you can retrieve. For complete schemas, parameters, and response examples, see the API Reference.Users
Retrieve user profiles, audience metrics, account history, and relationship graphs - including followers, followings, and verified followers. Profiles can be fetched one at a time or in batches. Key endpoints:GET /info, GET /info-batch, GET /about, GET /followers, GET /follows, GET /verified-followers
Tweets
Access tweet content, engagement metrics, threads, replies, quotes, retweeters, user timelines, and long-form X Articles. Fetch a single tweet or up to 100 at once. Key endpoints:POST /tweet-info, POST /tweet-info-bulk, POST /user-tweets, POST /comments, POST /quotes, POST /retweets, POST /article
Search
Run query-based search across tweets and users with full support for X Advanced Search syntax (from:, to:, since:, until:, hashtags, and more), plus dedicated mention tracking. Build queries visually with the free Search Builder, and see the full Search Operators reference.
Key endpoints: POST /search-tweets, POST /mentions, POST /search-users
Verification
Validate whether specific social actions have occurred - follow, comment, quote, retweet, or community membership. Useful for access gating and marketing campaign verification. Key endpoints:POST /check-follow, GET /check-comment, POST /check-quoted, POST /check-retweet, POST /check-community-member
Lists
Retrieve members, followers, and tweet feeds from public X Lists. Key endpoints:GET /list-members, GET /list-followers, GET /list-tweets
Communities
Access X Communities content, membership data, and in-community search. Key endpoints:POST /community-tweets, POST /community-search-tweets, POST /community-members
Crypto and Web3 analytics
Track an account’s Sorsa Score (popularity among influencers, projects, and VCs), score changes over time, follower category breakdowns, top followers and followings by score, and new follow activity over the last 7 days. Key endpoints:GET /score, GET /score-changes, GET /followers-stats, GET /top-followers, GET /top-following, GET /new-followers-7d, GET /new-following-7d
Technical utilities
Resolve usernames to user IDs and back, extract IDs from profile links, and monitor your API quota usage. You can also convert IDs in the browser with the free ID Converter. Key endpoints:GET /username-to-id, GET /id-to-username, GET /link-to-id, GET /key-usage-info
Typical use cases
Brand and media monitoring. Track mentions, keywords, and sentiment around your brand or competitors in real time. Data pipelines. Export structured X data into BigQuery, PostgreSQL, S3, or any downstream data warehouse. Audience analysis. Map follower graphs, identify high-value connections, and analyze creator growth over time. Access gating and social verification. Confirm that users have completed social tasks (follow, retweet, comment, quote) before granting access to campaigns, token drops, or gated content. AI and LLM training data. Collect high-quality public conversational data for model fine-tuning, sentiment analysis, or research datasets. No-code and low-code automation. Connect Sorsa API to tools like Make (Integromat), Zapier, n8n, or Pipedream via HTTP request modules. Monitor accounts, trigger workflows on new mentions, or sync X data to spreadsheets and CRMs without writing code. For detailed implementation patterns and workflow examples, see the Use Cases Guide.Try it without code
You do not need to write a single line of code to explore Sorsa. The API Playground lets you call any endpoint from the browser, view live responses, and experiment with parameters before integrating. We also offer a set of free, ready-to-use tools built on top of the API:- Search Builder - construct advanced tweet search queries visually.
- ID Converter - convert between username, user ID, and profile link.
- Shadowban Check - test whether an account is shadowbanned.
- Media Downloader - download photos and videos from tweets.
- Compare Users - compare two accounts side by side on key metrics.
- Recent Followers - view an account’s latest followers.
- Engagement Calculator - estimate engagement rate from recent tweets.
What Sorsa API does not support
Sorsa is a read-only API focused on data extraction and analysis. It does not perform write operations on the X platform:- Posting tweets, replies, or direct messages
- Liking, bookmarking, or retweeting
- Following or unfollowing accounts
- Any action performed on behalf of a user account
Next steps
- Quickstart - Get your API key and make your first request
- Authentication - Learn how to authorize requests to the v3 API
- API Reference - Browse all 38 endpoints with parameters and response schemas
- Pricing - Understand available plans and request packages
- Rate Limits - Learn about usage quotas and throttling
- Use Cases Guide - Real-world implementation patterns and workflows