Límites de velocidad

Cómo limitamos la velocidad

El límite de velocidad es por cuenta, medido en peticiones por segundo (QPS). El techo depende solo de si alguna vez has comprado créditos, con un pequeño incremento en los dos planes de suscripción más altos.

No hay tope mensual ni diario: puedes consumir cualquier cantidad de créditos al mes mientras te mantengas por debajo del techo por segundo.

Las suscripciones de Stream (monitoreo de cuentas) son independientes de la API REST. Un plan de stream no incluye créditos de API ni un límite de velocidad REST más alto: las llamadas REST se pagan con créditos y, hasta que compres créditos, tu cuenta se mantiene en el límite gratuito de una petición cada 5 segundos.

Límites reales

Estado de la cuentaLímite de velocidad
Cuenta nueva (nunca ha pagado)
0,2 req/s — suficiente para probar la API y anima a la primera recarga.
1 petición / 5 segundos
Cualquier cuenta que haya comprado créditos al menos una vez
Basta con una única compra de créditos; no es necesaria suscripción.
20 req/s
Suscripciones Starter · Builder · Pro
Estos planes compiten en créditos, bono y devolución de créditos, no en caudal. ¿Necesitas más QPS sostenido? Mira Scale y Business más abajo.
20 req/s
Suscripción Scale
50 req/s
Suscripción Business
500 req/s
Necesidades mayores
Escribe a contact@twitterapi.io con tu caso de uso y los req/s sostenidos que esperas.
A petición

¿Eliges un plan? Consulta /subscribe — Starter, Builder y Pro se diferencian en créditos concedidos, porcentaje de bonificación de recarga y devolución de créditos continua. Si necesitas más de 20 req/s de forma sostenida, Scale (50 req/s) y Business (500 req/s) son los planes donde sube el techo.

¿Tráfico en ráfagas? Al tocar el techo recibirás un HTTP 429 (no se envía la cabecera Retry-After). Espera alrededor de un segundo y reintenta con retroceso exponencial; no bloqueamos la cuenta.