从 TwexAPI 切换：接口和字段

把密钥放进 ApiKey 请求头发往 https://api.sorsa.io/v3，不再向 https://api.twexapi.io 发送 Bearer 令牌。下面每个读取调用都有对应的 Sorsa API 接口。Sorsa API 从产品设计上就是只读，如需发帖，可搭配官方 X API。

• POST /twitter/tweets/lookup

  Sorsa API

  POST /tweet-info-bulk

  说明

  每次请求 100 个推文 ID 或链接

• POST /twitter/users/by_ids, POST /twitter/users

  Sorsa API

  GET /info-batch

  说明

  每次请求 100 个用户 ID 或用户名

• POST /twitter/followers/page

  Sorsa API

  GET /followers

  说明

  每页 200 个，可按用户名、ID 或链接查询

• POST /twitter/following/page

  Sorsa API

  GET /follows

  说明

  每页 200 个

• POST /v3/twitter/users/verified-followers

  Sorsa API

  GET /verified-followers

• POST /twitter/advanced_search/page

  Sorsa API

  POST /search-tweets

  说明

  相同的 X 搜索语法，可追溯至 2006 年

• POST /twitter/{screen_name}/timeline/page

  Sorsa API

  POST /user-tweets

  说明

  推文、回复或转发

• POST /twitter/tweets/{tweet_id}/replies/page

  Sorsa API

  POST /comments

  说明

  按相关度、时间或点赞数排序

• POST /twitter/tweets/quotes/page

  Sorsa API

  POST /quotes

• POST /twitter/tweets/retweeters/page

  Sorsa API

  POST /retweeters

• POST /twitter/list/tweets/page, /twitter/list/members/page

  Sorsa API

  GET /list-tweets, GET /list-members

  说明

  最多 5,000 个账号的列表，汇成一条信息流

• GET /twitter/community/{community_id}, POST /twitter/community/search

  Sorsa API

  POST /community-info, POST /search-communities

• POST /twitter/community/members/page, /twitter/community/tweets/page

  Sorsa API

  POST /community-members, POST /community-tweets

• GET /twitter/{screen_name}/about

  Sorsa API

  GET /about

  说明

  国家、用户名变更、认证状态

• POST /x/article

  Sorsa API

  POST /article

  说明

  X Articles 及其统计数据

• GET /twitter/{country}/trending

  Sorsa API

  GET /trends

  说明

  按地区（WOEID）

• POST /twitter/shadowban/check

  Sorsa API

  GET /check-shadowban

• GET /balance

  Sorsa API

  GET /key-usage-info

  说明

  免费：从不计入你的请求额度

• 无接口

  Sorsa API

  POST /check-follow, POST /check-retweet, POST /check-quoted

  说明

  一次请求回答一项验证

• 无接口

  Sorsa API

  GET /check-comment, POST /check-community-member

  说明

  一次请求回答一项验证

• 无接口

  Sorsa API

  GET /spaces

  说明

  Space 的详情和统计数据

• tweet_id

  Sorsa API 字段

  id，始终为字符串

• full_text

  Sorsa API 字段

  full_text

• created_at，格式为 "Mon Jun 17 03:51:48 +0000 2024"

  Sorsa API 字段

  created_at，ISO 8601 格式

• favorite_count

  Sorsa API 字段

  likes_count

• view_count

  Sorsa API 字段

  view_count

• 推文中为 user.screen_name，粉丝列表中为 username

  Sorsa API 字段

  所有位置都是 user.username

• 推文中为 user.id，粉丝列表中为 userId

  Sorsa API 字段

  所有位置都是 user.id

• 推文中为 followers_count，粉丝列表中为 followersCount

  Sorsa API 字段

  所有位置都是 followers_count

• following_count, followingCount

  Sorsa API 字段

  followings_count

• statuses_count, statusesCount

  Sorsa API 字段

  tweets_count

• name

  Sorsa API 字段

  display_name

import os

import requests

SORSA = "https://api.sorsa.io/v3"
HEADERS = {"ApiKey": os.environ["SORSA_API_KEY"]}


def tweets_by_ids(tweet_ids):
    """Replaces TwexAPI's POST /twitter/tweets/lookup, 100 IDs a request."""
    tweets = []
    for i in range(0, len(tweet_ids), 100):
        body = {"tweet_links": tweet_ids[i:i + 100]}
        r = requests.post(f"{SORSA}/tweet-info-bulk", headers=HEADERS,
                          json=body, timeout=30)
        r.raise_for_status()
        tweets.extend(r.json()["tweets"])
    return tweets


def profiles_by_usernames(usernames):
    """Replaces TwexAPI's POST /twitter/users, 100 usernames a request."""
    users = []
    for i in range(0, len(usernames), 100):
        query = {"usernames": usernames[i:i + 100]}
        r = requests.get(f"{SORSA}/info-batch", headers=HEADERS,
                         params=query, timeout=30)
        r.raise_for_status()
        users.extend(r.json()["users"])
    return users

两个函数都返回 Sorsa API 的标准对象：tweets 中每条都包含作者完整资料，users 的字段与粉丝列表返回的相同。