Sorsa Score API: meça a influência cripto no X

#O que o Sorsa Score mede

O Sorsa Score mede o reconhecimento dentro do X cripto: quantas contas cripto influentes seguem uma conta e quão influentes esses seguidores são. Ele nasceu como o score do TweetScout em 2022 e manteve o método quando o TweetScout foi renomeado em 2025.

Para ver o score de uma conta, digite o handle dela no verificador gratuito em sorsa.io (abre em uma nova aba), a página inicial do app Sorsa: o score, o nível e os principais seguidores aparecem em segundos. O restante desta página trata da leitura de scores em código, para uma conta ou para milhares.

Quatro regras definem o número:

• Quem segue, não quantos. Um follow de uma conta do banco de dados de influenciadores, projetos e fundos cripto do Sorsa Score soma pontos. O resto do público não soma nada, por maior que seja.
• Nomes maiores somam mais. A parte de cada seguidor cresce com o próprio Sorsa Score dele, então um follow de um fundo de peso pode valer mais que dezenas de follows de contas pequenas.
• Fazendas são filtradas. Contas de follow-for-follow e de seguir em massa são excluídas, então follows trocados ou comprados não mexem no score.
• O conteúdo não conta. Posts, curtidas, respostas, sorteios, o selo azul e o total de seguidores deixam o número onde está.

O app Sorsa informa mais de 300 mil contas cripto avaliadas e mais de 100 mil marcadas como influenciadores, projetos ou fundos, com dados atualizados todos os dias. O score de uma conta muda quando uma conta monitorada a segue ou deixa de segui-la, ou quando um dos seguidores dela ganha ou perde score.

A API oficial do X não tem nenhum score de influência. Construir um em cima dela começa por ler os seguidores de uma conta a US$ 10,00 por 1.000, o que dá US$ 500 por uma única conta com 50 mil seguidores, antes de identificar qualquer um deles como fundo, projeto ou influenciador.

#Níveis do Sorsa Score: o que é um bom score

O que conta como um bom Sorsa Score depende da tarefa: 100 coloca uma conta no radar de contas cripto de verdade, 500 a torna Credible e 2.000 chega a Supreme, o topo do X cripto. A escala não tem máximo fixo, então as faixas de 0 a 1.000 e de 0 a 5.000 citadas por alguns guias estão erradas.

A tabela coloca cada faixa ao lado do que uma conta nesse nível costuma ser.

• Unknown

  Score

  0 a 99

  O que significa

  Ainda sem seguidores cripto relevantes; a maioria das contas novas começa aqui

• Noted

  Score

  100 a 499

  O que significa

  Contas cripto de verdade começaram a segui-la

• Credible

  Score

  500 a 999

  O que significa

  Um círculo sólido de contas cripto a segue

• Significant

  Score

  1.000 a 1.999

  O que significa

  Grandes influenciadores, projetos e fundos a seguem

• Supreme

  Score

  2.000 ou mais

  O que significa

  Entre as contas mais reconhecidas do mundo cripto

O nível não é um campo da resposta da API. O GET /score devolve o número, e o seu código o converte em um nível com os cinco pisos acima; o código da próxima seção faz isso em duas linhas.

Algumas plataformas de campanhas e quests cripto só admitem criadores acima de um score mínimo, como 300 ou 500. Quando um parceiro pedir o seu score, confira o número exato de que ele precisa, não só o nível.

#Obtenha um Sorsa Score com a Sorsa API

A Sorsa API, uma API e scraper do Twitter (X), devolve o Sorsa Score de qualquer conta pública em uma única requisição GET: envie um username, um ID de usuário ou um link de perfil, e o número volta. Ela exige uma chave de API em um cabeçalho, sem conta de desenvolvedor do X e sem OAuth, e roda a 20 requisições por segundo em todos os planos.

1. Obtenha uma chave. Cadastre-se e copie a chave de API do painel. Suas primeiras 100 requisições são grátis e nunca expiram.

2. Peça o score. Envie exatamente um entre username, user_id ou user_link ao GET /score (abre em uma nova aba), com a chave no cabeçalho ApiKey.

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

   {
     "score": 1240.4
   }
   

3. Transforme o número em um nível. A resposta traz apenas score, então o nível vem dos cinco pisos no seu próprio código.

   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. Preveja a chamada lenta e a que falha. A primeira requisição para uma conta grande que o banco de dados ainda não indexou pode demorar mais, então mantenha um timeout generoso. Um 401 significa chave errada, um 403 chave ausente ou sem requisições, e um 429 mais de 20 requisições em um segundo: espere um segundo e tente de novo. Requisições com falha nunca são cobradas.

#O que cada endpoint do Sorsa Score devolve

A Sorsa API tem sete endpoints do Sorsa Score. Todos são requisições GET, todos aceitam um entre username, user_id ou user_link, e cada chamada custa uma requisição.

• GET /score

  O que devolve

  score, um único número

  Use para

  Ordenar, filtrar ou barrar contas

• GET /score-changes (abre em uma nova aba)

  O que devolve

  week_delta e month_delta

  Use para

  Identificar o ritmo em 7 e 30 dias

• GET /followers-stats (abre em uma nova aba)

  O que devolve

  Contagens de influenciadores, projetos e VCs entre os seguidores

  Use para

  Ver quem apoia uma conta

• GET /top-followers (abre em uma nova aba)

  O que devolve

  Os 20 seguidores de maior score, cada um com seu próprio score

  Use para

  Nomear os maiores apoiadores

• GET /top-following (abre em uma nova aba)

  O que devolve

  As 20 contas de maior score que ela segue

  Use para

  Ver o sinal de quem ela acompanha

• GET /new-followers-7d (abre em uma nova aba)

  O que devolve

  Contas monitoradas que a seguiram nos últimos 7 dias, com datas

  Use para

  Captar atenção recente

• GET /new-following-7d (abre em uma nova aba)

  O que devolve

  Contas monitoradas que ela começou a seguir nos últimos 7 dias, com datas

  Use para

  Acompanhar o que um fundo ou KOL acabou de descobrir

O GET /followers-stats é a segunda chamada de que a maioria das verificações precisa: ele mostra se os seguidores por trás de um score são influenciadores individuais, contas de projetos ou fundos de venture capital e suas equipes.

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

Bom saber

O /score-changes e os dois endpoints de 7 dias só funcionam para contas que já estão no banco de dados do Sorsa Score, e só enxergam follows entre contas cripto monitoradas: não são um feed de todos os novos seguidores.

O followers_count do /followers-stats conta os seguidores cripto monitorados, não o total de seguidores da conta no X. O /top-followers traz o score e o follower_date de cada seguidor; o /top-following devolve perfis mais completos com followerDate e sem score.

Para a lista completa de seguidores de qualquer conta, cripto ou não, o guia da API de seguidores do Twitter trata do GET /followers com a mesma chave, 200 seguidores por requisição.

#Faça uma verificação de due diligence em uma conta

Uma verificação de due diligence em uma conta cripto exige quatro requisições: o score, a tendência de 30 dias, a composição dos seguidores por trás dele e os 20 maiores nomes entre eles. Juntas, mostram se o alcance de uma conta é reconhecido por quem importa no mundo cripto ou é apenas grande.

O script abaixo executa as quatro chamadas e imprime o relatório. A chamada de tendência levanta um erro para uma conta que o banco de dados ainda não indexou, então o script trata a tendência ausente como "sem histórico" em vez de parar.

# 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

Os sinais de alerta ficam por sua conta. Uma launchpad pode acrescentar um nível mínimo, uma agência de KOLs uma contagem mínima de influenciadores monitorados, e um fundo uma verificação de que seus próprios parceiros aparecem no /top-followers.

O score diz quem apoia uma conta, não se o público dela é real. Seguidores comprados e fazendas de engajamento são outra verificação com a mesma chave, descrita passo a passo no guia de detecção de bots no Twitter.

#Calcule o score de uma lista de contas e quanto custa

Para calcular o score de uma lista, chame o GET /score uma vez por conta. Não existe um endpoint de Score em lote, então 1.000 contas exigem 1.000 requisições, o que termina em menos de um minuto a 20 requisições por segundo.

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

A última coluna barra a lista em 500, o piso do nível Credible: troque pelo mínimo que a sua campanha ou allowlist usa. Se você mostrar os scores em um produto público ou em um ranking, dê o crédito com "Score by Sorsa" ou "Powered by Sorsa" ao lado do número: o uso público do score exige essa linha.

Para calcular o score de contas cripto em massa, a Sorsa API é o caminho direto: uma chave, qualquer handle público, a partir de US$ 1,40 por 1.000 consultas de Score, e requisições com falha não custam nada. Uma consulta custa a tarifa por requisição do seu plano, então 1.000 consultas de Score saem de US$ 1,40 a US$ 4,90 e 1.000 relatórios de quatro chamadas de US$ 5,60 a US$ 19,60; os planos entre o Pro e o Hyperscale ficam nessa faixa.

• Starter

  1.000 consultas de Score

  US$ 4,90

  1.000 relatórios de quatro chamadas

  US$ 19,60

• Pro

  1.000 consultas de Score

  US$ 1,99

  1.000 relatórios de quatro chamadas

  US$ 7,96

• Enterprise

  1.000 consultas de Score

  US$ 1,80

  1.000 relatórios de quatro chamadas

  US$ 7,20

• Hyperscale

  1.000 consultas de Score

  US$ 1,40

  1.000 relatórios de quatro chamadas

  US$ 5,60

O planejador abaixo converte o tamanho de uma lista e a profundidade de cada verificação em requisições, tempo em uma chave e custo.

#Migrando da API do TweetScout

A API do TweetScout agora é a Sorsa API: a mesma equipe e os mesmos dados de Score, renomeados em 2025, com a URL base https://api.sorsa.io/v3. Os links antigos do tweetscout.io abrem o app Sorsa.

As chamadas da era TweetScout migram caminho a caminho. Uma chamada no formato /v2/score/{handle} vira GET /v3/score?username={handle}, e /v2/score-changes vira GET /v3/score-changes. Todo endpoint de Score da v3 recebe a conta como parâmetro de query (username, user_id ou user_link) e a chave no cabeçalho ApiKey.

A mesma chave agora lê muito mais do que o score: tweets, busca desde 2006, perfis em lotes de 100 e listas completas de seguidores, por mais 38 endpoints. Um dashboard cripto que mostrava números do TweetScout pode obter os posts e o público por trás de cada score de um único provedor.

#Calcule o score das suas primeiras 100 contas

O Sorsa Score diz quem apoia uma conta do X no mundo cripto, não quão barulhenta a conta é. Para lê-lo em código, use a Sorsa API: o GET /score para o número, mais três chamadas para o quadro completo, a partir de US$ 1,40 por 1.000 consultas a 20 requisições por segundo, e 100 requisições grátis para calcular hoje o score das suas primeiras 100 contas.

#Perguntas frequentes