Resumen de la API
Referencia REST de TwexAPI — autenticación, formato de respuesta, paginación, errores, límites de tasa y grupos de endpoints.
TwexAPI expone una API REST en https://api.twexapi.io para lecturas, escrituras, búsqueda, seguidores, DMs, listas, comunidades, artículos y utilidades de cuenta de X/Twitter.
Usa esta página como punto de entrada antes de abrir páginas de endpoints individuales en la barra lateral.
URL base
https://api.twexapi.io
Autenticación
Envía tu API key en cada solicitud:
Authorization: Bearer YOUR_API_KEY
Public docs focus on API-key reads.
Formato de respuesta
Las respuestas exitosas usan un sobre consistente:
{
"code": 200,
"msg": "success",
"data": {}
}
Los errores devuelven códigos HTTP distintos de 2xx con un cuerpo JSON. Consulta Error Handling para orientación de recuperación por estado.
Paginación
Muchos endpoints de listas y búsqueda devuelven campos de cursor como has_next_page, next_cursor o tokens de página dentro de data. Pasa el cursor de la respuesta anterior sin modificarlo en la siguiente solicitud. Conserva los cursores fuera del chat o la memoria del flujo de trabajo cuando los jobs deban reanudarse tras fallos.
Consultar saldo
Revisa los créditos restantes antes de exportaciones grandes:
curl --request GET \
--url 'https://api.twexapi.io/balance' \
--header 'Authorization: Bearer YOUR_API_KEY'
Abre Get Balance para el esquema completo.
Grupos de endpoints
Explora las páginas generadas bajo Endpoints en la barra lateral, o salta a grupos comunes:
| Grupo | Trabajos típicos |
|---|---|
| Search | Búsqueda por palabra clave, hashtags, cashtags. Construye searchTerms con Advance Search TwitterXAPI. |
| Users | Consulta de perfil, lecturas de usuarios en lote |
| Followers & Following | Exportación de seguidores y seguidos |
| Tweet Actions | Publicar, responder, like, retweet, bookmark |
| Trending | Temas y tweets en tendencia global |
| DM | Estado de DM, envío e historial |
| Balance | Saldo de créditos |
Rutas de agente y SDK
| Integración | Cuándo usarla |
|---|---|
| MCP Server | Agentes de IA que deben descubrir rutas con explore antes de llamar twexapi_request |
| SDKs | Clientes tipados con reintentos y helpers de paginación |
| CLI | Scripts de terminal y salida JSON |
| Framework Guides | LangChain, CrewAI, n8n, Prefect y otros hosts de agentes |
Guías operativas
- Error Handling — recuperación por estado HTTP, errores MCP y reintentos de escritura
- Rate Limits — orientación de throughput y backoff en
429 - — cookie /
auth_token, comprobaciones de duplicados y créditos en403 - Authentication — API keys, headers Bearer y credenciales de escritura
Lo que TwexAPI no expone hoy
TwexAPI no ofrece de forma nativa monitores de cuenta, webhooks de eventos ni jobs de extracción asíncronos como productos API de primera clase. Usa llamadas REST programadas (Prefect, n8n, cron) o webhooks de plataformas no-code para recibir handoffs de agentes y continuar con solicitudes API directas.