La API de Twitter de TweetScout ahora es Sorsa API v3

#Qué pasó con la API de TweetScout

La API de TweetScout se renombró como Sorsa API en 2025 a cargo del equipo que la opera en Scouts Labs Inc desde 2022, y su versión de la época de TweetScout, la v2, se retiró el 1 de mayo de 2026 (se abre en una pestaña nueva). Todos los endpoints de la v2 ahora devuelven 410 Gone, y el código que sigue apuntando a api.tweetscout.io/v2 llama a esa misma versión retirada.

El producto se dividió según sus dos públicos. La app de analítica cripto pasó a ser la app de Sorsa en sorsa.io (se abre en una pestaña nueva), a donde ahora redirigen tweetscout.io y app.tweetscout.io, y la API para desarrolladores pasó a ser Sorsa API en api.sorsa.io. El puntaje de TweetScout conservó su método con un nombre nuevo, el Sorsa Score, y sus endpoints forman parte de la v3. La guía de Sorsa Score API explica los niveles y cómo se construye el puntaje.

Las búsquedas de "Tweet Scout" y "Twitter Scout" llevan al mismo producto. Lo que cambió para el código es la versión: la v3 conserva las funciones de TweetScout, renombra algunas rutas y parámetros, y agrega 20 endpoints que la API anterior nunca tuvo, hasta sumar 45.

#Migra una llamada de TweetScout a Sorsa API v3 en cuatro pasos

Toda llamada de TweetScout se migra con las mismas cuatro ediciones, y la mayoría es de una línea. Para una integración de TweetScout, Sorsa API v3 es la sucesora directa: 25 rutas de la v3 hacen las funciones anteriores, la clave sigue yendo en el encabezado ApiKey y todos los planes funcionan a 20 solicitudes por segundo.

1. Consigue una clave de la v3. Regístrate y copia una clave desde API Keys en el panel. GET /key-usage-info (se abre en una pestaña nueva) confirma que funciona y muestra las solicitudes restantes, y nunca cuenta contra ellas.

2. Cambia la URL base. Reemplaza https://api.tweetscout.io/v2 o https://api.sorsa.io/v2 por https://api.sorsa.io/v3 en todo tu código.

3. Saca los nombres de usuario y los IDs de la ruta. TweetScout ponía la cuenta en la ruta (/score/{user_handle}, /info-id/{user_id}). La v3 la recibe como parámetro de consulta: username, user_id o user_link, exactamente uno de ellos.

   curl "https://api.tweetscout.io/v2/score/orbit_dao_watcher" \
     -H "ApiKey: YOUR_API_KEY"
   

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

4. Renombra las claves de paginación y del cuerpo. cursor pasa a ser next_cursor, link pasa a ser user_link y user_handle pasa a ser username. En POST /check-follow, project_handle pasa a ser username_1 (la cuenta que debería ser seguida) y user_handle pasa a ser username_2 (la cuenta que verificas).

Las mismas ediciones en un script: la URL base cambia una vez, el nombre de usuario pasa a params, y las listas que en la v2 llegaban como un solo arreglo ahora llegan en páginas con un cursor. El tutorial de la API de Twitter en Python cubre el resto de lo básico de la v3.

import requests

BASE = "https://api.sorsa.io/v3"  # was https://api.tweetscout.io/v2
HEADERS = {"ApiKey": "YOUR_API_KEY"}


def score(handle):
    # v2: GET /score/{handle}  ->  v3: GET /score?username=
    r = requests.get(f"{BASE}/score", headers=HEADERS,
                     params={"username": handle}, timeout=30)
    r.raise_for_status()
    return r.json()["score"]


def following(handle):
    # v2 returned one array; v3 pages 200 accounts at a time
    users, cursor = [], None
    while True:
        params = {"username": handle}
        if cursor:
            params["next_cursor"] = cursor
        r = requests.get(f"{BASE}/follows", headers=HEADERS,
                         params=params, timeout=30)
        r.raise_for_status()
        page = r.json()
        users += page["users"]
        cursor = page.get("next_cursor")
        if not cursor:
            return users


print(score("orbit_dao_watcher"))
print(len(following("orbit_dao_watcher")))

const BASE = "https://api.sorsa.io/v3"; // was https://api.tweetscout.io/v2
const HEADERS = { ApiKey: "YOUR_API_KEY" };

async function score(handle) {
  const qs = new URLSearchParams({ username: handle });
  const res = await fetch(`${BASE}/score?${qs}`, { headers: HEADERS });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return (await res.json()).score;
}

async function following(handle) {
  const users = [];
  let cursor = "";
  do {
    const qs = new URLSearchParams({ username: handle });
    if (cursor) qs.set("next_cursor", cursor);
    const res = await fetch(`${BASE}/follows?${qs}`, { headers: HEADERS });
    if (!res.ok) throw new Error(`HTTP ${res.status}`);
    const page = await res.json();
    users.push(...page.users);
    cursor = page.next_cursor || "";
  } while (cursor);
  return users;
}

console.log(await score("orbit_dao_watcher"));

Un 401 significa que la clave es incorrecta, un 403 significa que falta o que se quedó sin solicitudes, y un 429 significa más de 20 solicitudes en un segundo, así que espera un segundo y vuelve a enviarla. Los endpoints de score responden para las cuentas que están en la base de datos del Sorsa Score, y la v3 ahora incluye la fecha en que cada seguidor empezó a seguir, como en esta respuesta de GET /top-followers:

{
  "users": [
    {
      "id": "1600000000000000004",
      "username": "lattice_fund_research",
      "display_name": "Lattice Fund Research",
      "followers_count": 48210,
      "followings_count": 612,
      "verified": true,
      "score": 1873,
      "follower_date": "2026-03-14T09:21:07Z"
    }
  ]
}

#El mapa de endpoints de la API de TweetScout, de la v2 a la v3

De los 29 endpoints de la referencia de la v2 de la época de TweetScout, 27 pasaron a la v3 y 2 se retiraron. Los 27 caen en 25 rutas de la v3, porque dos pares se fusionaron: /info e /info-id pasaron a ser un solo GET /info, y /score y /score-id pasaron a ser un solo GET /score.

Pega en el conversor cualquier llamada antigua de tu código o de tus registros para obtener su solicitud de la v3 y las ediciones que necesita.

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

El mapa completo enumera cada llamada de la v2 en los grupos de la referencia anterior, con la ruta de la v3 que la reemplaza y la edición que necesita. Las llamadas cuya ruta no cambió igual necesitan la nueva URL base.

• GET /info/{user_handle}

  Sorsa API v3

  GET /info

  Qué cambia

  El nombre de usuario pasa a ?username=

• GET /info-id/{user_id}

  Sorsa API v3

  GET /info

  Qué cambia

  El ID pasa a ?user_id=

• GET /about

  Sorsa API v3

  GET /about

  Qué cambia

  link pasa a ser user_link; username también funciona

• GET /follows

  Sorsa API v3

  GET /follows

  Qué cambia

  link pasa a ser user_link; 200 por página con next_cursor

• GET /handle-to-id/{user_handle}

  Sorsa API v3

  GET /username-to-id/{user_handle}

  Qué cambia

  Ruta renombrada

• GET /id-to-handle/{user_id}

  Sorsa API v3

  GET /id-to-username/{user_id}

  Qué cambia

  Ruta renombrada; la respuesta sigue incluyendo handle

• POST /user-tweets

  Sorsa API v3

  POST /user-tweets

  Qué cambia

  link pasa a ser user_link, cursor pasa a ser next_cursor

• POST /tweet-info

  Sorsa API v3

  POST /tweet-info

  Qué cambia

  Mismo cuerpo; campos del tweet renombrados

• POST /tweet-info-bulk

  Sorsa API v3

  POST /tweet-info-bulk

  Qué cambia

  Mismo cuerpo; la respuesta viene envuelta en tweets

• POST /comments

  Sorsa API v3

  POST /comments

  Qué cambia

  order_by opcional; la clave de la respuesta comments pasa a ser tweets

• POST /search-tweets

  Sorsa API v3

  POST /search-tweets

  Qué cambia

  Sin cambios

• POST /search-users

  Sorsa API v3

  POST /search-users

  Qué cambia

  Sin cambios

• GET /list-members

  Sorsa API v3

  GET /list-members

  Qué cambia

  Agrega paginación con next_cursor

• GET /list-tweets

  Sorsa API v3

  GET /list-tweets

  Qué cambia

  cursor pasa a ser next_cursor

• POST /community-tweets

  Sorsa API v3

  POST /community-tweets

  Qué cambia

  cursor pasa a ser next_cursor, order_by pasa a ser order

• POST /check-member

  Sorsa API v3

  POST /check-community-member

  Qué cambia

  Ruta renombrada

• POST /check-follow

  Sorsa API v3

  POST /check-follow

  Qué cambia

  project_* pasa a ser *_1, user_* pasa a ser *_2

• POST /check-quoted

  Sorsa API v3

  POST /check-quoted

  Qué cambia

  user_handle pasa a ser username

• POST /check-retweet

  Sorsa API v3

  POST /check-retweet

  Qué cambia

  user_handle pasa a ser username

• GET /check-comment

  Sorsa API v3

  GET /check-comment

  Qué cambia

  user_handle pasa a ser username

• GET /score/{user_handle}

  Sorsa API v3

  GET /score

  Qué cambia

  El nombre de usuario pasa a ?username=

• GET /score-id/{user_id}

  Sorsa API v3

  GET /score

  Qué cambia

  El ID pasa a ?user_id=

• GET /score-changes

  Sorsa API v3

  GET /score-changes

  Qué cambia

  user_handle pasa a ser username

• GET /followers-stats

  Sorsa API v3

  GET /followers-stats

  Qué cambia

  user_handle pasa a ser username

• GET /top-followers/{user_handle}

  Sorsa API v3

  GET /top-followers

  Qué cambia

  El nombre de usuario pasa a ?username=; se elimina from

• GET /top-following/{user_handle}

  Sorsa API v3

  GET /top-following

  Qué cambia

  El nombre de usuario pasa a ?username=

• GET /new-following-7d

  Sorsa API v3

  GET /new-following-7d

  Qué cambia

  user_handle pasa a ser username

• POST /when-follow

  Sorsa API v3

  Retirado

  Qué cambia

  POST /check-follow responde sí o no

• GET /handle-history

  Sorsa API v3

  Retirado

  Qué cambia

  GET /about devuelve el número de cambios y la última fecha

Las dos filas retiradas todavía tienen una ruta hacia la misma respuesta, y la sección de abajo sobre las llamadas sin un endpoint equivalente la muestra en cada caso.

#Campos de la respuesta que cambiaron de nombre

Las respuestas de la v3 conservan la forma de las respuestas de TweetScout, pero cambiaron 10 nombres de campos, y las listas que la v2 devolvía como arreglos simples ahora vienen dentro de un objeto ({"users": [...]} o {"tweets": [...]}). Los parsers fallan primero por estos cambios de nombre, así que busca antes que nada los nombres antiguos en tu código.

• screen_name

  Campo de Sorsa API v3

  username

  Dónde aparece

  Perfiles, autores de tweets, miembros de listas

• name

  Campo de Sorsa API v3

  display_name

  Dónde aparece

  Perfiles, autores de tweets

• friends_count

  Campo de Sorsa API v3

  followings_count

  Dónde aparece

  Perfiles, autores de tweets

• statuses_count

  Campo de Sorsa API v3

  tweets_count

  Dónde aparece

  Autores de tweets

• register_date

  Campo de Sorsa API v3

  created_at

  Dónde aparece

  Perfiles

• avatar

  Campo de Sorsa API v3

  profile_image_url

  Dónde aparece

  Perfiles, autores de tweets

• banner

  Campo de Sorsa API v3

  profile_background_image_url

  Dónde aparece

  Perfiles

• id_str

  Campo de Sorsa API v3

  id

  Dónde aparece

  Tweets, autores de tweets

• favorite_count

  Campo de Sorsa API v3

  likes_count

  Dónde aparece

  Tweets

• in_reply_to_status_id_str

  Campo de Sorsa API v3

  in_reply_to_tweet_id

  Dónde aparece

  Tweets

Las claves en camelCase de las listas antiguas de top followers (screeName, followersCount, friendsCount, registerDate) pasaron a tener los mismos nombres en snake_case que el resto de los perfiles de la v3. Entre los campos que conservaron su nombre están full_text, retweet_count, reply_count, quote_count, view_count, bookmark_count y can_dm, y cada perfil de la v3 agrega location, bio_urls, pinned_tweet_ids y protected.

Para tener en cuenta

La fecha en que alguien empezó a seguir tiene dos grafías en la v3: follower_date en GET /top-followers y followerDate en GET /new-followers-7d y GET /new-following-7d. Los IDs son cadenas de texto en todas partes, como en la v2, así que guárdalos como texto en tu base de datos: los IDs Snowflake largos pierden dígitos cuando se manejan como números en JavaScript.

#Llamadas de TweetScout sin un endpoint equivalente en la v3

Se retiraron dos endpoints de la v2, y tres cosas que la gente busca con el nombre de TweetScout nunca fueron endpoints de la API. Cada una tiene aún una ruta en la v3 hacia la misma respuesta.

• /when-follow devolvía la fecha en que una cuenta empezó a seguir a otra, y solo para cuentas que ya estaban en la base de datos de TweetScout. En la v3, POST /check-follow (se abre en una pestaña nueva) responde si el seguimiento existe. Para las fechas, GET /top-followers cubre a los 20 seguidores más fuertes de una cuenta, y GET /new-followers-7d (se abre en una pestaña nueva) enumera las cuentas cripto que empezaron a seguir en los últimos 7 días.
• /handle-history devolvía los nombres de usuario anteriores de una cuenta. GET /about (se abre en una pestaña nueva) devuelve username_change_count y last_username_change_at, que el Verificador del historial de nombres de usuario de Twitter gratuito muestra para cualquier cuenta.
• "Calidad de la audiencia" era la vista de la app de TweetScout sobre quién sigue a una cuenta. En la API es GET /followers-stats (se abre en una pestaña nueva), que cuenta influencers, proyectos y fondos de capital de riesgo entre los seguidores, además de GET /top-followers y GET /score.
• Un endpoint de sentimiento nunca existió en la v2 ni en la v3. Obtén los posts con POST /search-tweets o POST /mentions y puntúalos con tu propio modelo, como en la guía de análisis de sentimientos en Twitter.
• /v1/analyze en api.tweetscout.io nunca fue un endpoint de TweetScout. Aparece en código de bots de trading generado automáticamente, donde está marcado como endpoint hipotético, y la dirección responde 404. Para esa función, llama a GET /score y GET /followers-stats.

#Lo que la misma clave lee ahora y TweetScout nunca leyó

Sorsa API v3 agregó 20 endpoints que la API de TweetScout nunca tuvo, así que una sola clave ahora cubre las tareas generales de datos de X que los paneles cripto antes compraban a un segundo proveedor. Si tu integración de TweetScout funcionaba junto con otra API para listas de seguidores o búsqueda, usa Sorsa API para ambas: una clave, una factura y los datos de smart followers en el mismo JSON.

Las tareas que llevaban a los usuarios de TweetScout a un segundo proveedor cuestan esto por cada 1,000 resultados en Sorsa API, frente a los precios de la API oficial de X (se abre en una pestaña nueva), que además exige una cuenta de desarrollador y OAuth y se detiene en 3 millones de lecturas de posts al mes:

• Listas completas de seguidores

  Endpoint de Sorsa API

  GET /followers, 200 por página

  Sorsa API, por cada 1,000

  desde $0.007

  API oficial de X, por cada 1,000

  $10.00

• Perfiles por lotes

  Endpoint de Sorsa API

  GET /info-batch, 100 por solicitud

  Sorsa API, por cada 1,000

  desde $0.014

  API oficial de X, por cada 1,000

  $10.00

• Posts por ID

  Endpoint de Sorsa API

  POST /tweet-info-bulk, 100 por solicitud

  Sorsa API, por cada 1,000

  desde $0.014

  API oficial de X, por cada 1,000

  $5.00

• Búsqueda y menciones, hasta 2006

  Endpoint de Sorsa API

  POST /search-tweets, POST /mentions, unos 20 por página

  Sorsa API, por cada 1,000

  desde $0.07

  API oficial de X, por cada 1,000

  $5.00

• Puntaje de influencia cripto y categorías de seguidores

  Endpoint de Sorsa API

  GET /score, GET /followers-stats, una cuenta por solicitud

  Sorsa API, por cada 1,000

  desde $1.40

  API oficial de X, por cada 1,000

  no se ofrece

Para el seguimiento de KOLs y smart followers, que los usuarios de TweetScout hacían en la app, la v3 tiene cuatro llamadas: GET /top-followers y GET /followers-stats para saber quién respalda a una cuenta, y GET /new-followers-7d y GET /new-following-7d para los seguimientos cripto de la última semana. Las listas completas de todos los seguidores, sean cripto o no, salen de GET /followers (se abre en una pestaña nueva); la guía de la API de seguidores de Twitter muestra la exportación completa.

Los demás endpoints nuevos leen citas, quienes hicieron retweet, las respuestas y los retweets de un usuario, Artículos de X, Spaces, tendencias por ubicación, seguidores verificados, seguidores de listas, información de comunidades, miembros y búsqueda, y la comprobación de shadowban. Los equipos que además leen de la API oficial de X pueden migrar desde la API de Twitter/X con el mismo tipo de mapa.

#Migra hoy tu primera llamada de TweetScout

La API de TweetScout sigue viva como Sorsa API v3: cambia la URL base, mueve los nombres de usuario a parámetros de consulta, renombra cursor y 27 de las 29 llamadas antiguas vuelven a funcionar. Sorsa API es el lugar para ejecutarlas: 45 endpoints, con el Sorsa Score incluido, 20 solicitudes por segundo en todos los planes y 100 solicitudes gratis para convertir y probar una integración completa antes de elegir un plan.

#Preguntas frecuentes