Saltar al contenido principal
La API de Enrow aplica límites de tasa para garantizar un uso justo y mantener la calidad del servicio. El límite es el mismo en todos los endpoints y todos los planes, se aplica por clave de API y se mide en solicitudes por segundo (RPS). Esta página explica los límites predeterminados, qué ocurre cuando los superas y cómo mantenerte dentro de la cuota al escalar.

​
¿Cuáles son los límites de tasa predeterminados?

Cada endpoint POST permite 10 solicitudes por segundo por clave de API. El límite es idéntico en todos los endpoints y todos los planes:
EndpointLímite de tasa
POST /email/find/single10 req/s
POST /email/find/bulk10 req/s
POST /email/verify/single10 req/s
POST /email/verify/bulk10 req/s
POST /phone/single10 req/s
POST /phone/bulk10 req/s
Los endpoints GET no tienen límite de tasa, por lo que recuperar resultados — por ejemplo el resultado de un solo email o los resultados masivos — no cuenta para tu cuota.
Los límites de tasa son por clave de API y se miden en solicitudes por segundo (RPS). Cada clave de API tiene su propia cuota independiente.

​
¿Qué ocurre cuando supero el límite de tasa?

Cuando superas el límite de tasa, la API devuelve una respuesta 429 Too Many Requests: 
{
  "message": "Too Many Requests"
}
La forma recomendada de gestionar un 429 es implementar un backoff exponencial — esperar un retardo progresivamente mayor antes de cada reintento para que la clave de API tenga tiempo de volver por debajo del límite: 
async function requestWithRetry(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      const delay = Math.pow(2, attempt) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
      continue;
    }

    return response;
  }

  throw new Error('Max retries exceeded');
}
Para ver la lista completa de códigos de respuesta y cómo gestionarlos, consulta Códigos de estado y Gestión de errores.

​
¿Cómo puedo evitar alcanzar el límite de tasa?

La forma más eficaz de mantenerte dentro de la cuota es enviar menos solicitudes pero más grandes y recibir los resultados mediante webhooks en lugar de sondeo.
En lugar de realizar 100 solicitudes individuales, realiza 1 solicitud masiva (hasta 5.000 elementos para email, 3.000 para teléfono). Un único POST masivo cuenta como 1 solicitud frente a tu límite de tasa.
// ❌ 100 requests = 10 seconds at 10 RPS
for (const contact of contacts) {
  await findEmail(contact);
}

// ✅ 1 request
await findEmailsBulk(contacts);
Consulta Buscar emails y Verificar emails para empezar.
Sondear el endpoint GET desperdicia tu cuota de límite de tasa. Usa webhooks para recibir los resultados automáticamente en cuanto se completa una búsqueda o verificación.
Guarda los resultados para evitar llamadas redundantes a la API para el mismo contacto, lo que además ahorra créditos.

​
¿Puedo obtener límites de tasa más altos?

Sí. Enrow puede aumentar tu RPS caso por caso. Contáctanos en api@enrow.io indicando tu caso de uso y el volumen previsto.

​
FAQ

No. El límite de 10 req/s se aplica de forma independiente a cada endpoint POST, y la cuota se rastrea por clave de API en lugar de por cuenta.
No. Los endpoints GET no tienen límite de tasa, por lo que sondear resultados no consume tu cuota de RPS. Dicho esto, los webhooks siguen siendo preferibles al sondeo frecuente.
Sí. Un único POST masivo cuenta como 1 solicitud frente a tu límite de tasa, aunque puede contener hasta 5.000 elementos para email o 3.000 para teléfono.
Una respuesta 429 Too Many Requests con el cuerpo { "message": "Too Many Requests" }. Reintenta con backoff exponencial. Consulta Gestión de errores para más detalles.

​
Próximos pasos

Buscar emails en masa

Ejecuta hasta 5.000 búsquedas de email en una sola solicitud para ahorrar cuota de límite de tasa.

Webhooks

Recibe los resultados automáticamente en lugar de sondear los endpoints GET.

Gestión de errores

Gestiona el código 429 y otras respuestas de forma elegante en tu integración.

Créditos y facturación

Consulta cómo se consumen los créditos en cada endpoint.