---
title: "Resumen de la API"
description: "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

```txt
https://api.twexapi.io
```

## Autenticación

Envía tu API key en cada solicitud:

```bash
Authorization: Bearer YOUR_API_KEY
```

Public docs focus on API-key reads.

## Formato de respuesta

Las respuestas exitosas usan un sobre consistente:

```json
{
  "code": 200,
  "msg": "success",
  "data": {}
}
```

Los errores devuelven códigos HTTP distintos de 2xx con un cuerpo JSON. Consulta [Error Handling](/guides/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:

```bash
curl --request GET \
  --url 'https://api.twexapi.io/balance' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

Abre [Get Balance](/api-reference/balance-endpoints/get-balance-api-balance-get) 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](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post) | Búsqueda por palabra clave, hashtags, cashtags. Construye `searchTerms` con [Advance Search TwitterXAPI](https://x-advanced-search.cc). |
| [Users](/api-reference/twitter-user-about-endpoints/get-twitter-user-about-by-screen-name-api-twitter-screen-name-about-get) | Consulta de perfil, lecturas de usuarios en lote |
| [Followers & Following](/api-reference/followers-following-endpoints/followers-v3-api-v3-twitter-users-followers-post) | Exportación de seguidores y seguidos |
| [Tweet Actions](/api-reference/tweet-actions-endpoints/create-tweet-twitter-tweets-create-post) | Publicar, responder, like, retweet, bookmark |
| [Trending](/api-reference/trending-endpoints/get-global-trending-tweets-api-twitter-global-trending-tweets-get) | Temas y tweets en tendencia global |
| [DM](/api-reference/dm-endpoints/send-dm-v3-api-v3-twitter-send-dm-post) | Estado de DM, envío e historial |
| [Balance](/api-reference/balance-endpoints/get-balance-api-balance-get) | Saldo de créditos |

## Rutas de agente y SDK

| Integración | Cuándo usarla |
| --- | --- |
| [MCP Server](/mcp/overview) | Agentes de IA que deben descubrir rutas con `explore` antes de llamar `twexapi_request` |
| [SDKs](/sdks) | Clientes tipados con reintentos y helpers de paginación |
| [CLI](/sdks/cli) | Scripts de terminal y salida JSON |
| [Framework Guides](/guides/langchain) | LangChain, CrewAI, n8n, Prefect y otros hosts de agentes |

## Guías operativas

- [Error Handling](/guides/error-handling) — recuperación por estado HTTP, errores MCP y reintentos de escritura
- [Rate Limits](/guides/rate-limits) — orientación de throughput y backoff en `429`
- — cookie / `auth_token`, comprobaciones de duplicados y créditos en `403`
- [Authentication](/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.