# Sorsa Developer Platform

## Docs

- [AGENTS](https://docs.sorsa.io/AGENTS.md)
- [Audience Geography](https://docs.sorsa.io/Audience-Geography.md)
- [Competitor Analysis](https://docs.sorsa.io/Competitor-Analysis.md)
- [ID Conversion](https://docs.sorsa.io/ID-Conversion.md)
- [Marketing Campaign Verification](https://docs.sorsa.io/Marketing-Campaign-Verification.md)
- [Migration Guide: v2 → v3](https://docs.sorsa.io/Migration-Guide.md)
- [Welcome to Sorsa API](https://docs.sorsa.io/Welcome-to-Sorsa-API.md)
- [AI Docs](https://docs.sorsa.io/ai-docs.md)
- [Api Reference Guide](https://docs.sorsa.io/api-reference-guide.md)
- [/comments Get comments (replies) under a tweet](https://docs.sorsa.io/api-reference/beta-test/comments-get-comments-replies-under-a-tweet.md): Fetch the comments (replies) under a specific tweet. The request requires the tweet link and optionally a cursor for pagination. The response includes the comment info and a next_cursor for fetching additional comments if available.<br><br><b>WARNING!</b> This endpoint is in beta testing. Some comme…
- [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.
- [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`).
- [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.
- [/about Get info about a user's country, username changes](https://docs.sorsa.io/api-reference/get-data/about-get-info-about-a-users-country-username-changes.md): Get info about a user's account. Link or user_id is required. Returns country, username change count, and last username change time.
- [/community-tweets Get tweets from a community](https://docs.sorsa.io/api-reference/get-data/community-tweets-get-tweets-from-a-community.md): Retrieve tweets from a specified community by providing the community ID or url as a body parameter. You can also use the cursor for pagination to fetch additional tweets. The response includes tweet details, such as text, retweet count, favorite count, creation date, and user information. The next_…
- [/follows Get a list of user info a specified account follows](https://docs.sorsa.io/api-reference/get-data/follows-get-a-list-of-user-info-a-specified-account-follows.md): Retrieve a list of user info that the specified Twitter account follows. Provide either the account's handle or link as a query parameter. If order_by is empty, the results will be sorted by the following date of the account. Set order_by to "score", the results will be sorted by the score of the ac…
- [/handle-to-id/{user_handle} Get user ID from Twitter handle.](https://docs.sorsa.io/api-reference/get-data/handle-to-id-get-user-id-from-twitter-handle.md): Retrieve the unique user ID associated with a specified Twitter handle. The request requires the "handle" parameter to be provided in the query.
- [/id-to-handle/{user_id} Get Twitter handle from user ID.](https://docs.sorsa.io/api-reference/get-data/id-to-handle-get-twitter-handle-from-user-id.md): Retrieve the Twitter handle associated with a specified user ID. The request requires the "id" parameter to be provided in the query.
- [/info/{user_handle} Get basic Twitter account information by user handle](https://docs.sorsa.io/api-reference/get-data/info-get-basic-twitter-account-information-by-user-handle.md): Retrieve basic information for a specific Twitter account. The response includes avatar, banner, description, followers count, follows count, account ID, name, registration date, screen name, status count, and verification status.
- [/info-id/{user_id} Get basic Twitter account information by user id](https://docs.sorsa.io/api-reference/get-data/info-id-get-basic-twitter-account-information-by-user-id.md): Retrieve basic information for a specific Twitter account. The response includes avatar, banner, description, followers count, follows count, account ID, name, registration date, screen name, status count, and verification status.
- [/list-members Get members of a Twitter list](https://docs.sorsa.io/api-reference/get-data/list-members-get-members-of-a-twitter-list.md): Retrieve the members of a specified Twitter list by providing the list ID as a query parameter. The response returns basic information about the members, including their avatar, ID, name, and handle
- [/list-tweets Get tweets from a Twitter list](https://docs.sorsa.io/api-reference/get-data/list-tweets-get-tweets-from-a-twitter-list.md): Retrieve tweets from a specified Twitter list by providing the list ID as a query parameter. You can also use the cursor for pagination to fetch additional tweets. The response includes tweet details, such as text, retweet count, favorite count, creation date, and user information. The next_cursor i…
- [/search-tweets Search for tweets using a specific query](https://docs.sorsa.io/api-reference/get-data/search-tweets-search-for-tweets-using-a-specific-query.md): Retrieve tweets that match a specific query, replicating Twitter’s search functionality. The request requires a “query” parameter to specify the search terms and accepts an optional “next_cursor” for paginating through additional tweets. The response includes a list of tweets with details such as te…
- [/search-users earch for Twitter users by keyword.](https://docs.sorsa.io/api-reference/get-data/search-users-earch-for-twitter-users-by-keyword.md): This endpoint allows you to search for Twitter accounts using a keyword or phrase. The request requires a "query" parameter with the search term. The response includes a list of matching users with basic profile information such as handle, user ID, name, avatar, and description. Results are sorted b…
- [/tweet-info-bulk Return tweet info from multiple tweet links](https://docs.sorsa.io/api-reference/get-data/tweet-info-bulk-return-tweet-info-from-multiple-tweet-links.md): The response returns an array of tweet information, each containing the tweet text, user ID, engagement metrics (retweets, favorites, replies, etc.), and other tweet metadata for each provided tweet link.<br><br>UP TO 100 TWEETS PER REQUEST
- [/tweet-info Get user ID and tweet text from a tweet link.](https://docs.sorsa.io/api-reference/get-data/tweet-info-get-user-id-and-tweet-text-from-a-tweet-link.md): Retrieve the user ID and tweet text from a specific tweet by providing the tweet link and user handle in the request body. The response returns the tweet text and the corresponding user ID.
- [/user-tweets Retrieve info of a user's tweets](https://docs.sorsa.io/api-reference/get-data/user-tweets-retrieve-info-of-a-users-tweets.md): Fetch the info of tweets posted by a specified user. The request requires the user's link and optionally a cursor for pagination. The response includes the tweet texts and a next_cursor for fetching additional tweets if available.
- [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`.
- [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…
- [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 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.
- [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.
- [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.
- [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.
- [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.
- [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`.
- [/followers-stats Get number of followers for each category on TweetScout](https://docs.sorsa.io/api-reference/tweetscout-info/followers-stats-get-number-of-followers-for-each-category-on-tweetscout.md): Get statistics on the number of followers by TweetScout categories: influencers, projects and VC employees. This endpoint receives data in real time, so it may take some time to respond especially for accounts with a large number of followers.<br>If we have information about the account in our datab…
- [/handle-history Get the history of Twitter handles.](https://docs.sorsa.io/api-reference/tweetscout-info/handle-history-get-the-history-of-twitter-handles.md): Retrieve the history of Twitter handles for a specified account. The response includes an array of objects with the date and handle for each change. If the account is not found in the database, the endpoint returns a 404 status. The request requires the user ID or current handle as input.
- [/new-following-7d Get a list of new followes Twitter account from past 7 days](https://docs.sorsa.io/api-reference/tweetscout-info/new-following-7d-get-a-list-of-new-followes-twitter-account-from-past-7-days.md): This endpoint returns a list of accounts that the specified Twitter account has followed in the last 7 days. The request requires either the account handle or user ID. The response includes a list of followed accounts with their user ID, handle, and follow date. If the account hasn't followed anyone…
- [/score-changes Get score stats](https://docs.sorsa.io/api-reference/tweetscout-info/score-changes-get-score-stats.md): This endpoint retrieves a stats of score delta. Use username or ID of twitter account. This endpoint work with our DB, user does exists on our website
- [/score/{user_handle} Get info on score of account on TweetScout](https://docs.sorsa.io/api-reference/tweetscout-info/score-get-info-on-score-of-account-on-tweetscout.md): Get info on score of account on TweetScout. Score is a metric that estimates an account's popularity among Influencers, Projects, and VCs. The higher the Score the better. This endpoint may take some time to respond especially for accounts with a large number of followers
- [/score-id/{user_id} Get info on score of account by ID on TweetScout](https://docs.sorsa.io/api-reference/tweetscout-info/score-id-get-info-on-score-of-account-by-id-on-tweetscout.md): Get info on score of account on TweetScout. Score is a metric that estimates an account's popularity among Influencers, Projects, and VCs. The higher the Score the better. This endpoint may take some time to respond especially for accounts with a large number of followers
- [/top-followers/{user_handle} Get top 20 account followers by TweetScout score](https://docs.sorsa.io/api-reference/tweetscout-info/top-followers-get-top-20-account-followers-by-tweetscout-score.md): This endpoint returns basic account information and score for the top 20 followers with the highest score. If speed is more important to you, use endpoint /top-followers?from=db
- [/top-following/{user_handle} Get top 20 account follows by TweetScout score](https://docs.sorsa.io/api-reference/tweetscout-info/top-following-get-top-20-account-follows-by-tweetscout-score.md): This endpoint returns basic account information and score for the top 20 follows with the highest score.
- [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`.
- [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-comment Check if the user posted a comment under the tweet](https://docs.sorsa.io/api-reference/verification/check-comment-check-if-the-user-posted-a-comment-under-the-tweet.md): Check if the user posted a comment under the tweet. Returns 'true' or 'false'
- [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-follow Check if the user follows the account](https://docs.sorsa.io/api-reference/verification/check-follow-check-if-the-user-follows-the-account.md): Check if the user follows the account. Returns "true" or "false"<br>
- [/check-member Checks if a given user is a member of a specified community.](https://docs.sorsa.io/api-reference/verification/check-member-checks-if-a-given-user-is-a-member-of-a-specified-community.md): This endpoint verifies whether a user belongs to a particular community. It accepts either a community ID or URL, and a user handle or user link or user id, then returns a boolean flag indicating membership status.
- [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-quoted Check if a user quoted or retweeted a tweet](https://docs.sorsa.io/api-reference/verification/check-quoted-check-if-a-user-quoted-or-retweeted-a-tweet.md): Check if a user has quoted or retweeted a specific tweet. The response includes the quoted text, retweet date, and the status (retweet, quoted, or not found).
- [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-retweet Check if a user retweeted a tweet (100 retweets per request)](https://docs.sorsa.io/api-reference/verification/check-retweet-check-if-a-user-retweeted-a-tweet-100-retweets-per-request.md): Check if a user has retweeted a specific tweet by checking up to 100 retweets per request. Use next_cursor to paginate through additional retweets.
- [/when-follow Get date when one account followed another.](https://docs.sorsa.io/api-reference/verification/when-follow-get-date-when-one-account-followed-another.md): Get date when one account followed another. Attention: This only works if both accounts were already in our database.<br>Returns follow date (or the date the account was added to our database, in which case the response will be "Before xx.xx.xxxx"). If the account is not following, it returns False.
- [Authentication](https://docs.sorsa.io/authentication.md)
- [Base URL & Versioning](https://docs.sorsa.io/base-url-and-versioning.md)
- [Error Codes](https://docs.sorsa.io/error-codes.md)
- [Followers & Following](https://docs.sorsa.io/followers-and-following.md)
- [Historical Data](https://docs.sorsa.io/historical-data.md)
- [Lists & Communities](https://docs.sorsa.io/lists-and-communities.md)
- [Migration from official X API](https://docs.sorsa.io/migration-from-official-x-api.md)
- [Optimizing API Usage](https://docs.sorsa.io/optimizing-api-usage.md)
- [Pagination](https://docs.sorsa.io/pagination.md)
- [Pricing](https://docs.sorsa.io/pricing.md)
- [Quickstart](https://docs.sorsa.io/quickstart.md)
- [Rate Limits](https://docs.sorsa.io/rate-limits.md)
- [Real-Time Monitoring](https://docs.sorsa.io/real-time-monitoring.md)
- [Response Format](https://docs.sorsa.io/response-format.md)
- [Track Mentions](https://docs.sorsa.io/search-mentions.md)
- [Search Operators](https://docs.sorsa.io/search-operators.md)
- [Search Tweets](https://docs.sorsa.io/search-tweets.md)
- [Sorsa Score & Crypto Analytics](https://docs.sorsa.io/sorsa-score-and-crypto-analytics.md)
- [Support](https://docs.sorsa.io/support.md)
- [Target Audience Discovery](https://docs.sorsa.io/target-audiences-Discovery.md)
- [Tweet Engagement](https://docs.sorsa.io/tweet-engagement.md)
- [Use Cases Overview](https://docs.sorsa.io/use-cases-overview.md)
- [X Articles](https://docs.sorsa.io/x-articles.md)

## OpenAPI Specs

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


Built with [Mintlify](https://mintlify.com).