{"components":{"schemas":{"common.Follower":{"properties":{"bio_urls":{"items":{"type":"string"},"type":"array"},"can_dm":{"type":"boolean"},"created_at":{"type":"string"},"description":{"type":"string"},"display_name":{"type":"string"},"favourites_count":{"type":"integer"},"followerDate":{"type":"string"},"followers_count":{"type":"integer"},"followings_count":{"type":"integer"},"id":{"type":"string"},"media_count":{"type":"integer"},"pinned_tweet_ids":{"items":{"type":"string"},"type":"array"},"possibly_sensitive":{"type":"boolean"},"profile_background_image_url":{"type":"string"},"profile_image_url":{"type":"string"},"protected":{"type":"boolean"},"tweets_count":{"type":"integer"},"username":{"type":"string"},"verified":{"type":"boolean"}},"type":"object"},"common.FollowersResponse":{"properties":{"users":{"items":{"$ref":"#/components/schemas/common.Follower"},"type":"array"}},"type":"object"},"common.Tweet":{"properties":{"bookmark_count":{"type":"integer"},"conversation_id_str":{"type":"string"},"created_at":{"type":"string"},"entities":{"items":{"$ref":"#/components/schemas/common.TweetEntity"},"type":"array"},"full_text":{"type":"string"},"id":{"type":"string"},"in_reply_to_tweet_id":{"type":"string"},"in_reply_to_username":{"type":"string"},"is_quote_status":{"type":"boolean"},"is_replies_limited":{"type":"boolean"},"is_reply":{"type":"boolean"},"lang":{"type":"string"},"likes_count":{"type":"integer"},"quote_count":{"type":"integer"},"quoted_status":{"$ref":"#/components/schemas/common.Tweet"},"reply_count":{"type":"integer"},"retweet_count":{"type":"integer"},"retweeted_status":{"$ref":"#/components/schemas/common.Tweet"},"user":{"$ref":"#/components/schemas/common.User"},"view_count":{"type":"integer"}},"type":"object"},"common.TweetEntity":{"properties":{"link":{"type":"string"},"preview":{"type":"string"},"type":{"type":"string"}},"type":"object"},"common.TweetsBulkResponse":{"properties":{"tweets":{"items":{"$ref":"#/components/schemas/common.Tweet"},"type":"array"}},"type":"object"},"common.TweetsResponse":{"properties":{"next_cursor":{"type":"string"},"tweets":{"items":{"$ref":"#/components/schemas/common.Tweet"},"type":"array"}},"type":"object"},"common.User":{"properties":{"bio_urls":{"items":{"type":"string"},"type":"array"},"can_dm":{"type":"boolean"},"created_at":{"type":"string"},"description":{"type":"string"},"display_name":{"type":"string"},"favourites_count":{"type":"integer"},"followers_count":{"type":"integer"},"followings_count":{"type":"integer"},"id":{"type":"string"},"location":{"type":"string"},"media_count":{"type":"integer"},"pinned_tweet_ids":{"items":{"type":"string"},"type":"array"},"possibly_sensitive":{"type":"boolean"},"profile_background_image_url":{"type":"string"},"profile_image_url":{"type":"string"},"protected":{"type":"boolean"},"tweets_count":{"type":"integer"},"username":{"type":"string"},"verified":{"type":"boolean"}},"type":"object"},"common.UsersResponse":{"properties":{"next_cursor":{"type":"string"},"users":{"items":{"$ref":"#/components/schemas/common.User"},"type":"array"}},"type":"object"},"community.CommunityMembersReq":{"properties":{"community_link":{"example":"1966045657589813686","type":"string"},"next_cursor":{"example":"123","type":"string"}},"required":["community_link"],"type":"object"},"community.CommunityTweetsReq":{"properties":{"community_id":{"example":"1966045657589813686","type":"string"},"next_cursor":{"example":"123","type":"string"},"order_by":{"example":"popular","type":"string"}},"required":["community_id"],"type":"object"},"community.SearchCommunityTweetsReq":{"properties":{"community_link":{"example":"https://x.com/i/communities/1966045657589813686","type":"string"},"next_cursor":{"example":"123","type":"string"},"order_by":{"example":"popular","type":"string"},"query":{"example":"elonmusk","type":"string"}},"required":["community_link"],"type":"object"},"handler.ErrorResponse":{"properties":{"message":{"type":"string"}},"type":"object"},"search.SearchMentionsReq":{"properties":{"min_likes":{"example":100,"type":"integer"},"min_replies":{"example":100,"type":"integer"},"min_retweets":{"example":100,"type":"integer"},"next_cursor":{"example":"JKHSJFHADUYJKSDy2y3u123","type":"string"},"order":{"example":"popular","type":"string"},"query":{"example":"elonmusk","type":"string"},"since_date":{"example":"2026-01-01","type":"string"},"until_date":{"example":"2026-01-01","type":"string"}},"type":"object"},"search.SearchTweetsReq":{"properties":{"next_cursor":{"example":"JKHSJFHADUYJKSDy2y3u123","type":"string"},"order":{"example":"popular","type":"string"},"query":{"example":"elonmusk","type":"string"}},"type":"object"},"search.SearchUsersReq":{"properties":{"next_cursor":{"example":"JKHSJFHADUYJKSDy2y3u123","type":"string"},"query":{"example":"elonmusk","type":"string"}},"type":"object"},"sorsa.FollowersStatsResp":{"properties":{"followers_count":{"example":16,"type":"integer"},"influencers_count":{"example":12,"type":"integer"},"projects_count":{"example":3,"type":"integer"},"user_protected":{"example":false,"type":"boolean"},"venture_capitals_count":{"example":1,"type":"integer"}},"type":"object"},"sorsa.ScoreChangesResp":{"properties":{"month_delta":{"example":24,"type":"number"},"week_delta":{"example":12,"type":"number"}},"type":"object"},"sorsa.ScoreResp":{"properties":{"score":{"example":1.25,"type":"number"}},"type":"object"},"technical.HandleRes":{"properties":{"handle":{"example":"elonmusk","type":"string"}},"type":"object"},"technical.IDRes":{"properties":{"id":{"example":"1","type":"string"}},"type":"object"},"technical.KeysResp":{"properties":{"key_requests":{"example":100,"type":"integer"},"remaining_requests":{"example":100,"type":"integer"},"total_requests":{"example":1000,"type":"integer"},"valid_until":{"example":"2021-01-01T00:00:00Z","type":"string"}},"type":"object"},"technical.LinkToIDResp":{"properties":{"id":{"type":"string"}},"type":"object"},"tweets.ArticleReq":{"properties":{"tweet_link":{"type":"string"}},"type":"object"},"tweets.ArticleRes":{"properties":{"author":{"$ref":"#/components/schemas/common.User"},"bookmark_count":{"type":"integer"},"cover_image_url":{"type":"string"},"favorite_count":{"type":"integer"},"full_text":{"type":"string"},"preview_text":{"type":"string"},"published_at":{"type":"string"},"quote_count":{"type":"integer"},"reply_count":{"type":"integer"},"retweet_count":{"type":"integer"},"views":{"type":"integer"}},"type":"object"},"tweets.CommentsReq":{"properties":{"next_cursor":{"example":"JKHSJFHADUYJKSDy2y3u123","type":"string"},"tweet_link":{"type":"string"}},"type":"object"},"tweets.QuotesReq":{"properties":{"next_cursor":{"example":"JKHSJFHADUYJKSDy2y3u123","type":"string"},"tweet_link":{"type":"string"}},"type":"object"},"tweets.RetweetsReq":{"properties":{"next_cursor":{"example":"JKHSJFHADUYJKSDy2y3u123","type":"string"},"tweet_link":{"type":"string"}},"type":"object"},"tweets.TweetInfoBulkReq":{"properties":{"tweet_links":{"items":{"type":"string"},"type":"array"}},"type":"object"},"tweets.TweetInfoReq":{"properties":{"tweet_link":{"type":"string"}},"type":"object"},"tweets.UserTweetsReq":{"properties":{"link":{"example":"https://twitter.com/username","type":"string"},"next_cursor":{"example":"ASDJKHFJWQE123Q","type":"string"},"user_id":{"example":"123","type":"string"}},"type":"object"},"usersdata.AboutRes":{"properties":{"country":{"example":"United States","type":"string"},"last_username_change_at":{"example":"2021-01-01T00:00:00Z","type":"string"},"username_change_count":{"example":1,"type":"integer"}},"type":"object"},"usersdata.InfoBatchRes":{"properties":{"users":{"items":{"$ref":"#/components/schemas/common.User"},"type":"array"}},"type":"object"},"verification.CheckCommentResp":{"properties":{"commented":{"type":"boolean"},"tweet":{"$ref":"#/components/schemas/common.Tweet"}},"type":"object"},"verification.CheckFollowReq":{"properties":{"project_handle":{"example":"tweetscout_io","type":"string"},"project_id":{"example":"940691529697554432","type":"string"},"user_id":{"example":"44196397","type":"string"},"user_link":{"example":"https://twitter.com/elonmusk","type":"string"},"username":{"example":"elonmusk","type":"string"}},"type":"object"},"verification.CheckFollowResp":{"properties":{"follow":{"example":true,"type":"boolean"},"user_protected":{"example":false,"type":"boolean"}},"type":"object"},"verification.CheckQuotedReq":{"properties":{"tweet_link":{"example":"https://twitter.com/TweetScout_io/status/1782368585664626774","type":"string"},"user_id":{"example":"44196397","type":"string"},"user_link":{"example":"https://twitter.com/elonmusk","type":"string"},"username":{"example":"elonmusk","type":"string"}},"type":"object"},"verification.CheckQuotedResp":{"properties":{"date":{"example":"2024-04-27 06:43:09","type":"string"},"status":{"example":"quoted","type":"string"},"text":{"example":"Quote text","type":"string"},"user_protected":{"example":false,"type":"boolean"}},"type":"object"},"verification.CheckRetweetReq":{"properties":{"next_cursor":{"type":"string"},"tweet_link":{"type":"string"},"user_id":{"type":"string"},"user_link":{"type":"string"},"username":{"type":"string"}},"type":"object"},"verification.CheckRetweetResp":{"properties":{"next_cursor":{"type":"string"},"retweet":{"type":"boolean"},"user_protected":{"type":"boolean"}},"type":"object"},"verification.CommunityReq":{"properties":{"community_id":{"example":"1966045657589813686","type":"string"},"user_id":{"type":"string"},"user_link":{"example":"https://twitter.com/elonmusk","type":"string"},"username":{"example":"elonmusk","type":"string"}},"required":["community_id"],"type":"object"},"verification.CommunityResp":{"properties":{"is_member":{"type":"boolean"}},"type":"object"}},"securitySchemes":{"ApiKeyAuth":{"in":"header","name":"ApiKey","type":"apiKey"}}},"info":{"contact":{},"title":"API Sorsa.io","version":"3.0"},"openapi":"3.0.3","paths":{"/about":{"get":{"description":"\u003cp\u003eReturns data from the “About” section of a Twitter/X account. The endpoint returns information such as the account’s country, number of username changes, and the date of the last username change. It may also include affiliation details, connection method, and identity verification status (for example, whether the account is ID-verified).\u003c/p\u003e\u003cp\u003eUse cases:\u003c/p\u003e\u003cp\u003eCompliance and risk tools checking username history and ID verification signals; analytics platforms tracking rebranding or frequent handle changes; marketing teams reviewing account background before partnerships; fraud detection systems flagging suspicious username change patterns; CRM systems enriching stored profiles with country and affiliation data.\u003c/p\u003e","parameters":[{"description":"user_link, username or user_id","in":"query","name":"user_link","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"username","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"user_id","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/usersdata.AboutRes"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"User About Info","tags":["Users Data"]}},"/article":{"post":{"description":"\u003cp\u003eReturns full data for a Twitter/X Article using its URL. You provide the article link, and the endpoint returns the full text content, publication date, engagement metrics, and basic author information. The response is structured so you can store, display, or analyze long-form content in a consistent format.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics platforms tracking performance of long-form posts; marketing teams reviewing article engagement and reach; research tools collecting long text content for analysis; monitoring systems archiving published articles with metrics; developers building article preview or detail views inside dashboards.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tweets.ArticleReq"}}},"description":"Article request","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tweets.ArticleRes"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Article info","tags":["Tweets"]}},"/check-comment":{"get":{"description":"\u003cp\u003eChecks whether a specific user has posted a reply under a given tweet. You provide the required user and tweet identifiers, and the endpoint returns a boolean commented value (true or false). If a comment is found, the response also includes the reply tweet data with its text, creation date, engagement metrics, and basic author information.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eCampaign tools verifying comment participation in contests; SaaS platforms enforcing “comment to unlock” actions; analytics systems validating engagement from specific users; moderation tools checking if a user replied under a flagged tweet; automation workflows triggering actions based on comment activity.\u003c/div\u003e","parameters":[{"description":"tweet_link, user_handle or user_id required","in":"query","name":"tweet_link","schema":{"type":"string"}},{"description":"tweet_link, user_handle or user_id required","in":"query","name":"user_handle","schema":{"type":"string"}},{"description":"tweet_link, user_handle or user_id required","in":"query","name":"user_id","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/verification.CheckCommentResp"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Comment Status Check","tags":["Verification"]}},"/check-community-member":{"post":{"description":"\u003cp\u003eChecks whether a specific user is a member of a given Twitter/X Community. You provide the community ID or URL, along with a user handle, profile link, or user ID. The endpoint returns a boolean is_member value indicating whether the user belongs to that community.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eSaaS products restricting features to community members; marketing tools verifying community participation before access to gated content; automation systems validating membership before triggering actions; analytics platforms checking overlap between users and specific communities; growth tools measuring conversion into community membership.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/verification.CommunityReq"}}},"description":"community_id and user_handle or user_id required","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/verification.CommunityResp"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Community Membership Check","tags":["Verification"]}},"/check-follow":{"post":{"description":"\u003cp\u003eChecks whether one Twitter/X user follows another account. You provide the required user identifiers in the request, and the endpoint returns afollow value (true or false)\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eSaaS products verifying follow conditions for gated access; marketing tools checking if influencers follow a brand account; automation systems validating follow relationships before triggering actions; CRM platforms enriching relationship data between accounts; growth tools measuring campaign-based follow conversions.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/verification.CheckFollowReq"}}},"description":"project_handle or project_id and user_link, username or user_id","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/verification.CheckFollowResp"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Follow Status Check","tags":["Verification"]}},"/check-quoted":{"post":{"description":"\u003cp\u003eChecks whether a specific user has quoted or retweeted a given tweet. You provide the required user and tweet identifiers, and the endpoint returns a status value (quoted, retweet, or not_found). If a quote or retweet is found, the response also includes the related date and quote text (if available).\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eCampaign tools verifying repost or quote participation in promotions; analytics platforms validating different types of engagement; automation systems triggering actions based on quote vs retweet behavior; fraud detection tools checking suspicious repost activity; SaaS products enforcing “quote or retweet to qualify” conditions.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/verification.CheckQuotedReq"}}},"description":"tweet link, user link, username or user_id","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/verification.CheckQuotedResp"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Quote Status Check","tags":["Verification"]}},"/check-retweet":{"post":{"description":"\u003cp\u003eChecks whether a specific user has retweeted a given tweet. The endpoint reviews up to 100 retweets per request. If more retweets need to be checked, a next_cursor is returned for pagination. The response includes a boolean retweet value (true or false).\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eCampaign tools verifying retweet participation in giveaways; analytics platforms validating engagement actions by specific users; automation systems triggering rewards based on retweet activity; fraud detection tools checking suspicious engagement patterns; SaaS products enforcing “retweet to unlock” conditions.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/verification.CheckRetweetReq"}}},"description":"tweet link, user handle required, next_cursor not required","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/verification.CheckRetweetResp"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Retweet Status Check","tags":["Verification"]}},"/comments":{"post":{"description":"\u003cp\u003eReturns replies (comments) under a specific tweet. You provide the tweet link, and the endpoint returns a list of reply tweets with their text, creation date, engagement metrics, conversation details, and basic author information. If more replies are available, a next_cursor is returned for pagination.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eCommunity management tools monitoring discussions under brand posts; analytics platforms measuring engagement and reply sentiment; moderation systems reviewing replies for spam or abuse; research tools collecting conversation threads for analysis; SaaS dashboards showing structured reply feeds under selected tweets.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tweets.CommentsReq"}}},"description":"tweet link required, next_cursor optional","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.TweetsResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Tweet Comments (replies) list","tags":["Tweets"]}},"/community-members":{"post":{"description":"\u003cp\u003eReturns basic public profile data for users who are members of a specific Twitter/X Community. You provide the community link or community ID, and the endpoint returns profile information for each member, such as display name, bio, follower and following counts, total posts, profile images, account creation date, and simple status flags like verification and DM availability. If more members are available, a next_cursor is returned to load the next page.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics tools tracking who joins a community and how the member base changes over time; marketing teams finding relevant users inside a niche community for outreach; community managers exporting member lists for reporting and segmentation; CRM systems importing community members as leads and enriching their profiles; research tools collecting structured profiles from specific communities for analysis.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/community.CommunityMembersReq"}}},"description":"Community members request","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.UsersResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Community Members","tags":["Community"]}},"/community-search-tweets":{"post":{"description":"\u003cp\u003eSearches for tweets inside a specific Twitter/X Community using a text query. You must provide the community_id and a query parameter. The endpoint returns up to 20 matching tweets per request from that community. Each result includes the tweet text, creation date, engagement metrics, conversation details, and basic author information. Results can be sorted by popular or latest. If more results are available, a next_cursor is returned to load the next page.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics platforms tracking keywords inside niche communities; marketing teams monitoring brand mentions within a specific community; research tools collecting topic-based discussions from selected communities; community dashboards adding keyword filtering; developers building in-community search with cursor pagination.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/community.SearchCommunityTweetsReq"}}},"description":"Search community tweets request","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.TweetsResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"/community-search-tweets","tags":["Community"]}},"/community-tweets":{"post":{"description":"\u003cp\u003eReturns tweets from a specific Twitter/X Community. You provide the community ID or link, and the endpoint returns tweets published inside that community. Each result includes the tweet text, creation date, engagement metrics, and basic author information. Results can be sorted by popular or latest. If the sorting parameter is not provided, the default order is latest. If more results are available, a next_cursor is returned to load the next page.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics platforms tracking activity inside niche communities; marketing teams monitoring discussions within industry-specific communities; research tools collecting posts from topic-based communities; community dashboards displaying structured feeds from selected communities; developers building community-based feeds with cursor pagination.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/community.CommunityTweetsReq"}}},"description":"community_id required, next_cursor optional, order_by optional","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.TweetsResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Community Tweets Feed","tags":["Community"]}},"/followers":{"get":{"parameters":[{"description":"user_link, username or user_id","in":"query","name":"user_link","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"username","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"user_id","schema":{"type":"string"}},{"description":"cursor","in":"query","name":"cursor","schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.UsersResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"/followers","tags":["Users Data"]}},"/followers-stats":{"get":{"description":"\u003cp\u003eReturns follower statistics for a Twitter/X account based on Sorsa categories. The response includes total followers and how many of them are classified as influencers, projects, or VC employees, plus whether the account is protected. If the account is already in our database, the response is usually fast. Otherwise, it may take longer because the data needs to be collected in real time, especially for accounts with a large follower base.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics dashboards breaking down audience composition; marketing teams checking whether an account is followed by influencers, projects, or VCs; research tools comparing audience quality across multiple accounts; growth teams monitoring changes in follower mix over time; SaaS products showing category stats next to a profile.\u003c/div\u003e","parameters":[{"description":"user_link, username or user_id required","in":"query","name":"user_link","schema":{"type":"string"}},{"description":"user_link, username or user_id required","in":"query","name":"username","schema":{"type":"string"}},{"description":"user_link, username or user_id required","in":"query","name":"user_id","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sorsa.FollowersStatsResp"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Follower Category Stats","tags":["Sorsa Info Crypto Related"]}},"/follows":{"get":{"parameters":[{"description":"user_link, username or user_id","in":"query","name":"user_link","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"username","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"user_id","schema":{"type":"string"}},{"description":"cursor","in":"query","name":"cursor","schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.UsersResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"/follows","tags":["Users Data"]}},"/id-to-username/{user_id}":{"get":{"description":"\u003cp\u003eReturns the current Twitter/X username for a given user ID. You provide the user ID, and the endpoint returns the corresponding username.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eDevelopers converting stored user IDs back into readable usernames; SaaS platforms displaying handles in dashboards while keeping IDs internally; analytics tools resolving IDs when exporting reports; automation systems syncing internal records with current usernames; CRM systems updating handles if a user has changed their username.\u003c/div\u003e","parameters":[{"description":"user_id required","in":"path","name":"user_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/technical.HandleRes"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"User ID to Username","tags":["Technical Endpoints"]}},"/info":{"get":{"description":"\u003cp\u003eReturns basic public profile data for a Twitter/X account using its handle (username), ID or link. This endpoint is used to read the display name, bio, follower and following counts, total posts, profile images, account creation date, and simple status flags such as verification and DM availability.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eSaaS products that show user cards with name, bio, and follower count; analytics tools that need quick account stats before deeper processing; marketing platforms checking audience size and verification status before outreach; CRM systems enriching stored handles with profile data; bot or fraud detection services validating basic account signals.\u003c/div\u003e","parameters":[{"description":"user_link, username or user_id","in":"query","name":"user_link","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"username","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"user_id","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.User"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"User Profile Info","tags":["Users Data"]}},"/info-batch":{"get":{"description":"\u003cp\u003eReturns basic public profile data for multiple Twitter/X accounts using their handles (usernames), IDs or links. This endpoint is used to read the display name, bio, follower and following counts, total posts, profile images, account creation date, and simple status flags such as verification and DM availability.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eSaaS products that show user cards with name, bio, and follower count; analytics tools that need quick account stats before deeper processing; marketing platforms checking audience size and verification status before outreach; CRM systems enriching stored handles with profile data; bot or fraud detection services validating basic account signals.\u003c/div\u003e","parameters":[{"description":"usernames","in":"query","name":"usernames","schema":{"items":{"type":"string"},"type":"array"}},{"description":"user_ids","in":"query","name":"user_ids","schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/usersdata.InfoBatchRes"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"User Profile Info (batch request)","tags":["Users Data"]}},"/key-usage-info":{"get":{"description":"\u003cp\u003eReturns usage statistics for the current API key. The response includes how many requests were allocated in total, how many remain, and the time when the current request balance becomes invalid (either the subscription period ends or the one-time package expires).\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eDevelopers checking quota before batch jobs; SaaS dashboards showing API usage in account settings; automation systems pausing tasks when quota is low; monitoring tools tracking consumption; billing/support teams answering “why requests stopped” questions.\u003c/div\u003e","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/technical.KeysResp"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Key Usage Info","tags":["Technical Endpoints"]}},"/link-to-id":{"get":{"description":"\u003cp\u003eReturns the Twitter/X user ID extracted from a profile URL. You provide the full profile link, and the endpoint returns the corresponding stable user ID.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eDevelopers converting profile URLs into user IDs before making other API requests; SaaS platforms normalizing different input formats (link vs handle vs ID); analytics tools processing scraped profile links into structured identifiers; automation systems resolving shared profile URLs into internal IDs; data pipelines standardizing user references for storage and further processing.\u003c/div\u003e","parameters":[{"description":"link required","in":"query","name":"link","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/technical.LinkToIDResp"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Profile Link to User ID","tags":["Technical Endpoints"]}},"/list-followers":{"get":{"description":"\u003cp\u003eReturns basic public profile data for users who follow a specific Twitter/X list. You provide the list ID, and the endpoint returns profile information for each follower, such as display name, bio, follower and following counts, total posts, profile images, account creation date, and simple status flags like verification and DM availability. If more followers are available, a next_cursor is returned to load the next page.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics tools measuring who is interested in a curated list and tracking list audience growth; marketing teams finding engaged users who follow competitor or influencer lists; community managers identifying potential members from list followers; CRM systems importing list followers as leads and enriching their profiles; research tools collecting structured profiles of users following specific topic lists.\u003c/div\u003e","parameters":[{"description":"list_link required, cursor optional","in":"query","name":"list_link","required":true,"schema":{"type":"string"}},{"description":"list id required, cursor optional","in":"query","name":"next_cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.UsersResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"List Followers","tags":["Lists"]}},"/list-members":{"get":{"description":"\u003cp\u003eReturns basic public profile data for accounts included in a specific Twitter/X list. You provide the list ID, and the endpoint returns profile information for each member, such as display name, bio, follower and following counts, total posts, profile images, account creation date, and simple status flags like verification and DM availability. If more members are available, a next_cursor is returned to load the next page.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003c/div\u003eSaaS products displaying member cards for curated lists; analytics tools analyzing audience size and profile stats of list members; marketing teams reviewing influencers or competitors grouped in a list; CRM systems importing structured profile data from thematic lists; research tools collecting structured account data from predefined user groups.\u003c/p\u003e","parameters":[{"description":"list_id required","in":"query","name":"list_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.UsersResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"List Members","tags":["Lists"]}},"/list-tweets":{"get":{"description":"\u003cp\u003eReturns tweets from a specific Twitter/X list. You provide the list ID, and the endpoint returns tweets published by accounts included in that list. Each result contains tweet text, creation date, engagement metrics, and basic author information. If more results are available, you can use next_cursor to load the next page.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics platforms tracking curated groups of accounts (for example, “top founders” or “crypto analysts” lists); marketing teams monitoring competitor or influencer lists; research tools collecting tweets from thematic lists; community dashboards displaying content from selected user groups; developers building list-based feeds with pagination support.\u003c/div\u003e","parameters":[{"description":"list_id required, cursor optional","in":"query","name":"list_id","required":true,"schema":{"type":"string"}},{"description":"list id required, cursor optional","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.TweetsResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"List Tweets Feed","tags":["Lists"]}},"/mentions":{"post":{"description":"\u003cp\u003eReturns tweets that mention a specific user, selected by the user’s handle. Results are sorted by mention time in descending order (newest first). Each page returns up to 20 mentions, and you can use next_cursor to load the next page. Each mention includes the tweet text and key metrics, plus basic author info.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eCustomer support teams tracking public replies and complaints about a brand account; community managers monitoring shoutouts and conversations around a project or founder; marketing teams measuring campaign mentions and finding UGC to repost; analytics tools collecting mentions over time for reporting and sentiment tagging; developers building a notifications-style mentions inbox with cursor pagination.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/search.SearchMentionsReq"}}},"description":"query required, next_cursor optional","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.TweetsResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Search for Mentions of account","tags":["Search"]}},"/new-followers-7d":{"get":{"description":"\u003cp\u003eReturns a list of accounts that have started following a specific Twitter/X user in the past 7 days. You can provide a handle or user ID. The response includes profile data for each new follower, along with the follow date. If no new followers are found, an empty list is returned. The requested account must exist in our database.\u003c/p\u003e\u003cp\u003eOnly accounts that are already present in our database are included in the response. This means the endpoint does not return all new followers, but only those tracked by our system.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics platforms tracking audience growth of monitored accounts; VC and research tools spotting when influencers or projects start following a founder; marketing teams identifying new high-value followers; SaaS dashboards highlighting recent follower activity; growth analysis tools detecting momentum and network expansion among tracked users.\u003c/div\u003e","parameters":[{"description":"user_link, username or user_id","in":"query","name":"user_link","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"username","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"user_id","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.FollowersResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"New Followers (Last 7 Days)","tags":["Sorsa Info Crypto Related"]}},"/new-following-7d":{"get":{"description":"\u003cp\u003eReturns a list of accounts that a specific Twitter/X user has started following in the past 7 days. You can provide a handle or user ID. The response includes profile data for each newly followed account, along with the follow date. If no new followings are found, an empty list is returned. The requested account must exist in our database.\u003c/p\u003e\u003cp\u003eOnly accounts that are already present in our database are included in the response. This means the endpoint does not return all followings, but only those tracked by our system.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics platforms tracking recent relationship changes between monitored accounts; VC and research tools spotting new strategic follows within a specific ecosystem; marketing teams identifying new partnerships or signals of interest; SaaS dashboards highlighting recent follow activity between tracked users; growth analysis tools detecting network expansion among selected accounts.\u003c/div\u003e","parameters":[{"description":"user_link, username or user_id","in":"query","name":"user_link","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"username","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"user_id","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.FollowersResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"New Followings (Last 7 Days)","tags":["Sorsa Info Crypto Related"]}},"/quotes":{"post":{"description":"\u003cp\u003eReturns quote tweets for a specific tweet. You provide the original tweet link, and the endpoint returns a list of tweets that quoted it. Each result includes the quote text, creation date, engagement metrics, conversation details, and basic author information. If more results are available, a next_cursor is returned for pagination.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eMarketing teams tracking how a post is being reshared with commentary; analytics platforms measuring reach and secondary engagement through quotes; community managers monitoring public reactions and discussions; research tools collecting quote tweets for sentiment or narrative analysis; SaaS dashboards displaying structured quote feeds for a selected tweet.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tweets.QuotesReq"}}},"description":"tweet link required, next_cursor optional","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.TweetsResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Tweet Quotes list","tags":["Tweets"]}},"/retweets":{"post":{"description":"\u003cp\u003eReturns the users who retweeted a specific tweet, selected by tweet id. Results are sorted by retweet time in descending order (newest first). If there are more results, you will also receive a next_cursor to load the next page. Each user item includes basic profile info like username, id, name, avatar, bio, and follower stats.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eMarketing teams finding accounts that reshared a campaign post for follow-up and audience research; analytics platforms measuring who amplifies content and building retweeter segments; community managers identifying active supporters and potential ambassadors; research tools exporting retweeter lists for network analysis; developers building “who retweeted this” views with cursor pagination.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tweets.RetweetsReq"}}},"description":"Retweets request","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.UsersResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Tweet Retweeters","tags":["Tweets"]}},"/score":{"get":{"description":"\u003cp\u003eReturns the Sorsa Score for a Twitter/X account. The score is a numeric value that estimates an account’s popularity among influencers, projects, and VCs. A higher score means stronger visibility and recognition within this ecosystem. You can request the score using a handle, profile link, or user ID. For accounts with a large number of followers, the response may take longer to generate.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics platforms ranking accounts by influence level; marketing teams evaluating creators or founders before outreach; VC or project research tools filtering accounts by ecosystem relevance; SaaS dashboards displaying influence metrics next to user profiles; scoring systems combining Sorsa Score with other engagement data.\u003c/div\u003e","parameters":[{"description":"link or user_id required","in":"query","name":"link","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"username","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"user_id","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sorsa.ScoreResp"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Account Score","tags":["Sorsa Info Crypto Related"]}},"/score-changes":{"get":{"description":"\u003cp\u003eReturns score change statistics for a Twitter/X account. You can provide a handle, profile link, or user ID. The endpoint returns the score delta for the last week and the last month. This data is based on records stored in our database, so the account must already exist in our system.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics platforms tracking influence growth over time; marketing teams monitoring creator momentum before partnerships; research tools identifying fast-growing accounts; SaaS dashboards showing weekly and monthly score trends; VC or ecosystem analysis tools spotting rising profiles.\u003c/div\u003e","parameters":[{"description":"user_link, username or user_id","in":"query","name":"user_link","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"username","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"user_id","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sorsa.ScoreChangesResp"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Score Changes","tags":["Sorsa Info Crypto Related"]}},"/search-tweets":{"post":{"description":"\u003cp\u003eWorks the same way as Advanced Search in Twitter/X.\u003c/p\u003e\u003cp\u003eSearches for tweets that match a given text query. You pass a query parameter, and the endpoint returns up to 20 matching tweets per request. Each result includes the tweet text, creation date, engagement metrics, conversation details, and basic author information.\u003c/p\u003e\u003cp\u003eResults can be sorted by popularorlatest. If more results are available, a next_cursor is returned to load the next page.\u003c/p\u003e\u003cp\u003eThe query syntax works the same way as Twitter/X Advanced Search. You can use operators like from:, to:, since:, until:, exact phrases, hashtags, and other filters to narrow down results if needed. For more examples of supported operators and query patterns, see: https://github.com/igorbrigadir/twitter-advanced-search\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics platforms tracking keywords and trends; marketing teams monitoring brand mentions or campaign phrases; research tools collecting filtered datasets (for example, tweets from a specific account during a date range); SaaS products building custom search dashboards; developers adding search functionality with cursor-based pagination.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/search.SearchTweetsReq"}}},"description":"query required, next_cursor optional","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.TweetsResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Search Tweets Advanced","tags":["Search"]}},"/search-users":{"post":{"description":"\u003cp\u003eSearches for Twitter/X users by a keyword or phrase. You pass a query, and the endpoint returns a list of matching accounts with basic profile info like handle, user id, name, avatar, bio, follower stats, and verification or protected status. If there are more results, you will also receive a next_cursor for pagination.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eSaaS products letting users find accounts inside an app; analysts researching people, projects, or brands by name keywords; marketing teams building lists of relevant creators or company accounts; CRM or enrichment tools turning a keyword into a set of candidate profiles; developers implementing autocomplete or “search people” with cursor paging./\u003cdiv\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/search.SearchUsersReq"}}},"description":"query required, next_cursor optional","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.UsersResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Search users by Keyword","tags":["Search"]}},"/top-followers":{"get":{"description":"\u003cp\u003eReturns the top 20 followers of a specific Twitter/X account ranked by Sorsa Score. You provide the user handle, and the endpoint returns basic profile information and the score for each of the highest-ranked followers.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics platforms identifying high-influence followers of a target account; marketing teams evaluating the quality of an account’s audience; VC and ecosystem research tools analyzing strong network connections; SaaS dashboards highlighting influential followers; growth analysis tools measuring audience strength beyond follower count.\u003c/div\u003e","parameters":[{"description":"user_link, username or user_id","in":"query","name":"user_link","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"username","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"user_id","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.FollowersResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Top Followers by Score","tags":["Sorsa Info Crypto Related"]}},"/top-following":{"get":{"description":"\u003cp\u003eReturns the top 20 accounts that a specific Twitter/X user follows, ranked by Sorsa Score. You provide the user handle, and the endpoint returns basic profile information and the score for each of the highest-ranked accounts the user is following.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics platforms identifying which high-influence accounts a user follows; marketing teams understanding a creator’s interests and network; VC and ecosystem research tools mapping strong connections and attention signals; SaaS dashboards highlighting the most relevant accounts in a user’s following list; growth analysis tools comparing who different accounts follow by score.\u003c/div\u003e","parameters":[{"description":"user_link, username or user_id","in":"query","name":"user_link","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"username","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"user_id","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.FollowersResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Top Following by Score","tags":["Sorsa Info Crypto Related"]}},"/tweet-info":{"post":{"description":"\u003cp\u003eReturns full tweet data using a tweet URL or tweet ID. You provide the tweet link (and related user handle if required), and the endpoint returns the tweet text, creation date, engagement metrics, conversation information, and basic author details. If the tweet is a reply, quote, or repost, related nested tweet and user data is also included.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics tools fetching engagement metrics for a specific post; marketing teams reviewing performance of campaign tweets; moderation systems analyzing individual tweets by URL; CRM or monitoring platforms enriching stored tweet links with full metadata; developers building “paste tweet link → show full data” features inside dashboards.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tweets.TweetInfoReq"}}},"description":"tweet link required","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.Tweet"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Tweet info","tags":["Tweets"]}},"/tweet-info-bulk":{"post":{"description":"\u003cp\u003eReturns full tweet data for multiple tweet URLs or tweet IDs in a single request. You provide up to 100 tweet links, and the endpoint returns an array of tweet objects. Each object includes the tweet text, creation date, engagement metrics, conversation details, and basic author information. This works the same way as the single tweet endpoint, but processes multiple links at once.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eAnalytics platforms collecting metrics for many tweets at once; marketing teams evaluating performance of multiple campaign posts; reporting tools generating summaries from a list of tweet URLs; moderation systems reviewing batches of flagged tweets; developers optimizing workflows by reducing the number of individual requests.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tweets.TweetInfoBulkReq"}}},"description":"tweet links or ids required","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.TweetsBulkResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Tweet info (bulk request)","tags":["Tweets"]}},"/user-tweets":{"post":{"description":"\u003cp\u003eReturns a list of tweets posted by a specific user. You provide the user’s profile link, and the endpoint returns tweet data such as text, post time, engagement counts, view count, and basic context like replies, quotes, and retweets (with nested tweet/user info when available). \u003c/p\u003e\u003cp\u003eWith each request returning up to 20 tweets. If there are more results, you will also receive a next_cursor to load the next page.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eSaaS dashboards showing a user’s latest posts; analytics tools collecting tweets for engagement tracking and content analysis; marketing teams reviewing a creator’s recent posts before outreach; moderation or compliance tools checking recent activity for specific keywords; developers building infinite scroll or batch processing using next_cursor.\u003c/div\u003e","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tweets.UserTweetsReq"}}},"description":"link or user id required, next_cursor optional","required":true,"x-originalParamName":"payload"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.TweetsResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"User Tweets","tags":["Tweets"]}},"/username-to-id/{user_handle}":{"get":{"description":"\u003cp\u003eReturns the unique Twitter/X user ID for a given username. You provide the username, and the endpoint returns the corresponding stable user ID.\u003c/p\u003e\u003cspan\u003eUse cases:\u003c/span\u003e\u003cdiv\u003eDevelopers converting usernames into IDs before making other API requests; SaaS platforms normalizing user identifiers in databases; analytics tools storing stable IDs instead of usernames; automation systems resolving usernames to internal identifiers; data pipelines preparing consistent user references for further processing.\u003c/div\u003e","parameters":[{"description":"user_handle required","in":"path","name":"user_handle","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/technical.IDRes"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"Username to User ID","tags":["Technical Endpoints"]}},"/verified-followers":{"get":{"parameters":[{"description":"user_link, username or user_id","in":"query","name":"user_link","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"username","schema":{"type":"string"}},{"description":"user_link, username or user_id","in":"query","name":"user_id","schema":{"type":"string"}},{"description":"cursor","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.UsersResponse"}}},"description":"OK"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Bad Request"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Not Found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.ErrorResponse"}}},"description":"Internal Server Error"}},"security":[{"ApiKeyAuth":[]}],"summary":"/verified-followers","tags":["Users Data"]}}},"servers":[{"url":"https://api.sorsa.io/v3"}]}