Sorsa Score API：X での暗号資産分野の影響力を測定する

#Sorsa Score が測るもの

Sorsa Score が測るのは、暗号資産分野の X における認知度です。影響力のある暗号資産アカウントが何件そのアカウントをフォローしているか、そしてそのフォロワー自身がどれだけ影響力を持っているかを見ます。2022年に TweetScout スコアとして始まり、2025年に TweetScout が改称された後も、算出方法は引き継がれています。

1つのアカウントのスコアを見るには、Sorsa アプリのホームである sorsa.io（新しいタブで開きます） の無料チェッカーにハンドルを入力します。スコア、ティア、トップフォロワーが数秒で表示されます。このページの以降の部分では、1件でも数千件でも、コードでスコアを読み取る方法を扱います。

数値を決めるルールは4つです。

• フォロワー数ではなく、誰がフォローしているか。 暗号資産のインフルエンサー、プロジェクト、ファンドを集めた Sorsa Score のデータベースに載っているアカウントからのフォローが、ポイントを加算します。それ以外のフォロワーは、どれだけ多くても加算されません。
• 大きな名前ほど加算が大きい。 各フォロワーの寄与は、そのフォロワー自身の Sorsa Score に応じて大きくなります。そのため、有力ファンドからの1フォローが、小さなアカウントからの数十フォローを上回ることがあります。
• フォロワー稼ぎのアカウントは除外される。 相互フォローや大量フォローのアカウントは対象外なので、取引や購入されたフォローではスコアは動きません。
• コンテンツは関係ない。 投稿、いいね、返信、プレゼント企画、青いチェックマーク、フォロワー総数は、数値に影響しません。

Sorsa アプリによると、スコアリング済みの暗号資産アカウントは30万件超、インフルエンサー、プロジェクト、ファンドとしてタグ付けされたアカウントは10万件超で、データは毎日更新されます。スコアが動くのは、追跡対象のアカウントがそのアカウントをフォローまたはフォロー解除したとき、またはフォロワーの1人のスコアが増減したときです。

公式 X API には、影響力スコアというものがそもそもありません。これを自前で作るには、まずアカウントのフォロワーを1,000件あたり$10.00で読み取ることから始まります。フォロワー5万人のアカウント1つで$500かかり、しかもその時点では、誰がファンドで、誰がプロジェクトで、誰がインフルエンサーかは分かっていません。

#Sorsa Score のティア：良いスコアとは

良い Sorsa Score がどのくらいかは、目的によって変わります。100で実在の暗号資産アカウントのレーダーに入り、500で Credible、2,000で暗号資産 X の頂点である Supreme に到達します。このスケールに固定の上限はないので、一部のガイドが紹介する0〜1,000や0〜5,000といった範囲は誤りです。

下の表は、各範囲と、そのレベルのアカウントが通常どのような状態かを並べたものです。

• Unknown

  スコア

  0〜99

  意味

  注目すべき暗号資産フォロワーがまだいない。新規アカウントの大半はここから始まる

• Noted

  スコア

  100〜499

  意味

  実在の暗号資産アカウントがフォローし始めている

• Credible

  スコア

  500〜999

  意味

  暗号資産アカウントのしっかりした層にフォローされている

• Significant

  スコア

  1,000〜1,999

  意味

  トップのインフルエンサー、プロジェクト、ファンドがフォローしている

• Supreme

  スコア

  2,000以上

  意味

  暗号資産分野で最も認知されたアカウントの1つ

ティアは API レスポンスのフィールドではありません。GET /score が返すのは数値で、5つの下限を使って自分のコードでティアに対応させます。次のセクションのコードでは、2行でできます。

暗号資産のキャンペーンやクエストのプラットフォームの中には、300や500といった最低スコアを超えるクリエイターしか受け付けないところがあります。パートナーからスコアを求められたら、ティアだけでなく、必要な正確な数値を確認してください。

#Sorsa API で Sorsa Score を取得する

Twitter（X）API 兼スクレイピングツールである Sorsa API は、任意の公開アカウントの Sorsa Score を、GET リクエスト1回で返します。ユーザー名、ユーザー ID、プロフィールのリンクのいずれかを送ると、数値が返ります。必要なのはヘッダーに入れる API キー1つで、X の開発者アカウントも OAuth も不要、どのプランでも毎秒20リクエストで動作します。

1. キーを取得する。 サインアップして、ダッシュボードから API キーをコピーします。最初の100リクエストは無料で、期限もありません。

2. スコアをリクエストする。 username、user_id、user_link のうち、ちょうど1つを GET /score（新しいタブで開きます） に送り、キーを ApiKey ヘッダーに入れます。

   curl -G "https://api.sorsa.io/v3/score" \
     -H "ApiKey: YOUR_API_KEY" \
     --data-urlencode "username=orbit_labs_protocol"
   

   {
     "score": 1240.4
   }
   

3. 数値をティアに変換する。 レスポンスに含まれるのは score だけなので、ティアは5つの下限を使って自分のコードで決めます。

   import requests
   
   API = "https://api.sorsa.io/v3"
   HEADERS = {"ApiKey": "YOUR_API_KEY"}
   
   TIERS = [(2000, "Supreme"), (1000, "Significant"),
            (500, "Credible"), (100, "Noted"), (0, "Unknown")]
   
   
   def tier(score):
       return next(name for floor, name in TIERS if score >= floor)
   
   
   def sorsa_score(username):
       r = requests.get(f"{API}/score", headers=HEADERS,
                        params={"username": username}, timeout=60)
       r.raise_for_status()
       return r.json()["score"]
   
   
   score = sorsa_score("orbit_labs_protocol")
   print(score, tier(score))  # 1240.4 Significant
   

   const API = "https://api.sorsa.io/v3";
   const headers = { ApiKey: "YOUR_API_KEY" };
   
   const TIERS = [[2000, "Supreme"], [1000, "Significant"],
     [500, "Credible"], [100, "Noted"], [0, "Unknown"]];
   
   const tier = (score) => TIERS.find(([floor]) => score >= floor)[1];
   
   async function sorsaScore(username) {
     const params = new URLSearchParams({ username });
     const res = await fetch(`${API}/score?${params}`, { headers });
     if (!res.ok) throw new Error(`HTTP ${res.status}`);
     return (await res.json()).score;
   }
   
   const score = await sorsaScore("orbit_labs_protocol");
   console.log(score, tier(score)); // 1240.4 Significant
   

4. 遅い呼び出しと失敗した呼び出しに備える。 データベースにまだインデックスされていない大きなアカウントへの最初のリクエストは時間がかかることがあるので、タイムアウトは余裕をもって設定してください。401 はキーが間違っている、403 はキーがないかリクエストを使い切った、429 は1秒に20リクエストを超えたという意味です。1秒待って再試行してください。失敗したリクエストに課金されることはありません。

#各 Sorsa Score エンドポイントが返すもの

Sorsa API には、Sorsa Score のエンドポイントが7つあります。すべて GET リクエストで、username、user_id、user_link のいずれか1つを受け取り、呼び出し1回が1リクエストです。

• GET /score

  返すもの

  score（数値1つ）

  用途

  アカウントの順位づけ、絞り込み、ゲート判定

• GET /score-changes（新しいタブで開きます）

  返すもの

  week_delta と month_delta

  用途

  7日間と30日間の勢いの把握

• GET /followers-stats（新しいタブで開きます）

  返すもの

  フォロワーに含まれるインフルエンサー、プロジェクト、VC の数

  用途

  アカウントを支持する顔ぶれの確認

• GET /top-followers（新しいタブで開きます）

  返すもの

  スコアが最も高いフォロワー20件（それぞれの score 付き）

  用途

  最大の支持者の特定

• GET /top-following（新しいタブで開きます）

  返すもの

  フォロー先のうちスコアが最も高い20アカウント

  用途

  誰のシグナルを見ているかの確認

• GET /new-followers-7d（新しいタブで開きます）

  返すもの

  直近7日間にフォローした追跡対象アカウントと日付

  用途

  新たな注目の把握

• GET /new-following-7d（新しいタブで開きます）

  返すもの

  直近7日間に新しくフォローした追跡対象アカウントと日付

  用途

  ファンドや KOL が見つけたばかりのものを確認

GET /followers-stats は、多くのチェックで2番目に必要になる呼び出しです。スコアの背後にいるフォロワーが、個人のインフルエンサーなのか、プロジェクトのアカウントなのか、ベンチャーファンドとそのスタッフなのかが分かります。

{
  "followers_count": 412,
  "influencers_count": 301,
  "projects_count": 88,
  "venture_capitals_count": 23,
  "user_protected": false
}

知っておきたいこと

/score-changes と2つの7日間のエンドポイントは、すでに Sorsa Score のデータベースにあるアカウントでしか動作せず、見えるのは追跡対象の暗号資産アカウント同士のフォローだけです。すべての新規フォロワーのフィードではありません。

/followers-stats の followers_count は、アカウントの X のフォロワー総数ではなく、追跡対象の暗号資産フォロワーの数です。/top-followers は各フォロワーの score と follower_date を持ち、/top-following はより詳しいプロフィールと followerDate を返しますが、スコアは含みません。

暗号資産かどうかを問わず、任意のアカウントの完全なフォロワー一覧は、Twitter フォロワー APIのガイドで、同じキーで使える GET /followers（1リクエスト200件）を解説しています。

#1つのアカウントでデューデリジェンスのチェックを行う

暗号資産アカウントのデューデリジェンスのチェックは、4つのリクエストで済みます。スコア、30日間のトレンド、その背後にあるフォロワーの構成、そして最も有力な20件です。この4つで、アカウントのリーチが暗号資産分野で重要な人々に認められたものか、単に大きいだけなのかが分かります。

下のスクリプトは、4つの呼び出しを実行してレポートを出力します。トレンドの呼び出しは、データベースにまだインデックスされていないアカウントではエラーになるため、スクリプトはトレンドが取得できない場合に止まらず「履歴なし」として扱います。

# reuses requests, API, HEADERS and tier() from step 3
def get(path, username):
    r = requests.get(f"{API}/{path}", headers=HEADERS,
                     params={"username": username}, timeout=60)
    r.raise_for_status()
    return r.json()


def report(username):
    score = get("score", username)["score"]
    try:
        trend = get("score-changes", username)["month_delta"]
    except requests.HTTPError:
        trend = None  # not indexed yet: no history
    mix = get("followers-stats", username)
    top = get("top-followers", username)["users"]

    flags = []
    if mix["venture_capitals_count"] + mix["projects_count"] == 0:
        flags.append("no tracked fund or project follows it")
    if trend is not None and trend < 0:
        flags.append(f"score fell {trend} in 30 days")

    print(f"{username}: {score:.0f} ({tier(score)})")
    print(f"30-day change: {trend}")
    print(f"Backed by {mix['influencers_count']} influencers, "
          f"{mix['projects_count']} projects, "
          f"{mix['venture_capitals_count']} funds")
    for u in top[:3]:
        print(f"  {u['username']}: {u['score']:.0f}")
    print("Red flags:", "; ".join(flags) or "none")


report("orbit_labs_protocol")

orbit_labs_protocol: 1240 (Significant)
30-day change: 64
Backed by 301 influencers, 88 projects, 23 funds
  halcyon_ventures_x: 2631
  juno_park_research: 1972
  quillswap_official: 1788
Red flags: none

危険信号の基準は、自分で決めます。ローンチパッドなら最低ティア、KOL エージェンシーなら追跡対象インフルエンサーの最低数、ファンドなら自社のパートナーが /top-followers に入っているかのチェックを加えられます。

スコアが示すのは誰が支持しているかであって、オーディエンスが本物かどうかではありません。購入されたフォロワーやエンゲージメント稼ぎは、同じキーで行う別のチェックです。手順はTwitter のボット検出のガイドで解説しています。

#アカウントのリストをスコアリングする方法と費用

リストをスコアリングするには、アカウントごとに GET /score を1回呼び出します。バッチ用の Score エンドポイントはないので、1,000アカウントなら1,000リクエストで、毎秒20リクエストなら1分足らずで終わります。

import csv
import time
from concurrent.futures import ThreadPoolExecutor


def check(username):
    for _ in range(3):
        r = requests.get(f"{API}/score", headers=HEADERS,
                         params={"username": username}, timeout=60)
        if r.status_code == 429:  # over 20 a second: wait, retry
            time.sleep(1)
            continue
        if not r.ok:
            return [username, "", f"error {r.status_code}", ""]
        s = r.json()["score"]
        return [username, s, tier(s), s >= 500]
    return [username, "", "rate limited", ""]


with open("handles.txt") as f:
    handles = [h.strip().lstrip("@") for h in f if h.strip()]

with ThreadPoolExecutor(max_workers=10) as pool, \
        open("scores.csv", "w", newline="") as out:
    w = csv.writer(out)
    w.writerow(["username", "score", "tier", "credible_or_above"])
    w.writerows(pool.map(check, handles))

最後の列は、リストを Credible の下限である500で絞り込みます。キャンペーンやアローリストが使う最低値に変更してください。スコアを公開の製品やリーダーボードで表示する場合は、数値の隣に「Score by Sorsa」または「Powered by Sorsa」と表記してください。スコアを公開して使うには、この表記が必要です。

暗号資産アカウントを一括でスコアリングするなら、Sorsa API が最短のルートです。キー1つで、任意の公開ハンドルを、Score のチェック1,000回あたり$1.40から取得でき、失敗したリクエストは無料です。チェック1回は、プランのリクエスト単価で課金されるので、Score のチェック1,000回は$1.40から$4.90、4つの呼び出しによるレポート1,000件は$5.60から$19.60です。Pro と Hyperscale の間のプランは、この範囲に収まります。

• Starter

  Score のチェック1,000回

  $4.90

  4つの呼び出しによるレポート1,000件

  $19.60

• Pro

  Score のチェック1,000回

  $1.99

  4つの呼び出しによるレポート1,000件

  $7.96

• Enterprise

  Score のチェック1,000回

  $1.80

  4つの呼び出しによるレポート1,000件

  $7.20

• Hyperscale

  Score のチェック1,000回

  $1.40

  4つの呼び出しによるレポート1,000件

  $5.60

下のプランナーは、リストの大きさと各チェックの深さから、リクエスト数、1つのキーでの所要時間、費用を試算します。

#TweetScout API からの移行

TweetScout API は現在の Sorsa API です。チームも Score のデータも同じで、2025年に名称が変わりました。ベース URL は https://api.sorsa.io/v3 です。古い tweetscout.io のリンクは Sorsa アプリに転送されます。

TweetScout 時代の呼び出しは、パスごとに移行できます。/v2/score/{handle} の形式の呼び出しは GET /v3/score?username={handle} に、/v2/score-changes は GET /v3/score-changes になります。v3 のすべての Score エンドポイントは、アカウントをクエリパラメータ（username、user_id、user_link）で受け取り、キーを ApiKey ヘッダーに入れます。

同じキーで、スコア以外にも多くのデータを読み取れます。ツイート、2006年まで遡る検索、100件ずつのバッチ取得によるプロフィール、完全なフォロワー一覧が、さらに38のエンドポイントで利用できます。TweetScout の数値を表示していた暗号資産ダッシュボードは、各スコアの背後にある投稿とオーディエンスを、1つのプロバイダーから取得できるようになります。

#最初の100アカウントをスコアリングする

Sorsa Score が示すのは、暗号資産分野で X アカウントを誰が支持しているかであって、そのアカウントがどれだけ騒がしいかではありません。コードで読み取るには Sorsa API を使います。数値は GET /score、全体像はあと3つの呼び出しで把握できます。料金はチェック1,000回あたり$1.40から、毎秒20リクエストで、100回分の無料リクエストで今日、最初の100アカウントをスコアリングできます。

#FAQ