Límites de tasa

Obtén información sobre los límites de tasa de la API en los productos para desarrolladores de X

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 X API aplica su propio enfoque de límites de tasa:

X API v2

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

Enterprise API

Límites personalizados basados en tu acuerdo empresarial y paquete de datos.

X Ads API

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

---

Cómo funcionan los límites de tasa

Concepto	Descripción
Ventana temporal	La mayoría de los límites se restablecen cada 15 minutos
Límites por usuario	Se aplican cuando se utilizan tokens de usuario de OAuth 1.0a u OAuth 2.0
Límites por aplicación	Se aplican cuando se usa autenticación con Bearer Token (solo App)
Específicos por endpoint	Cada endpoint tiene su propio límite

---

Comprobar tus límites de uso

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

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

Header	Description
x-rate-limit-limit	Número 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 en la que se restablece el límite

---

Errores de límite de frecuencia

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

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

---

Mejores prácticas

Almacenar respuestas en caché

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

Usar backoff exponencial

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

Revisar encabezados

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

Usar streaming

Para datos en tiempo real, usa una transmisión filtrada en lugar de hacer polling a los endpoints de búsqueda.

---

Próximos pasos

Para ver tablas detalladas de límites de tasa para cada endpoint, consulta la página de límites de tasa de la API específica que estés usando:

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