Sorsa Score API：衡量 X 上的加密影响力

#Sorsa Score 衡量什么

Sorsa Score 衡量的是加密圈 X 内部的认可度：有多少有影响力的加密账号关注了一个账号，以及这些关注者自己有多大影响力。它在 2022 年以 TweetScout 评分起步，2025 年 TweetScout 更名后，方法保持不变。

想看某个账号的分数，把它的用户名输入 sorsa.io（在新标签页打开）（Sorsa 应用的首页）上的免费检测器：分数、档位和头部粉丝几秒内就会出现。本页其余部分讲的是如何在代码里读取分数，无论是一个账号还是几千个。

四条规则决定这个数字：

• **看谁关注，不看有多少人。**Sorsa Score 数据库里的加密大 V、项目方和基金账号每关注一次，就会加分。其余的受众不加分，不管有多庞大。
• **名气越大，加分越多。**每个关注者的加分占比，随它自己的 Sorsa Score 增长，所以一家头部基金的一次关注，分量可能超过几十个小账号。
• **过滤掉刷量账号。**互关账号和批量关注账号被排除在外，所以交易来的或买来的关注，不会改变分数。
• **内容不算数。**发帖、点赞、回复、抽奖、蓝标和粉丝总数，都不会改变这个数字。

Sorsa 应用显示，已评分的加密账号超过 30 万个，被标记为大 V、项目方或基金的超过 10 万个，数据每天刷新。当一个被追踪的账号关注或取关了某个账号，或者它的某个关注者涨分、掉分时，这个账号的分数就会变动。

官方 X API 完全没有影响力评分。要在它之上自己搭一个，第一步就是读取账号的粉丝，每 1,000 个 $10.00，一个有 5 万粉丝的账号就是 $500，而此时还没有任何一个粉丝被识别为基金、项目方或大 V。

#Sorsa Score 分档：多少分算好

多少分算好，取决于你的用途：100 分让一个账号进入真正的加密账号的视野，500 分算 Credible，2,000 分到达 Supreme，也就是加密圈 X 的顶端。这个量表没有固定的上限，所以一些指南里引用的 0–1,000 和 0–5,000 的范围是错的。

下表把每个区间和该档账号通常的样子并排放在一起。

• Unknown

  分数

  0–99

  含义

  还没有值得一提的加密关注者；多数新账号从这里起步

• Noted

  分数

  100–499

  含义

  真正的加密账号已经开始关注它

• Credible

  分数

  500–999

  含义

  一个稳固的加密账号圈子在关注它

• Significant

  分数

  1,000–1,999

  含义

  顶级大 V、项目方和基金都在关注它

• Supreme

  分数

  2,000 及以上

  含义

  加密圈里认可度最高的账号之一

档位不是 API 响应里的字段。GET /score 返回的是数字，由你的代码按上面五个下限映射到档位；下一节的代码两行就能做到。

一些加密营销活动和任务平台，只接受分数高于最低门槛的创作者，比如 300 或 500。当合作方向你要分数时，要查清它需要的确切数字，而不只是档位。

#用 Sorsa API 获取 Sorsa Score

Sorsa API 是一款 Twitter（X）API 与爬虫，一个 GET 请求就能返回任意公开账号的 Sorsa Score：发送用户名、用户 ID 或主页链接，数字就返回了。它只要请求头里的一个 API 密钥，不需要 X 开发者账号，也不需要 OAuth，所有套餐都是每秒 20 次请求。

1. 获取密钥。注册后，在控制台复制 API 密钥。你的前 100 次请求免费，永不过期。

2. **请求分数。**向 GET /score（在新标签页打开） 恰好发送 username、user_id 或 user_link 之一，并在 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，所以档位要在你自己的代码里按五个下限得出。

   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 表示一秒内发了超过 20 次请求：等一秒再重试。失败的请求不计费。

#每个 Sorsa Score 接口返回什么

Sorsa API 有七个 Sorsa Score 接口。它们全都是 GET 请求，全都接受 username、user_id 或 user_link 之一，每次调用算一次请求。

• GET /score

  返回什么

  score，一个数字

  用来做什么

  给账号排名、筛选或设门槛

• GET /score-changes（在新标签页打开）

  返回什么

  week_delta 和 month_delta

  用来做什么

  看 7 天和 30 天的变化势头

• GET /followers-stats（在新标签页打开）

  返回什么

  粉丝中大 V、项目方和 VC 的数量

  用来做什么

  看谁在为一个账号背书

• GET /top-followers（在新标签页打开）

  返回什么

  分数最高的 20 个粉丝，每个都带自己的 score

  用来做什么

  点名最大的支持者

• GET /top-following（在新标签页打开）

  返回什么

  它所关注的账号中分数最高的 20 个

  用来做什么

  看它在关注谁的信号

• GET /new-followers-7d（在新标签页打开）

  返回什么

  最近 7 天关注了它的被追踪账号，附日期

  用来做什么

  捕捉新出现的关注

• GET /new-following-7d（在新标签页打开）

  返回什么

  它最近 7 天开始关注的被追踪账号，附日期

  用来做什么

  看一家基金或 KOL 刚发现了什么

多数检查需要的第二个调用是 GET /followers-stats：它显示一个分数背后的粉丝，是个人大 V、项目方账号，还是风投基金及其员工。

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

须知

/score-changes 和两个 7 天接口，只对已经在 Sorsa Score 数据库里的账号有效，而且它们只能看到被追踪的加密账号之间的关注：它们不是每个新粉丝的信息流。

/followers-stats 里的 followers_count 统计的是被追踪的加密粉丝，不是账号在 X 上的粉丝总数。/top-followers 带有每个粉丝的 score 和 follower_date；/top-following 返回更完整的用户资料，带 followerDate，没有分数。

想拿到任意账号（无论加密与否）的完整粉丝列表，推特粉丝 API指南介绍了同一个密钥下的 GET /followers，每次请求 200 个粉丝。

#对一个账号做尽职调查

对一个加密账号做尽职调查要四个请求：分数、它 30 天的趋势、分数背后的粉丝构成，以及其中最大的 20 个名字。合在一起，它们能看出一个账号的影响力是被加密圈里重要的人认可的，还是只是规模大。

下面的脚本运行这四个调用并打印报告。对于数据库尚未索引的账号，趋势调用会抛出错误，所以脚本把缺失的趋势当作“没有历史”，而不是中途停止。

# 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 经纪机构可以要求被追踪大 V 的最低数量，基金则可以检查自己的合伙人是否出现在 /top-followers 里。

分数说明的是谁在为一个账号背书，而不是它的受众是不是真人。买来的粉丝和刷互动的账号，是用同一个密钥做的另一项检查，详见推特僵尸粉检测指南里的逐步说明。

#给一批账号评分，以及要花多少钱

要给一批账号评分，就对每个账号调用一次 GET /score。没有批量的 Score 接口，所以 1,000 个账号要 1,000 次请求，按每秒 20 次请求，不到一分钟就跑完。

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))

最后一列以 500（Credible 的下限）为门槛筛选这份名单：改成你的营销活动或白名单所用的最低分即可。如果你在公开的产品或排行榜里展示这些分数，请在数字旁边注明“Score by Sorsa”或“Powered by Sorsa”：公开使用这个分数，必须带上这一行。

要批量给加密账号评分，Sorsa API 是最直接的路径：一个密钥，任意公开账号，每 1,000 次 Score 查询 $1.40 起，失败的请求不花钱。一次查询花的是你所在套餐的每次请求费率，所以 1,000 次 Score 查询是 $1.40 到 $4.90，1,000 份四个调用的报告是 $5.60 到 $19.60；Pro 到 Hyperscale 之间的套餐都落在这个范围内。

• Starter

  1,000 次 Score 查询

  $4.90

  1,000 份四个调用的报告

  $19.60

• Pro

  1,000 次 Score 查询

  $1.99

  1,000 份四个调用的报告

  $7.96

• Enterprise

  1,000 次 Score 查询

  $1.80

  1,000 份四个调用的报告

  $7.20

• Hyperscale

  1,000 次 Score 查询

  $1.40

  1,000 份四个调用的报告

  $5.60

下面的规划器会把名单规模和每次检查的深度，换算成请求数、一个密钥上的耗时和成本。

#从 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 数字的加密看板，现在可以从同一家服务商拉取每个分数背后的帖子和受众。

#给你的前 100 个账号评分

Sorsa Score 告诉你的是谁在加密圈里为一个 X 账号背书，而不是这个账号声音有多大。要在代码里读取它，用 Sorsa API：GET /score 拿数字，再用三个调用补全全貌，每 1,000 次查询 $1.40 起，每秒 20 次请求，另有 100 次免费请求，今天就能给你的前 100 个账号评分。

#常见问题