TwexAPIからの移行：エンドポイントとフィールド

https://api.twexapi.ioへのBearerトークンの代わりに、https://api.sorsa.io/v3へApiKeyヘッダーでキーを送ります。以下の読み取りにはすべて対応するSorsa APIエンドポイントがあります。Sorsa APIは設計上読み取り専用なので、投稿には公式X APIを組み合わせてください。

• POST /twitter/tweets/lookup

  Sorsa API

  POST /tweet-info-bulk

  補足

  1リクエストで100件のツイートIDまたはリンク

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

  Sorsa API

  GET /info-batch

  補足

  1リクエストで100件のユーザーIDまたはユーザー名

• POST /twitter/followers/page

  Sorsa API

  GET /followers

  補足

  1ページ200件、ハンドル、IDまたはリンクで指定

• POST /twitter/following/page

  Sorsa API

  GET /follows

  補足

  1ページ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アカウントのリストを1つのフィードで

• 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記事

• 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

  補足

  各確認を1リクエストで回答

• エンドポイントなし

  Sorsa API

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

  補足

  各確認を1リクエストで回答

• エンドポイントなし

  Sorsa API

  GET /spaces

  補足

  スペースの詳細と統計

• 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です。