Migrar de la API oficial de X v2 a Sorsa API v3
Esta referencia cubre autenticación, equivalencias de endpoints, respuestas, paginación, métodos HTTP, sintaxis de búsqueda, errores y ejemplos de cURL, Python y JavaScript. Sorsa es de solo lectura. Si tu integración publica, envía mensajes, da Me gusta o sigue cuentas, conserva la API oficial para esas operaciones y migra solo las lecturas. Las 100 solicitudes gratuitas de cada cuenta, sin tarjeta, permiten validar los endpoints antes de migrar tráfico de producción.Nota: consulta costes y ejemplos paso a paso en la guía completa de migración.
Resumen de cambios
Autenticación
La API oficial utiliza OAuth 2.0 Bearer para solicitudes de aplicación y OAuth 1.0a User Context para solicitudes de usuario.ApiKey. Genera las claves en el panel.
Equivalencias de endpoints
Usuarios
GET /info-batchacepta hasta 100 nombres o IDs. Repite el parámetro:?usernames=a&usernames=b.GET /followersyGET /followsdevuelven hasta 200 perfiles completos por página, con biografía, contadores y verificación.
Publicaciones
tweet_linkacepta una URL completa comohttps://x.com/user/status/123o el ID"123".POST /tweet-info-bulkdevuelve hasta 100 publicaciones por solicitud. Utilízalo en lugar de repetirPOST /tweet-infopara reducir hasta 100 veces las llamadas.POST /user-tweetsno tiene un máximo de 3.200 publicaciones. Recorrenext_cursorhasta que no aparezca para consultar toda la cronología. Consulta Datos históricos.
Búsquedas
/search-tweetsutiliza la sintaxis de búsqueda avanzada de la web de X. Muchos términos básicos se conservan, pero revisa los operadores específicos de API v2 antes de reutilizar consultas. Consulta Operadores de búsqueda.POST /mentionsañade filtros comomin_likes,min_replies,min_retweets,since_dateyuntil_date.
Listas
Comunidades
La API oficial de X no expone estos endpoints de comunidades; son funciones de Sorsa.
Consulta los parámetros y la nota de disponibilidad en Listas y comunidades. Confirma la compatibilidad actual antes de migrar este tipo de flujo.
Verificación
Estos endpoints responden a preguntas sobre acciones concretas. La API oficial no tiene un equivalente directo; replicarlos requiere recuperar listas y examinarlas en el cliente.
Consulta Verificación de campañas.
Análisis exclusivo de Sorsa
Estos endpoints indexan un subconjunto de cuentas del sector de criptomonedas: influencers, proyectos y fondos. Consulta Sorsa Score y análisis de criptomonedas.
Utilidades
Consulta Conversión de IDs.
Cambios en las respuestas
Es uno de los cambios principales. La API oficial envuelve los resultados endata, includes y meta. Sorsa devuelve objetos planos con el autor incluido en cada publicación.
Perfil de usuario
API oficial de X v2, con selección de campos:Publicación
API oficial de X v2, conexpansions=author_id:
Equivalencias de campos
Campos de usuario
Campos de publicación
Paginación
La API oficial envíapagination_token y devuelve meta.next_token. Sorsa utiliza next_cursor en ambas direcciones.
En GET, envíalo como parámetro de consulta:
null, no quedan páginas. Consulta Paginación.
Diferencias de método HTTP
Algunos endpoints GET de la API oficial son POST en Sorsa.
Como regla general, los endpoints de publicaciones, búsquedas y comunidades utilizan POST con JSON; esto incluye
/user-tweets aunque reciba un usuario. Los de usuarios, listas y utilidades utilizan GET con parámetros de consulta o ruta. La excepción es /check-comment: usa GET aunque reciba un enlace de publicación. Comprueba siempre la referencia si tienes dudas.
Ejemplos de migración de código
Consultar un perfil
Antes: API oficialBuscar publicaciones
Antes:Recorrer todos los seguidores
Antes:Sintaxis de búsqueda
Sorsa utiliza los operadores de la búsqueda avanzada web de X, que difieren de los de API v2. Conserva palabras, frases,from: y to: cuando corresponda, adapta los filtros específicos y prueba la consulta. Por ejemplo, usa -filter:nativeretweets para excluir retuits nativos.
Referencia completa: Operadores de búsqueda.
/mentions admite además min_likes, min_replies, min_retweets, since_date y until_date. Consulta Seguimiento de menciones.
Gestión de errores
La API oficial devuelve un arrayerrors:
400, 401, 403, 404, 429 y 500. Consulta Códigos de error.
Ante un 429, espera y reintenta. El límite común es 20 solicitudes por segundo, sin ventanas independientes por endpoint. Consulta Límites de solicitudes.
Función de reintento compatible con ambas APIs:
Lista de comprobación de la migración
- Sustituye
Authorization: Bearer ...porApiKey: .... - Elimina la firma OAuth 1.0a de las lecturas migradas: claves de consumidor, tokens y generación de firmas.
- Cambia
https://api.x.com/2porhttps://api.sorsa.io/v3. - Adapta cada ruta según las tablas.
- Cambia GET por POST en publicaciones, búsquedas, comentarios, citas y usuarios que retuitearon.
- Elimina
tweet.fields,user.fields,media.fieldsyexpansions. - Actualiza los lectores de respuestas: elimina la extracción de
data,includesymeta. - Cambia los nombres de campos, como
namepordisplay_nameytextporfull_text. - Accede a las métricas sin
public_metrics. - Sustituye
pagination_tokenynext_tokenpornext_cursor. - Adapta los errores a
{ "message": "..." }. - Aplica el límite común de 20 solicitudes por segundo.
- Prueba los endpoints críticos en API Playground.
- Supervisa la cuota con
GET /key-usage-info. - Conserva la API oficial para operaciones de escritura si las necesitas.