Complete API Reference: All Sorsa Endpoints
All Sorsa API endpoints are listed below, organized by category. Every endpoint uses the same base URL (https://api.sorsa.io/v3) and authenticates via the ApiKey header. Every call costs exactly 1 request from your quota regardless of which endpoint you use.
For detailed parameter tables, response schemas, and interactive testing, click the Docs link next to each endpoint. You can also test any endpoint without code using the API Playground.
Users Data
Endpoints for retrieving user profiles, follower/following lists, and account metadata.| Endpoint | Method | Description | Docs |
|---|---|---|---|
/info | GET | Full profile for a single account (bio, counts, verified status, avatar). Accepts username, user_id, or user_link. | Docs |
/info-batch | GET | Profiles for multiple accounts in one request. Accepts usernames[] or user_ids[]. | Docs |
/about | GET | Country, username change count, and last change date. | Docs |
/followers | GET | Paginated follower list with full profiles. Up to 200 users per page. | Docs |
/follows | GET | Paginated following list with full profiles. Up to 200 users per page. | Docs |
/verified-followers | GET | Paginated list of only verified followers. | Docs |
Tweets
Endpoints for retrieving tweet content, engagement metrics, replies, quotes, retweets, and long-form articles.| Endpoint | Method | Description | Docs |
|---|---|---|---|
/tweet-info | POST | Full data for a single tweet (text, metrics, author profile). Body: tweet_link. | Docs |
/tweet-info-bulk | POST | Full data for up to 100 tweets in one request. Body: tweet_links[]. | Docs |
/user-tweets | POST | Paginated timeline of a user’s tweets. Body: link or user_id. | Docs |
/comments | POST | Replies under a specific tweet. Body: tweet_link. | Docs |
/quotes | POST | Quote tweets of a specific tweet. Body: tweet_link. | Docs |
/retweets | POST | Users who retweeted a tweet (returns user profiles, not tweets). Body: tweet_link. | Docs |
/article | POST | Full content of an X Article (long-form post). Body: tweet_link. | Docs |
Search
Endpoints for searching tweets, mentions, and user profiles by keyword.| Endpoint | Method | Description | Docs |
|---|---|---|---|
/search-tweets | POST | Search tweets by keyword with full X operator support. Body: query, order, next_cursor. | Docs |
/mentions | POST | Tweets mentioning a specific handle, with engagement and date filters. Body: query, order, min_likes, min_retweets, min_replies, since_date, until_date. | Docs |
/search-users | POST | Search user profiles by keyword (matches bios, display names, handles). Body: query. | Docs |
Verification
Endpoints for checking whether a user performed a specific action (follow, retweet, comment, quote, community membership). Designed for campaign and giveaway verification.| Endpoint | Method | Description | Docs |
|---|---|---|---|
/check-follow | POST | Did a user follow a specific account? Body: project_handle/project_id + username/user_link/user_id. | Docs |
/check-comment | GET | Did a user comment on a specific tweet? Returns the comment tweet if found. Query: tweet_link + user_handle/user_id. | Docs |
/check-retweet | POST | Did a user retweet a specific tweet? Checks up to 100 retweets per request. Body: tweet_link + user identifier. | Docs |
/check-quoted | POST | Did a user quote a specific tweet? Returns status: quoted, retweet, or not_found. Body: tweet_link + user identifier. | Docs |
/check-community-member | POST | Is a user a member of a specific X Community? Body: community_id + user identifier. | Docs |
Community
Endpoints for accessing X Community data: member lists, tweet feeds, and in-community search.| Endpoint | Method | Description | Docs |
|---|---|---|---|
/community-tweets | POST | Tweet feed from a community. Body: community_id, order_by. | Docs |
/community-search-tweets | POST | Search tweets within a community by keyword. Body: community_link, query, order_by. | Docs |
/community-members | POST | Member list of a community with full profiles. Body: community_link. | Docs |
Lists
Endpoints for accessing X List data: member profiles, list subscribers, and the combined tweet feed.
Related guides: Lists & Communities | Real-Time Monitoring
Sorsa Score (Crypto Analytics)
Endpoints for crypto-specific analytics: influence scoring, follower categorization, and recent follow activity among crypto accounts in Sorsa’s database.| Endpoint | Method | Description | Docs |
|---|---|---|---|
/score | GET | Current Sorsa Score (crypto influence metric). Query: link/username/user_id. | Docs |
/score-changes | GET | Score delta over the last week and month. | Docs |
/followers-stats | GET | Follower breakdown: influencers, projects, VCs. | Docs |
/top-followers | GET | Top 20 followers ranked by Sorsa Score. | Docs |
/top-following | GET | Top 20 followed accounts ranked by Score. | Docs |
/new-followers-7d | GET | Crypto accounts that followed in the last 7 days. | Docs |
/new-following-7d | GET | Crypto accounts the user started following in the last 7 days. | Docs |
Technical Utilities
Endpoints for ID conversion and API key usage monitoring.| Endpoint | Method | Description | Docs |
|---|---|---|---|
/username-to-id/{handle} | GET | Convert a username to a permanent User ID. | Docs |
/id-to-username/{user_id} | GET | Convert a User ID to the current username. | Docs |
/link-to-id | GET | Extract User ID from a profile URL. Query: link. | Docs |
/key-usage-info | GET | Current request usage, remaining quota, and expiration date. No parameters. | Docs |
Data Models
Two core objects appear across all endpoints. For full details including field types and edge cases, see Response Format.User Object
Returned by/info, /followers, /follows, /search-users, and embedded in every tweet response as the user field.
| Field | Type | Description |
|---|---|---|
id | string | Permanent User ID (Snowflake) |
username | string | Current handle |
display_name | string | Display name |
description | string | Bio text |
location | string | Self-reported location |
created_at | string | Account creation date |
followers_count | integer | Follower count |
followings_count | integer | Following count |
favourites_count | integer | Total likes given |
tweets_count | integer | Total tweets posted |
media_count | integer | Media posts count |
verified | boolean | Verification status |
protected | boolean | Protected (private) account |
can_dm | boolean | DMs open |
possibly_sensitive | boolean | Sensitive content flag |
profile_image_url | string | Avatar URL |
profile_background_image_url | string | Banner image URL |
bio_urls | string[] | URLs extracted from bio |
pinned_tweet_ids | string[] | IDs of pinned tweets |
Tweet Object
Returned by/tweet-info, /search-tweets, /user-tweets, /comments, /quotes, /mentions, /list-tweets, and community tweet endpoints.
| Field | Type | Description |
|---|---|---|
id | string | Tweet ID (Snowflake) |
full_text | string | Complete tweet text |
created_at | string | Post timestamp |
lang | string | Language code |
likes_count | integer | Likes |
retweet_count | integer | Retweets |
reply_count | integer | Replies |
quote_count | integer | Quotes |
bookmark_count | integer | Bookmarks |
view_count | integer | Views |
conversation_id_str | string | Thread/conversation ID |
in_reply_to_tweet_id | string | Parent tweet ID (if reply) |
in_reply_to_username | string | Parent author (if reply) |
is_reply | boolean | Whether this is a reply |
is_quote_status | boolean | Whether this is a quote tweet |
is_replies_limited | boolean | Replies restricted by author |
user | User | Complete author profile |
entities | TweetEntity[] | Attached media entities |
quoted_status | Tweet | Nested quoted tweet (if quote) |
retweeted_status | Tweet | Nested retweeted tweet (if RT) |
TweetEntity Object
| Field | Type | Description |
|---|---|---|
type | string | Entity type |
link | string | Entity URL |
preview | string | Preview text |
Common Patterns
Authentication: All requests require theApiKey header. See Authentication.
Pagination: Endpoints returning lists use cursor-based pagination. Pass next_cursor (or cursor for some GET endpoints) from the previous response to fetch the next page. When the cursor is absent or null, you have reached the end. See Pagination.
Error format: All endpoints return { "message": "..." } for 400, 403, 404, and 500 errors. See Error Codes.
Rate limit: 20 requests per second on all plans. See Rate Limits.
Input flexibility: Most user-related endpoints accept three input formats: username, user_id, or user_link (profile URL). Provide exactly one.
Next steps
- Quickstart - Make your first API call in under a minute
- Response Format - Detailed field types, null handling, and object schemas
- Search Operators - Build advanced queries for
/search-tweets - Optimizing API Usage - Reduce request counts with batching, deduplication, and caching