# Sorsa Developer Platform

## Docs

- [Welcome to Sorsa API](https://docs.sorsa.io/Welcome-to-Sorsa-API.md)
- [Quickstart](https://docs.sorsa.io/quickstart.md): Get your API key and make your first request to the X (Twitter) API in minutes.
- [Base URL & Versioning](https://docs.sorsa.io/base-url-and-versioning.md)
- [Authentication](https://docs.sorsa.io/authentication.md)
- [Pricing](https://docs.sorsa.io/pricing.md)
- [Use Cases Overview](https://docs.sorsa.io/use-cases-overview.md)
- [AI Docs](https://docs.sorsa.io/ai-docs.md)
- [Rate Limits](https://docs.sorsa.io/rate-limits.md): Sorsa uses one simple rate limit: 20 requests per second on every plan. Here is how it works and how to stay within it.
- [Error Codes](https://docs.sorsa.io/error-codes.md): What each Sorsa API status code means, what causes it, and how to fix it, from 400 to 500.
- [Response Format](https://docs.sorsa.io/response-format.md)
- [Pagination](https://docs.sorsa.io/pagination.md)
- [Api Reference Guide](https://docs.sorsa.io/api-reference-guide.md)
- [Search Tweets](https://docs.sorsa.io/search-tweets.md): POST endpoint for keyword and operator-based tweet search on X (Twitter).
- [Search Operators](https://docs.sorsa.io/search-operators.md)
- [Track Mentions](https://docs.sorsa.io/search-mentions.md)
- [Followers & Following](https://docs.sorsa.io/followers-and-following.md)
- [Historical Data](https://docs.sorsa.io/historical-data.md)
- [Tweet Engagement](https://docs.sorsa.io/tweet-engagement.md)
- [Real-Time Monitoring](https://docs.sorsa.io/real-time-monitoring.md)
- [Marketing Campaign Verification](https://docs.sorsa.io/Marketing-Campaign-Verification.md)
- [Tweet Engagement](https://docs.sorsa.io/target-audiences-Discovery.md)
- [Competitor Analysis](https://docs.sorsa.io/Competitor-Analysis.md)
- [Audience Geography](https://docs.sorsa.io/Audience-Geography.md)
- [Lists & Communities](https://docs.sorsa.io/lists-and-communities.md)
- [ID Conversion](https://docs.sorsa.io/ID-Conversion.md)
- [Optimizing API Usage](https://docs.sorsa.io/optimizing-api-usage.md)
- [X Articles](https://docs.sorsa.io/x-articles.md)
- [Sorsa Score & Crypto Analytics](https://docs.sorsa.io/sorsa-score-and-crypto-analytics.md)
- [Migration from Official X API](https://docs.sorsa.io/migration-from-official-x-api.md)
- [Support](https://docs.sorsa.io/support.md)
- [Account About Info](https://docs.sorsa.io/api-reference/users-data/account-about-info.md): Returns metadata from the "About" section of a Twitter/X account, including country, total number of username changes, and the date of the most recent change. Identify the user by providing exactly one of: `user_link`, `username`, or `user_id`.
- [Followers](https://docs.sorsa.io/api-reference/users-data/followers.md): Returns a paginated list of users who follow the specified account. Up to 200 user profiles per page. Use the returned `next_cursor` to load subsequent pages. Identify the user by providing exactly one of: `user_link`, `username`, or `user_id`.
- [Following](https://docs.sorsa.io/api-reference/users-data/following.md): Returns a paginated list of accounts that the specified user follows. Up to 200 user profiles per page. Use the returned `next_cursor` to load subsequent pages. Identify the user by providing exactly one of: `user_link`, `username`, or `user_id`.
- [User Profile](https://docs.sorsa.io/api-reference/users-data/user-profile.md): Returns the public profile of a Twitter/X account, including display name, bio, follower and following counts, tweet count, avatar, account creation date, and verification status. Identify the user by providing exactly one of: `user_link`, `username`, or `user_id`.
- [User Profile (Batch)](https://docs.sorsa.io/api-reference/users-data/user-profile-batch.md): Returns public profile data for multiple Twitter/X accounts in a single request. Works the same way as the single-user endpoint, but accepts arrays of usernames or user IDs. Up to 100 accounts per request. Provide either `usernames` or `user_ids`.
- [Verified Followers](https://docs.sorsa.io/api-reference/users-data/verified-followers.md): Returns a paginated list of verified users who follow the specified account. Works the same way as the regular followers endpoint, but filters to only include accounts with a verified badge. Identify the user by providing exactly one of: `user_link`, `username`, or `user_id`.
- [Article Data](https://docs.sorsa.io/api-reference/tweets/article-data.md): Returns full data for a Twitter/X Article (long-form post) by its URL. The response includes the complete article text, a short preview excerpt, cover image URL, publication date, engagement metrics, and the author's profile.
- [Tweet Comments](https://docs.sorsa.io/api-reference/tweets/tweet-comments.md): Returns a paginated list of replies (comments) posted under a specific tweet. Up to 20 replies per page. Each reply includes text, creation date, engagement metrics, conversation context, and the author's profile.
- [Quote Tweets](https://docs.sorsa.io/api-reference/tweets/quote-tweets.md): Returns a paginated list of tweets that quoted the specified tweet. Up to 20 results per page. Each quote tweet includes the added commentary text, creation date, engagement metrics, and the quoting user's profile.
- [Retweeters List](https://docs.sorsa.io/api-reference/tweets/retweeters-list.md): Returns a paginated list of users who retweeted the specified tweet, sorted by retweet time (newest first). Each entry contains the retweeter's profile data. Note: the response uses the users format (`common.UsersResponse`), not tweets.
- [Trends List](https://docs.sorsa.io/api-reference/tweets/trends-list.md): Returns a list of trending topics for the specified WOEID (location identifier). Each trend contains its name and search query for the region. Useful for monitoring popular topics by location.
- [Tweet Data](https://docs.sorsa.io/api-reference/tweets/tweet-data.md): Returns full data for a single tweet by its URL: text, creation date, language, engagement metrics (likes, retweets, quotes, replies, views, bookmarks), and the author's profile. If the tweet is a reply, quote, or repost, the nested original tweet and its author data are included as well.
- [Tweet Data (Batch)](https://docs.sorsa.io/api-reference/tweets/tweet-data-batch.md): Returns full data for up to 100 tweets in a single request. Each tweet object includes text, creation date, engagement metrics, and author profile. Works the same way as the single-tweet endpoint, but accepts an array of URLs. The response is not paginated.
- [User Tweets](https://docs.sorsa.io/api-reference/tweets/user-tweets.md): Returns a paginated list of tweets posted by a specific user. Up to 20 tweets per page. Each tweet includes text, creation date, engagement metrics, view count, and nested data for replies, quotes, and retweets when available. Provide either `link` (profile URL) or `user_id`.
- [Check Comment](https://docs.sorsa.io/api-reference/verification/check-comment.md): Checks whether a specific user has posted a reply under a given tweet. Returns `commented: true` along with the full reply tweet data if a comment is found. Requires `tweet_link` and one of `user_handle` or `user_id`.
- [Check Community Membership](https://docs.sorsa.io/api-reference/verification/check-community-membership.md): Checks whether a specific user is a member of a given Twitter/X Community. Returns `is_member: true` if the user belongs to that community. Requires `community_id` and one user identifier (`username`, `user_link`, or `user_id`).
- [Check Follow](https://docs.sorsa.io/api-reference/verification/check-follow.md): Checks if one account follows another. User 1 is the account that should be followed, User 2 is the one you want to check. For example: "Does Elon Musk (user_2) follow SorsaApp (user_1)?" Pass only one identifier per side: link, username, or ID. Returns follow: true if the relationship exists, and u…
- [Check Quote or Retweet](https://docs.sorsa.io/api-reference/verification/check-quote-or-retweet.md): Checks whether a user has quoted or retweeted a given tweet. Returns a `status` field with one of three values: `quoted`, `retweet`, or `not_found`. If a quote or retweet is found, the response also includes the interaction date and the quote text (when applicable). Identify the user with `username`…
- [Check Retweet](https://docs.sorsa.io/api-reference/verification/check-retweet.md): Checks whether a user has retweeted a given tweet. The endpoint scans up to 100 retweets per request. If the tweet has more retweets than that, a `next_cursor` is returned to continue checking. Identify the user with `username`, `user_link`, or `user_id`.
- [Check Shadowban](https://docs.sorsa.io/api-reference/verification/check-shadowban.md): Checks whether a Twitter/X account is restricted in visibility. Runs two independent measurements: `search_suggestion_ban` — whether the account appears in search suggestions when its exact handle is typed — and `search_ban` — whether its posts are returned by search. Each check reports `clean`, `ba…
- [Community Members](https://docs.sorsa.io/api-reference/community/community-members.md): Returns a paginated list of user profiles for members of the specified Twitter/X Community. Each profile includes display name, bio, follower stats, avatar, account creation date, and verification status.
- [Search Community Tweets](https://docs.sorsa.io/api-reference/community/search-community-tweets.md): Searches for tweets within a specific Twitter/X Community by keyword. Up to 20 matching tweets per page. Results can be sorted by `popular` or `latest`. Each tweet includes text, creation date, engagement metrics, and author profile.
- [Community Tweets](https://docs.sorsa.io/api-reference/community/community-tweets.md): Returns a paginated feed of tweets published inside the specified Twitter/X Community. Up to 20 tweets per page. Each tweet includes text, creation date, engagement metrics, and author profile. Results can be sorted by `popular` or `latest` (default: `latest`).
- [Follower Category Stats](https://docs.sorsa.io/api-reference/sorsa-info-crypto-related/follower-category-stats.md): Returns a breakdown of the account's followers by Sorsa category: influencers, projects, and VC (venture capital) employees. Also indicates whether the account is protected. If the account is already indexed in the Sorsa database, the response is fast. For new accounts, the initial data collection m…
- [New Followers (7 Days)](https://docs.sorsa.io/api-reference/sorsa-info-crypto-related/new-followers-7-days.md): Returns accounts that started following the specified user in the last 7 days. Both the target account and the returned followers must be present in the Sorsa database, which primarily tracks crypto-related accounts (influencers, projects, VCs). This means the results do not represent all new follow…
- [New Following (7 Days)](https://docs.sorsa.io/api-reference/sorsa-info-crypto-related/new-following-7-days.md): Returns accounts that the specified user started following in the last 7 days. Both the target account and the returned followings must be present in the Sorsa database, which primarily tracks crypto-related accounts (influencers, projects, VCs). This means the results do not represent all new follo…
- [Sorsa Score](https://docs.sorsa.io/api-reference/sorsa-info-crypto-related/sorsa-score.md): Returns the Sorsa Score for a Twitter/X account. The score is a numeric value that estimates the account's recognition and popularity among crypto influencers, projects, and venture capital firms. A higher score indicates stronger visibility within the ecosystem. For accounts with a large follower b…
- [Sorsa Score Changes](https://docs.sorsa.io/api-reference/sorsa-info-crypto-related/sorsa-score-changes.md): Returns the change in Sorsa Score over the last 7 days and the last 30 days. Useful for tracking momentum and identifying accounts that are gaining or losing influence. The account must already be indexed in the Sorsa database. Identify the user by providing exactly one of: `user_link`, `username`,…
- [Top 20 Followers by Score](https://docs.sorsa.io/api-reference/sorsa-info-crypto-related/top-20-followers-by-score.md): Returns the 20 followers of the specified account with the highest Sorsa Score. Each entry includes the follower's profile data and follow date. Useful for identifying the most influential accounts in a user's audience. Identify the user by providing exactly one of: `user_link`, `username`, or `user…
- [Top 20 Following by Score](https://docs.sorsa.io/api-reference/sorsa-info-crypto-related/top-20-following-by-score.md): Returns the 20 accounts that the specified user follows with the highest Sorsa Score. Each entry includes profile data and follow date. Useful for understanding whose content and activity the user values most within the ecosystem. Identify the user by providing exactly one of: `user_link`, `username…
- [Convert User ID to Username](https://docs.sorsa.io/api-reference/technical-endpoints/convert-user-id-to-username.md): Converts a numeric Twitter/X user ID into the account's current username. Useful for resolving stored IDs back into human-readable handles, especially when usernames may have changed.
- [API Key Usage](https://docs.sorsa.io/api-reference/technical-endpoints/api-key-usage.md): Returns usage statistics for the current API key: total allocated requests, remaining balance, and the expiration date of the current request quota. No parameters required; the key is read from the `ApiKey` header.
- [Convert Profile Link to User ID](https://docs.sorsa.io/api-reference/technical-endpoints/convert-profile-link-to-user-id.md): Extracts the stable numeric user ID from a Twitter/X profile URL. Useful for normalizing profile links into consistent identifiers before making further API calls.
- [Convert Username to User ID](https://docs.sorsa.io/api-reference/technical-endpoints/convert-username-to-user-id.md): Converts a Twitter/X username into the corresponding stable numeric user ID. Unlike usernames, user IDs never change, making them reliable for long-term storage and cross-referencing.
- [List Followers](https://docs.sorsa.io/api-reference/lists/list-followers.md): Returns a paginated list of users who follow (are subscribed to) the specified Twitter/X List. Each entry contains the follower's profile data.
- [List Members](https://docs.sorsa.io/api-reference/lists/list-members.md): Returns user profiles for all accounts included in the specified Twitter/X List. Each profile contains display name, bio, follower stats, avatar, and verification status.
- [List Tweets](https://docs.sorsa.io/api-reference/lists/list-tweets.md): Returns a paginated feed of tweets published by members of the specified Twitter/X List. Up to 20 tweets per page. Each tweet includes text, creation date, engagement metrics, and basic author information.
- [Search Mentions](https://docs.sorsa.io/api-reference/search/search-mentions.md): Returns tweets that mention the specified user handle. Up to 20 results per page, sorted by mention time (newest first by default). Supports the richest set of filters among all search endpoints: minimum likes, replies, retweets, and a date range. Results can also be sorted by `popular` or `latest`.
- [Search Tweets](https://docs.sorsa.io/api-reference/search/search-tweets.md): Searches for tweets matching a text query using the same syntax as Twitter/X Advanced Search. Supports operators such as `from:`, `to:`, `since:`, `until:`, exact phrases in quotes, and hashtags. Returns up to 20 results per page, sortable by `popular` or `latest`. For a full list of supported query…
- [Search Users](https://docs.sorsa.io/api-reference/search/search-users.md): Searches for Twitter/X accounts by a keyword or phrase. Returns matching user profiles with basic info: handle, display name, bio, follower stats, and verification status. Supports pagination via `next_cursor`.
- [Spaces Information](https://docs.sorsa.io/api-reference/search/spaces-information.md): Returns detailed information about a Twitter Space by its ID. Includes the Space's metadata (title, current state, scheduled start time), full creator profile, and participant breakdown by role: admins, speakers, and listeners. Also exposes access settings such as lock status, join restrictions, and…
- [AGENTS](https://docs.sorsa.io/AGENTS.md)

## OpenAPI Specs

- [swagger](https://api.sorsa.io/v3/swagger.json)
- [document(1)](https://docs.sorsa.io/document(1).json)
- [openapi](https://docs.sorsa.io/v3/openapi.json)