API de Sorsa Score: mide la influencia cripto en X

#Qué mide el Sorsa Score

El Sorsa Score mide el reconocimiento dentro del X cripto: cuántas cuentas cripto influyentes siguen a una cuenta y qué tan influyentes son, a su vez, esos seguidores. Nació como el score de TweetScout en 2022 y conservó su método cuando TweetScout cambió de nombre en 2025.

Para ver el score de una cuenta, escribe su usuario en el verificador gratuito de sorsa.io (se abre en una pestaña nueva), la página principal de la app de Sorsa: el score, el nivel y los principales seguidores aparecen en segundos. El resto de esta página trata de leer scores desde código, para una cuenta o para miles.

Cuatro reglas deciden el número:

• Quién sigue, no cuántos. Un follow de una cuenta de la base de datos de Sorsa Score de influencers, proyectos y fondos cripto suma puntos. El resto de la audiencia no suma nada, por grande que sea.
• Los nombres más grandes suman más. La parte de cada seguidor crece con su propio Sorsa Score, así que un follow de un fondo líder puede pesar más que decenas de cuentas pequeñas.
• Las granjas se filtran. Las cuentas de follow por follow y de seguimiento masivo se excluyen, así que los follows intercambiados o comprados no mueven el score.
• El contenido no cuenta. Los posts, los me gusta, las respuestas, los sorteos, la marca azul y el total de seguidores no alteran el número.

La app de Sorsa informa de más de 300K cuentas cripto calificadas y más de 100K etiquetadas como influencers, proyectos o fondos, con datos actualizados cada día. El score de una cuenta se mueve cuando una cuenta rastreada la sigue o deja de seguirla, o cuando uno de sus seguidores gana o pierde score.

La API oficial de X no tiene ningún score de influencia. Construir uno sobre ella empieza por leer los seguidores de una cuenta a $10.00 por 1,000, es decir, $500 por una sola cuenta con 50K seguidores, antes de identificar a alguno como fondo, proyecto o influencer.

#Niveles del Sorsa Score: qué es un buen score

Qué cuenta como un buen Sorsa Score depende de la tarea: 100 pone a una cuenta en el radar de cuentas cripto reales, 500 la hace Credible y 2,000 llega a Supreme, la cima del X cripto. La escala no tiene un máximo fijo, así que los rangos de 0 a 1,000 y de 0 a 5,000 que citan algunas guías son erróneos.

La tabla pone cada rango junto a cómo suele verse una cuenta en ese nivel.

• Unknown

  Score

  0 a 99

  Qué significa

  Aún sin seguidores cripto notables; la mayoría de las cuentas nuevas empieza aquí

• Noted

  Score

  100 a 499

  Qué significa

  Cuentas cripto reales han empezado a seguirla

• Credible

  Score

  500 a 999

  Qué significa

  Un círculo sólido de cuentas cripto la sigue

• Significant

  Score

  1,000 a 1,999

  Qué significa

  Los principales influencers, proyectos y fondos la siguen

• Supreme

  Score

  2,000 o más

  Qué significa

  Entre las cuentas más reconocidas del mundo cripto

El nivel no es un campo de la respuesta de la API. GET /score devuelve el número, y tu código lo asigna a un nivel con los cinco pisos de arriba; el código de la sección siguiente lo hace en dos líneas.

Algunas plataformas de campañas y quests cripto solo admiten creadores por encima de un score mínimo, como 300 o 500. Cuando un socio te pida tu score, revisa el número exacto que necesita, no solo el nivel.

#Obtén un Sorsa Score con Sorsa API

Sorsa API, una API y scraper de Twitter (X), devuelve el Sorsa Score de cualquier cuenta pública en una sola solicitud GET: envías un nombre de usuario, un ID de usuario o un enlace de perfil, y regresa el número. Necesita una sola clave de API en un encabezado, sin cuenta de desarrollador de X ni OAuth, y funciona a 20 solicitudes por segundo en todos los planes.

1. Consigue una clave. Regístrate y copia la clave de API desde el panel. Tus primeras 100 solicitudes son gratis y nunca vencen.

2. Pide el score. Envía exactamente uno de username, user_id o user_link a GET /score (se abre en una pestaña nueva) con la clave en el encabezado ApiKey.

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

   {
     "score": 1240.4
   }
   

3. Convierte el número en un nivel. La respuesta contiene solo score, así que el nivel sale de los cinco pisos en tu propio 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. Prepárate para la llamada lenta y la fallida. La primera solicitud de una cuenta grande que la base de datos aún no ha indexado puede tardar más, así que deja un tiempo de espera generoso. Un 401 significa una clave incorrecta, un 403 una clave faltante o sin solicitudes, y un 429 más de 20 solicitudes en un segundo: espera un segundo y reintenta. Las solicitudes fallidas nunca se cobran.

#Qué devuelve cada endpoint de Sorsa Score

Sorsa API tiene siete endpoints de Sorsa Score. Todos son solicitudes GET, todos aceptan uno de username, user_id o user_link, y cada llamada cuesta una solicitud.

• GET /score

  Qué devuelve

  score, un número

  Úsalo para

  Ordenar, filtrar o condicionar el acceso de cuentas

• GET /score-changes (se abre en una pestaña nueva)

  Qué devuelve

  week_delta y month_delta

  Úsalo para

  Detectar el impulso en 7 y 30 días

• GET /followers-stats (se abre en una pestaña nueva)

  Qué devuelve

  Conteos de influencers, proyectos y VCs entre los seguidores

  Úsalo para

  Ver quién respalda a una cuenta

• GET /top-followers (se abre en una pestaña nueva)

  Qué devuelve

  Los 20 seguidores con el score más alto, cada uno con su propio score

  Úsalo para

  Nombrar a los mayores aliados

• GET /top-following (se abre en una pestaña nueva)

  Qué devuelve

  Las 20 cuentas de mayor score que sigue

  Úsalo para

  Ver de quién vigila la señal

• GET /new-followers-7d (se abre en una pestaña nueva)

  Qué devuelve

  Cuentas rastreadas que la siguieron en los últimos 7 días, con fechas

  Úsalo para

  Detectar atención reciente

• GET /new-following-7d (se abre en una pestaña nueva)

  Qué devuelve

  Cuentas rastreadas que empezó a seguir en los últimos 7 días, con fechas

  Úsalo para

  Ver qué acaba de descubrir un fondo o KOL

GET /followers-stats es la segunda llamada que necesitan la mayoría de las revisiones: muestra si los seguidores detrás de un score son influencers individuales, cuentas de proyectos o fondos de capital de riesgo y su personal.

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

Para tener en cuenta

/score-changes y los dos endpoints de 7 días funcionan solo para cuentas que ya están en la base de datos de Sorsa Score, y solo ven los follows entre cuentas cripto rastreadas: no son un feed de todos los seguidores nuevos.

followers_count en /followers-stats cuenta los seguidores cripto rastreados, no el total de seguidores de la cuenta en X. /top-followers trae el score y el follower_date de cada seguidor; /top-following devuelve perfiles más completos con followerDate y sin score.

Para la lista completa de seguidores de cualquier cuenta, cripto o no, la guía de la API de seguidores de Twitter trata GET /followers con la misma clave, 200 seguidores por solicitud.

#Haz una revisión de due diligence de una cuenta

Una revisión de due diligence de una cuenta cripto requiere cuatro solicitudes: el score, su tendencia de 30 días, la composición de los seguidores que hay detrás y los 20 nombres más grandes entre ellos. Juntas muestran si el alcance de una cuenta está reconocido por quienes importan en el mundo cripto, o si solo es grande.

El script de abajo ejecuta las cuatro llamadas e imprime el informe. La llamada de tendencia lanza un error para una cuenta que la base de datos aún no ha indexado, así que el script trata una tendencia ausente como "sin historial" en lugar de detenerse.

# 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

Las alertas las defines tú. Un launchpad puede agregar un nivel mínimo, una agencia de KOLs una cantidad mínima de influencers rastreados, y un fondo una comprobación de que sus propios socios aparecen en /top-followers.

El score dice quién respalda a una cuenta, no si su audiencia es real. Los seguidores comprados y las granjas de interacción son otra revisión con la misma clave, descrita paso a paso en la guía de detección de bots en Twitter.

#Califica una lista de cuentas y cuánto cuesta

Para calificar una lista, llama a GET /score una vez por cuenta. No hay un endpoint de Score por lotes, así que 1,000 cuentas requieren 1,000 solicitudes, que terminan en menos de un minuto a 20 solicitudes 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))

La última columna filtra la lista en 500, el piso de Credible: cámbialo al mínimo que use tu campaña o tu lista de permitidos. Si muestras los scores en un producto público o en un ranking, acredítalos con "Score by Sorsa" o "Powered by Sorsa" junto al número: el uso público del score requiere esa línea.

Para calificar cuentas cripto en bloque, Sorsa API es la ruta directa: una clave, cualquier usuario público, desde $1.40 por 1,000 consultas de Score, y las solicitudes fallidas no cuestan nada. Una consulta cuesta la tarifa de tu plan por solicitud, así que 1,000 consultas de Score van de $1.40 a $4.90 y 1,000 informes de cuatro llamadas de $5.60 a $19.60; los planes entre Pro e Hyperscale caen en ese rango.

• Starter

  1,000 consultas de Score

  $4.90

  1,000 informes de cuatro llamadas

  $19.60

• Pro

  1,000 consultas de Score

  $1.99

  1,000 informes de cuatro llamadas

  $7.96

• Enterprise

  1,000 consultas de Score

  $1.80

  1,000 informes de cuatro llamadas

  $7.20

• Hyperscale

  1,000 consultas de Score

  $1.40

  1,000 informes de cuatro llamadas

  $5.60

El planificador de abajo convierte el tamaño de una lista y la profundidad de cada revisión en solicitudes, tiempo con una sola clave y costo.

#Migrar desde la API de TweetScout

La API de TweetScout es ahora Sorsa API: el mismo equipo y los mismos datos de Score, con otro nombre desde 2025, con la URL base https://api.sorsa.io/v3. Los enlaces antiguos de tweetscout.io abren la app de Sorsa.

Las llamadas de la época de TweetScout se migran ruta por ruta. Una llamada de la forma /v2/score/{handle} pasa a ser GET /v3/score?username={handle}, y /v2/score-changes pasa a ser GET /v3/score-changes. Todos los endpoints de Score de la v3 aceptan la cuenta como parámetro de consulta (username, user_id o user_link) y la clave en el encabezado ApiKey.

La misma clave ahora lee mucho más que el score: tweets, búsqueda hasta 2006, perfiles en lotes de 100 y listas completas de seguidores, mediante 38 endpoints más. Un panel cripto que mostraba números de TweetScout puede obtener de un solo proveedor los posts y la audiencia detrás de cada score.

#Califica tus primeras 100 cuentas

El Sorsa Score te dice quién respalda a una cuenta de X en el mundo cripto, no qué tan ruidosa es la cuenta. Para leerlo desde código, usa Sorsa API: GET /score para el número, tres llamadas más para el panorama completo, desde $1.40 por 1,000 consultas a 20 solicitudes por segundo, y 100 solicitudes gratis para calificar hoy tus primeras 100 cuentas.

#Preguntas frecuentes