全部 45 个 Twitter/X API 与爬虫接口，每次调用都只算一次请求。
每次数据调用计一次请求，$0.0014 起，无论返回一份用户资料还是 200 个粉丝。
无需绑卡，永不过期。
- /tweet-info通过链接或 ID 获取一条推文：正文、指标、作者，以及它引用或转发的原推。
- /tweet-info-bulk一次调用通过链接或 ID 获取最多 100 条推文，每条都带作者。每次请求 100 条
- /user-tweets账号的时间线，逐页获取，突破 3,200 条推文的上限。
- /user-replies账号发布过的回复。
- /user-retweets账号转发过的推文，原推位于 retweeted_status。
- /comments推文下的回复，可按相关度、时间或点赞数排序。
- /quotes推文的每条引用，附引用账号。
- /retweeters转发推文的账号，最新的在前，带完整资料。
- /article通过链接获取 X Articles 长文：全文、预览、封面图、日期、指标和作者。
- /trends某地当前的热门趋势，按 WOEID 查询。
每次调用如何运作
- 一个密钥，一个请求头。 每次请求都带上
ApiKey: YOUR_API_KEY。无需 OAuth，无需 X 开发者账号。 - JSON 进，JSON 出。 GET 用查询参数，POST 用 JSON 请求体。
- 用 cursor 翻页。 把
next_cursor传回去，就能拿到下一页。 - 每秒 20 次请求。 按密钥计算，所有套餐一致，免费账号也包括在内。
- 每次调用计一次请求。 无论返回多少。失败的调用和用量查询都不收费。
# 查询用户资料：GET 用查询参数curl -G https://api.sorsa.io/v3/info \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY" # 搜索：POST 用 JSON 请求体curl https://api.sorsa.io/v3/search-tweets \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "storm tracking", "order": "latest"}' # 下一页：加上上次响应中的 "next_cursor"Base URL https://api.sorsa.io/v3
接口常见问题
/key-usage-info 查询用量也免费。各套餐的单价见价格页面。https://api.sorsa.io/v3 发送 HTTPS 请求，把密钥放在 ApiKey 请求头中。GET 用查询参数，POST 用带 Content-Type: application/json 的 JSON 请求体。next_cursor：把它传回去（GET 放在查询参数中，POST 放在请求体中）就能拿到下一页。每页条数不固定，文档中的分页指南介绍了如何遍历整个列表。/user-tweets 也没有 3,200 条推文的上限。全部 45 个 Twitter/X API 与爬虫接口。
每次数据调用都算一次请求，$0.0014 起。
领取 100 次免费请求全部 45 个接口
推文10
单条推文和每批 100 条的批量获取、时间线、回复、引用、转发、X Articles 长文和趋势。
- /tweet-info通过链接或 ID 获取一条推文：正文、指标、作者，以及它引用或转发的原推。
- /tweet-info-bulk一次调用通过链接或 ID 获取最多 100 条推文，每条都带作者。
- /user-tweets账号的时间线，逐页获取，突破 3,200 条推文的上限。
- /user-replies账号发布过的回复。
- /user-retweets账号转发过的推文，原推位于 retweeted_status。
- /comments推文下的回复，可按相关度、时间或点赞数排序。
- /quotes推文的每条引用，附引用账号。
- /retweeters转发推文的账号，最新的在前，带完整资料。
- /article通过链接获取 X Articles 长文：全文、预览、封面图、日期、指标和作者。
- /trends某地当前的热门趋势，按 WOEID 查询。
用户6
单个或每批 100 份的用户资料、粉丝和关注列表，以及账号“关于”页面的内容。
搜索4
支持 X 运算符的全量推文搜索、可筛选的提及、账号和 Space。
检查6
回答是或否：关注、转发、引用、回复、社区成员身份和限流。
社区5
社区详情、成员和推文，社区内搜索，以及查找社区。
列表3
任意公开 X 列表的推文、成员和关注者。
实用工具4
用户名、用户 ID 和链接的转换，以及密钥用量。
Sorsa Score7
基于 Sorsa 自有 KOL、项目和 VC 索引的加密货币账号分析。
每次调用如何运作
- 一个密钥，一个请求头。每次请求都带上
ApiKey: YOUR_API_KEY。无需 OAuth，也不需要 X 开发者账号。 - JSON 进，JSON 出。GET 使用查询参数，POST 使用 JSON 请求体。
- 用游标翻页。把
next_cursor传回去即可获取下一页。 - 每秒 20 次请求。每个密钥、所有套餐都一样，免费账号也包括在内。
- 每次调用算一次请求。不论返回多少。失败的调用和用量查询从不收费。
你的第一次请求
用 GET 读取公开资料。搜索和其他 POST 接口使用 JSON 请求体。
https://api.sorsa.io/v3curl -G https://api.sorsa.io/v3/info \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"接口常见问题
Sorsa API 有多少个接口？
45 个，分为八组：推文、用户、搜索、检查、社区、列表、实用工具和 Sorsa Score。它们都收录在 API 参考文档中，也收录在一份 公开的 OpenAPI 规范.
每个接口的价格都一样吗？
可以：每次调用都算一次请求，最大套餐 $0.0014 起。批量调用最多返回 100 条推文或资料，粉丝一页最多 200 个，所以 1,000 条推文 $0.014 起，1,000 个粉丝 $0.007 起。失败的请求从不收费，用 /key-usage-info 查看用量也免费。各套餐的费率见价格页面。
如何调用接口？
向 https://api.sorsa.io/v3 发送 HTTPS 请求，把密钥放在 ApiKey 请求头中。GET 用查询参数，POST 用带 Content-Type: application/json 的 JSON 请求体。
如何翻页？
列表接口返回 next_cursor：把它传回去（GET 放在查询参数里，POST 放在请求体里）即可获取下一页。每页包含多少条并不固定，而且 分页指南 在文档中，演示了如何遍历整个列表。
每个接口有单独的速率限制吗？
没有。一个限制覆盖全部：所有套餐每个 API 密钥每秒 20 次请求，免费账号也包括在内，大用量套餐可按需提高。
搜索能回溯多久？
可回溯到 2006 年 3 月，支持所有 X 高级搜索运算符，/user-tweets 也没有 3,200 条推文的上限。
可以发推、点赞或发私信吗？
不可以。Sorsa API 只读取公开数据，所以不需要你的 X 登录信息，账号也没有风险。发推请继续使用官方 X API。
AI 智能体能使用这些接口吗？
可以。Sorsa MCP 服务器为 Claude Code、Cursor、Codex 和其他智能体提供基于这些接口的只读工具，用 AI 构建里有设置方法和提示词。
POST/tweet-info
通过链接或 ID 获取一条推文：正文、指标、作者，以及它引用或转发的原推。
1条推文/次请求
每次请求 $0.0014 起
- 发送
tweet_link- 返回
full_text,likes_count,view_count,user,quoted_status,retweeted_status
curl https://api.sorsa.io/v3/tweet-info \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tweet_link": "TWEET_LINK"}'POST/tweet-info-bulk
一次调用通过链接或 ID 获取最多 100 条推文，每条都带作者。
100条推文/次请求
每 1,000 条推文低至 $0.014
- 发送
tweet_links（最多 100 个）- 返回
条推文
curl https://api.sorsa.io/v3/tweet-info-bulk \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tweet_links": ["TWEET_ID_1", "TWEET_ID_2"]}'POST/user-tweets
账号的时间线，逐页获取，突破 3,200 条推文的上限。
20条推文/页
每 1,000 条推文 $0.07 起
- 发送
username、user_id或user_link;type：posts、replies 或 retweets;with_replies;next_cursor- 返回
tweets,next_cursor
curl https://api.sorsa.io/v3/user-tweets \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username": "mara_writes_code"}'POST/user-replies
账号发布过的回复。
20条回复/页
每 1,000 条回复 $0.07 起
- 发送
username、user_id或user_link;next_cursor- 返回
tweets,next_cursor
curl https://api.sorsa.io/v3/user-replies \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username": "mara_writes_code"}'POST/user-retweets
账号转发过的推文，原推位于 retweeted_status。
20条转发/页
每 1,000 条转推 $0.07 起
- 发送
username、user_id或user_link;next_cursor- 返回
tweets,next_cursor
curl https://api.sorsa.io/v3/user-retweets \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username": "mara_writes_code"}'POST/comments
推文下的回复，可按相关度、时间或点赞数排序。
20条回复/页
每 1,000 条回复 $0.07 起
- 发送
tweet_link;order_by：Relevance、Recency 或 Likes;next_cursor- 返回
tweets,next_cursor
curl https://api.sorsa.io/v3/comments \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tweet_link": "TWEET_LINK", "order_by": "Likes"}'POST/quotes
推文的每条引用，附引用账号。
20条引用/页
每 1,000 条引用 $0.07 起
- 发送
tweet_link;next_cursor- 返回
tweets,next_cursor
curl https://api.sorsa.io/v3/quotes \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tweet_link": "TWEET_LINK"}'POST/retweeters
转发推文的账号，最新的在前，带完整资料。
20个账号/页
每 1,000 个账号 $0.07 起
- 发送
tweet_link;next_cursor- 返回
users,next_cursor
curl https://api.sorsa.io/v3/retweeters \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tweet_link": "TWEET_LINK"}'POST/article
通过链接获取 X Articles 长文：全文、预览、封面图、日期、指标和作者。
1篇长文/次请求
每次请求 $0.0014 起
- 发送
tweet_link- 返回
full_text,preview_text,cover_image_url,published_at,views_count,author
curl https://api.sorsa.io/v3/article \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tweet_link": "ARTICLE_LINK"}'GET/trends
某地当前的热门趋势，按 WOEID 查询。
1个地区/次请求
每次请求 $0.0014 起
- 发送
woeid- 返回
trends
curl -G https://api.sorsa.io/v3/trends \ -d woeid=1 \ -H "ApiKey: YOUR_API_KEY"GET/info
公开用户资料：简介、数量、头像、注册时间和认证状态。
1份资料/次请求
每次请求 $0.0014 起
- 发送
username、user_id或user_link- 返回
id,username,display_name,description,followers_count,created_at,verified
curl -G https://api.sorsa.io/v3/info \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"GET/info-batch
一次调用按用户名或用户 ID 获取最多 100 份用户资料。
100份资料/次请求
每 1,000 份资料 $0.014 起
- 发送
usernames或user_ids（最多 100 个）- 返回
users
curl -G https://api.sorsa.io/v3/info-batch \ -d usernames=mara_writes_code \ -d usernames=kai_builds_agents \ -H "ApiKey: YOUR_API_KEY"GET/followers
任意公开账号的粉丝，每个都带完整资料。
200份资料/页
每 1,000 个粉丝 $0.007 起
- 发送
username、user_id或user_link;next_cursor- 返回
users,next_cursor
curl -G https://api.sorsa.io/v3/followers \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"GET/follows
账号关注的账号，每个都带完整资料。
200份资料/页
每 1,000 个账号 $0.007 起
- 发送
username、user_id或user_link;next_cursor- 返回
users,next_cursor
curl -G https://api.sorsa.io/v3/follows \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"GET/verified-followers
只返回带认证徽章的粉丝，并带完整资料。
200份资料/页
每 1,000 个粉丝 $0.007 起
- 发送
username、user_id或user_link;next_cursor- 返回
users,next_cursor
curl -G https://api.sorsa.io/v3/verified-followers \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"GET/about
国家、用户名变更、X Premium 状态和开始日期，以及账号来源。
1个账号/次请求
每次请求 $0.0014 起
- 发送
username、user_id或user_link- 返回
country,username_change_count,last_username_change_at,is_blue_verified,premium_start_at,source,affiliate_username
curl -G https://api.sorsa.io/v3/about \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"POST/search-tweets
任意 X 高级搜索查询及其运算符，可回溯到 2006 年，按热门或最新排序。
20条推文/页
每 1,000 条推文 $0.07 起
- 发送
query;order：popular 或 latest;next_cursor- 返回
tweets,next_cursor
curl https://api.sorsa.io/v3/search-tweets \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "storm tracking", "order": "latest"}'POST/mentions
提及某账号的推文，可设最低点赞、回复、转发数和日期范围。
20条推文/页
每 1,000 条推文 $0.07 起
- 发送
query;min_likes;min_replies;min_retweets;since_date;until_date;order;next_cursor- 返回
tweets,next_cursor
curl https://api.sorsa.io/v3/mentions \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "mara_writes_code", "min_likes": 10}'POST/search-users
简介、名称或用户名中匹配关键词或短语的账号。
20个账号/页
每 1,000 个账号 $0.07 起
- 发送
query;next_cursor- 返回
users,next_cursor
curl https://api.sorsa.io/v3/search-users \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "weather data"}'GET/spaces
通过 ID 或链接获取 Space：标题、状态、创建者、参与者、设置和统计。
1个 Space/次请求
每次请求 $0.0014 起
- 发送
id或link- 返回
title,state,creator,participants,settings,stats
curl -G https://api.sorsa.io/v3/spaces \ -d id=SPACE_ID \ -H "ApiKey: YOUR_API_KEY"POST/check-follow
一个账号是否关注了另一个账号。
1次验证/次请求
每次检查 $0.0014 起
- 发送
username_1、user_id_1或user_link_1;username_2、user_id_2或user_link_2- 返回
follow,user_protected
curl https://api.sorsa.io/v3/check-follow \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username_1": "mara_writes_code", "username_2": "kai_builds_agents"}'POST/check-retweet
账号是否转发了推文。每次调用扫描 100 条转发，并可继续翻页。
100条转发扫描/次请求
每次请求 $0.0014 起
- 发送
tweet_link;username、user_id或user_link;next_cursor- 返回
retweet,next_cursor,user_protected
curl https://api.sorsa.io/v3/check-retweet \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tweet_link": "TWEET_LINK", "username": "kai_builds_agents"}'POST/check-quoted
账号是否引用或转发了推文：quoted、retweet 或 not_found。
1次验证/次请求
每次检查 $0.0014 起
- 发送
tweet_link;username、user_id或user_link- 返回
status,date,text,user_protected
curl https://api.sorsa.io/v3/check-quoted \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tweet_link": "TWEET_LINK", "username": "kai_builds_agents"}'GET/check-comment
账号是否在推文下回复，如有回复则一并返回。
1次验证/次请求
每次检查 $0.0014 起
- 发送
tweet_link;username、user_id或user_link- 返回
commented,tweet
curl -G https://api.sorsa.io/v3/check-comment \ -d tweet_link=TWEET_LINK \ -d username=kai_builds_agents \ -H "ApiKey: YOUR_API_KEY"POST/check-community-member
账号是否为某社区的成员。
1次验证/次请求
每次检查 $0.0014 起
- 发送
community_id或community_link;username、user_id或user_link- 返回
is_member
curl https://api.sorsa.io/v3/check-community-member \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"community_id": "COMMUNITY_ID", "username": "kai_builds_agents"}'GET/check-shadowban
搜索封禁和搜索建议封禁：clean、banned 或 unknown。结果缓存一小时。
1次验证/次请求
每次检查 $0.0014 起
- 发送
用户名- 返回
is_shadowbanned,checks,checked_at
curl -G https://api.sorsa.io/v3/check-shadowban \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"POST/community-info
社区的名称、描述、成员数、横幅、创建日期和创建者。
1个社区/次请求
每次请求 $0.0014 起
- 发送
community_id或community_link- 返回
name,description,member_count,banner_url,created_at,creator
curl https://api.sorsa.io/v3/community-info \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"community_id": "COMMUNITY_ID"}'POST/community-members
社区的成员，以用户资料返回。
20名成员/页
每 1,000 个成员 $0.07 起
- 发送
community_id或community_link;next_cursor- 返回
users,next_cursor
curl https://api.sorsa.io/v3/community-members \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"community_id": "COMMUNITY_ID"}'POST/community-tweets
社区内发布的推文，按热门或最新排序。
20条推文/页
每 1,000 条推文 $0.07 起
- 发送
community_id或community_link;order：popular 或 latest;next_cursor- 返回
tweets,next_cursor
curl https://api.sorsa.io/v3/community-tweets \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"community_id": "COMMUNITY_ID", "order": "latest"}'POST/community-search-tweets
在单个社区内按关键词搜索，按热门或最新排序。
20条推文/页
每 1,000 条推文 $0.07 起
- 发送
community_id或community_link;query;order;next_cursor- 返回
tweets,next_cursor
curl https://api.sorsa.io/v3/community-search-tweets \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"community_id": "COMMUNITY_ID", "query": "radar"}'POST/search-communities
与搜索词匹配的社区，附成员数。
10个社区/页
每次请求 $0.0014 起
- 发送
query;next_cursor- 返回
communities,next_cursor
curl https://api.sorsa.io/v3/search-communities \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "weather"}'GET/list-tweets
列表中每位成员的最新推文，最多 5,000 个账号。
20条推文/页
每 1,000 条推文 $0.07 起
- 发送
list_id;next_cursor- 返回
tweets,next_cursor
curl -G https://api.sorsa.io/v3/list-tweets \ -d list_id=LIST_ID \ -H "ApiKey: YOUR_API_KEY"GET/list-members
列表中的账号，以用户资料返回。
20名成员/页
每 1,000 个成员 $0.07 起
- 发送
list_id;next_cursor- 返回
users,next_cursor
curl -G https://api.sorsa.io/v3/list-members \ -d list_id=LIST_ID \ -H "ApiKey: YOUR_API_KEY"GET/list-followers
关注列表的账号，以用户资料返回。
20个关注者/页
每 1,000 个粉丝 $0.07 起
- 发送
list_link;next_cursor- 返回
users,next_cursor
curl -G https://api.sorsa.io/v3/list-followers \ -d list_link=LIST_LINK \ -H "ApiKey: YOUR_API_KEY"GET/username-to-id/{user_handle}
把用户名转换成永久用户 ID。
1个用户名/次请求
每次请求 $0.0014 起
- 发送
user_handle（位于路径中）- 返回
id
curl https://api.sorsa.io/v3/username-to-id/mara_writes_code \ -H "ApiKey: YOUR_API_KEY"GET/id-to-username/{user_id}
把用户 ID 转换成账号当前的用户名。
1个 ID/次请求
每次请求 $0.0014 起
- 发送
user_id（位于路径中）- 返回
handle
curl https://api.sorsa.io/v3/id-to-username/USER_ID \ -H "ApiKey: YOUR_API_KEY"GET/link-to-id
把个人主页链接转换成用户 ID。
1个链接/次请求
每次请求 $0.0014 起
- 发送
链接- 返回
id
curl -G https://api.sorsa.io/v3/link-to-id \ -d link=PROFILE_LINK \ -H "ApiKey: YOUR_API_KEY"GET/key-usage-info
密钥的请求情况：已分配、剩余、累计使用，以及到期时间。
每次调用计 1 次请求
免费：不计入你的请求数
- 发送
- 无需参数，密钥放在
ApiKey请求头中 - 返回
key_requests,remaining_requests,total_requests,valid_until
curl https://api.sorsa.io/v3/key-usage-info \ -H "ApiKey: YOUR_API_KEY"GET/score
账号的 Sorsa Score：它在加密货币 KOL、项目和 VC 中的知名度。
1个账号/次请求
每次请求 $0.0014 起
- 发送
username、user_id或user_link- 返回
score
curl -G https://api.sorsa.io/v3/score \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"GET/score-changes
其评分在过去 7 天和 30 天的变化。
1个账号/次请求
每次请求 $0.0014 起
- 发送
username、user_id或user_link- 返回
week_delta,month_delta
curl -G https://api.sorsa.io/v3/score-changes \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"GET/followers-stats
其粉丝中有多少是加密货币 KOL、项目和 VC 员工。
1个账号/次请求
每次请求 $0.0014 起
- 发送
username、user_id或user_link- 返回
followers_count,influencers_count,projects_count,venture_capitals_count
curl -G https://api.sorsa.io/v3/followers-stats \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"GET/top-followers
Sorsa Score 最高的 20 个粉丝，附关注日期。
20个粉丝/次请求
每次请求 $0.0014 起
- 发送
username、user_id或user_link- 返回
users
curl -G https://api.sorsa.io/v3/top-followers \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"GET/top-following
其关注的账号中 Sorsa Score 最高的 20 个。
20个账号/次请求
每次请求 $0.0014 起
- 发送
username、user_id或user_link- 返回
users
curl -G https://api.sorsa.io/v3/top-following \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"GET/new-followers-7d
过去 7 天关注它的被追踪加密货币账号。
每次调用计 1 次请求
每次请求 $0.0014 起
- 发送
username、user_id或user_link- 返回
users
curl -G https://api.sorsa.io/v3/new-followers-7d \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"GET/new-following-7d
过去 7 天它开始关注的被追踪加密货币账号。
每次调用计 1 次请求
每次请求 $0.0014 起
- 发送
username、user_id或user_link- 返回
users
curl -G https://api.sorsa.io/v3/new-following-7d \ -d username=mara_writes_code \ -H "ApiKey: YOUR_API_KEY"