Skip to main content
Sorsa API ofrece acceso de solo lectura a datos públicos de X (antes Twitter): publicaciones, perfiles, redes de seguidores, métricas de interacción, comunidades y más. Aquí encontrarás los endpoints y las guías correspondientes a cada caso de uso.

Escucha social y seguimiento de marca

Supervisa en tiempo real qué se dice sobre tu marca, producto o sector. Detecta sentimiento negativo antes de que aumente, mide el impacto de campañas y comprende la percepción pública. Endpoints principales:
  • /search-tweets: busca palabras clave, hashtags o frases en publicaciones públicas.
  • /mentions: rastrea menciones de una cuenta y filtra por interacción para reducir el ruido.
  • /list-tweets: supervisa varias cuentas mediante listas de X.
Guías: Búsqueda de publicaciones | Seguimiento de menciones | Supervisión en tiempo real | Operadores de búsqueda

Análisis de la competencia

Compara perfiles de competidores, analiza su estrategia de contenido y la composición de su audiencia, y supervisa lo que se dice sobre ellos. Endpoints principales:
  • /info e /info-batch: datos de perfiles (seguidores, publicaciones y biografía) de una o varias cuentas.
  • /user-tweets: cronología de un competidor para analizar sus contenidos y las publicaciones con mejores resultados.
  • /mentions: comentarios de usuarios sobre un competidor, filtrados por interacción.
  • /followers y /verified-followers: seguidores de un competidor.
  • /score: comparación de influencia en el ecosistema de criptomonedas para cuentas Web3.
Guías: Análisis de competidores | Seguidores y cuentas seguidas | Sorsa Score y análisis de criptomonedas

Captación de clientes potenciales y descubrimiento de audiencias

Encuentra clientes potenciales, socios o miembros de una comunidad buscando perfiles, obteniendo seguidores de cuentas relevantes, consultando miembros de comunidades o identificando personas que hablan sobre temas concretos. Endpoints principales:
  • /search-users: encuentra cuentas por palabras clave de su biografía, como cargos, intereses o especialidades.
  • /followers: obtén seguidores de un competidor o referente del sector.
  • /community-members: consulta miembros de comunidades temáticas de X.
  • /search-tweets: encuentra personas que publican sobre problemas que resuelve tu producto.
Guías: Descubrimiento del público objetivo | Seguidores y cuentas seguidas | Listas y comunidades

Campañas de marketing y verificación de sorteos

Organiza campañas con tareas como seguir, retuitear, comentar, citar o unirse a una comunidad. Comprueba que cada participante haya completado las acciones y automatiza la entrega de recompensas según el resultado. Endpoints principales:
  • /check-follow: ¿el usuario sigue tu cuenta?
  • /check-retweet: ¿ha retuiteado una publicación concreta?
  • /check-comment: ¿ha dejado un comentario?
  • /check-quoted: ¿ha citado la publicación?
  • /check-community-member: ¿se ha unido a tu comunidad?
Guía: Verificación de campañas de marketing

Investigación histórica y recopilación de datos

Accede al archivo de publicaciones públicas desde 2006. Analiza acontecimientos pasados, crea conjuntos de entrenamiento, estudia la evolución de las conversaciones o revisa el historial de publicaciones de una marca. Endpoints principales:
  • /search-tweets con since: y until:: búsqueda por palabras clave en un intervalo histórico.
  • /user-tweets: recorre las páginas de la cronología de una cuenta.
  • /tweet-info-bulk: completa una lista de IDs de publicaciones con sus datos actuales de interacción.
Guías: Datos históricos | Operadores de búsqueda

Supervisión en tiempo real y alertas

Detecta nuevas publicaciones de cuentas concretas o que coincidan con palabras clave pocos segundos después de su publicación. Envía alertas a Slack, Discord, bases de datos o webhooks propios. Endpoints principales:
  • /list-tweets: supervisa una lista de X de hasta 5.000 cuentas con una solicitud por ciclo.
  • /user-tweets: sigue una cuenta prioritaria.
  • /search-tweets con order: "latest": supervisa una palabra clave o hashtag.
  • /mentions: detecta nuevas menciones con @.
Guía: Supervisión en tiempo real

Análisis de publicaciones

Analiza quién respondió, citó o retuiteó una publicación y qué dijo. Evalúa el alcance, identifica comentaristas destacados y compara resultados del contenido. Endpoints principales:
  • /tweet-info y /tweet-info-bulk: métricas completas de una o varias publicaciones.
  • /comments: respuestas a una publicación.
  • /quotes: publicaciones que la citan.
  • /retweeters: usuarios que la retuitearon.
  • /article: contenido completo de artículos largos de X.
Guías: Interacción con publicaciones | Artículos de X

Geografía y demografía de la audiencia

Comprende dónde se encuentra la audiencia de una cuenta. Analiza la distribución de seguidores por país para orientar anuncios, evaluar influencers o investigar nuevos mercados. Endpoints principales:
  • /followers: obtén la lista de seguidores.
  • /about: consulta el país asociado a cada cuenta.
Guía: Geografía de la audiencia

Análisis de criptomonedas y Web3

Evalúa la influencia de cuentas de criptomonedas con la puntuación propia de Sorsa, que mide su reconocimiento entre líderes de opinión, proyectos y fondos de capital riesgo del sector. Sigue su evolución, identifica proyectos emergentes y detecta crecimiento no orgánico. Endpoints principales:
  • /score y /score-changes: puntuación de influencia y variaciones semanales y mensuales.
  • /followers-stats: desglose por categorías (influencers, proyectos y fondos).
  • /top-followers y /top-following: los 20 principales por puntuación.
  • /new-followers-7d y /new-following-7d: actividad reciente de seguimiento entre cuentas del sector.
Guía: Sorsa Score y análisis de criptomonedas

Datos de entrenamiento para IA y LLM

Recopila grandes conjuntos de publicaciones para ajustar modelos de lenguaje, entrenar clasificadores de sentimiento o crear flujos de generación aumentada por recuperación (RAG). Sorsa devuelve JSON estructurado que puedes incorporar a tus procesos de aprendizaje automático. Endpoints principales:
  • /search-tweets: recopila publicaciones por tema, idioma e intervalo de fechas.
  • /user-tweets: consulta cronologías para crear corpus.
  • /comments y /quotes: recopila conversaciones, pares de preguntas y respuestas y debates.
Guías: Búsqueda de publicaciones | Datos históricos | Optimización del uso de la API

Desarrollo de plataformas SaaS y de análisis

Crea tu herramienta de análisis social, panel o plataforma de supervisión sobre los datos de Sorsa. El precio uniforme (una llamada equivale a una solicitud, independientemente de cuántos datos devuelva) y el límite de 20 solicitudes por segundo permiten atender a varios usuarios finales con una sola clave. Endpoints principales: todos los endpoints están disponibles en todos los planes. Consulta la especificación en la referencia de la API. Guías: Optimización del uso de la API | Precios | Límites de solicitudes

Encuentra el endpoint adecuado

Si ya sabes qué datos necesitas, busca aquí el endpoint correspondiente:

¿No sabes por dónde empezar?

  1. Obtén tu clave de API: sigue la guía de inicio rápido. Cada cuenta incluye 100 solicitudes gratuitas, sin tarjeta y sin caducidad.
  2. Prueba una búsqueda: pega este ejemplo en la terminal para ver datos en 10 segundos:
  1. Explora sin escribir código: prueba cualquier endpoint en la interfaz de API Playground.
  2. Elige una guía de la lista anterior que corresponda a tu caso de uso.
  3. Consulta los precios: estima el coste mensual en Precios.