Límites de tasa

Comprende los límites de tasa de la X API por niveles de acceso y endpoints, incluidos los límites a nivel de app vs. de usuario, los encabezados de respuesta y las mejores prácticas para reintentos.

Los límites de tasa controlan cuántas solicitudes a la API puedes realizar en un período de tiempo determinado. Garantizan un uso justo y la estabilidad del sistema en toda la plataforma.

---

Límites de tasa por producto

Cada producto de la X API tiene su propio enfoque de límite de tasa:

X API v2

Límites por endpoint basados en ventanas de 15 minutos. Consulta tablas detalladas y consejos de recuperación.

Enterprise API

Límites personalizados según tu acuerdo enterprise y paquete de datos.

X Ads API

Límites específicos para los endpoints de gestión de anuncios y analítica.

---

Cómo funcionan los límites de tasa

Concepto	Descripción
Ventana de tiempo	La mayoría de los límites se reinician cada 15 minutos
Límites por usuario	Se aplican al usar tokens de usuario de OAuth 1.0a u OAuth 2.0
Límites por app	Se aplican al usar autenticación con Bearer Token (app-only)
Por endpoint	Cada endpoint tiene su propio límite

---

Comprobar tus límites

Cada respuesta de la API incluye encabezados que muestran el estado actual del límite de tasa:

x-rate-limit-limit: 900
x-rate-limit-remaining: 847
x-rate-limit-reset: 1705420800

Encabezado	Descripción
x-rate-limit-limit	Máximo de solicitudes permitidas en la ventana actual
x-rate-limit-remaining	Solicitudes restantes en la ventana actual
x-rate-limit-reset	Marca de tiempo Unix de cuándo se reinicia el límite

---

Errores de límite de tasa

Cuando superas un límite de tasa, recibirás una respuesta 429 Too Many Requests:

{
  "errors": [{
    "code": 88,
    "message": "Rate limit exceeded"
  }]
}

---

Mejores prácticas

Almacena respuestas en caché

Almacena las respuestas de la API localmente para reducir solicitudes repetidas para los mismos datos.

Usa retroceso exponencial

Cuando se aplique el límite, espera antes de reintentar. Duplica el tiempo de espera con cada reintento.

Revisa los encabezados

Monitorea los encabezados de límite de tasa para evitar alcanzar los límites de forma proactiva.

Usa streaming

Para datos en tiempo real, usa filtered stream en lugar de hacer polling a los endpoints de búsqueda.

---

Próximos pasos

Para tablas detalladas de límites de tasa por endpoint, consulta la página de límites de tasa de tu API específica:

• Límites de tasa de la X API v2
• Límites de tasa de la X Ads API