Saltar al contenido principal
Enrow utiliza un sistema basado en créditos, y los créditos solo se consumen cuando se encuentra un resultado o se realiza una comprobación. Esta página explica cómo se cobran los créditos por cada endpoint, cómo consultar tu saldo, cómo gestionar la configuración de facturación y qué ocurre cuando se agotan los créditos.

​
¿Cómo funcionan los créditos?

Los créditos solo se consumen cuando la API devuelve un resultado o completa una comprobación: las búsquedas fallidas que no encuentran nada no cuestan créditos. Cada función consume créditos a una tasa diferente:
EndpointCréditos
Email Finder1 por email encontrado
Phone Finder40 por teléfono encontrado (predeterminado; 50 con planes heredados)
Email Verifier0.25 por comprobación
Los créditos se cobran de la misma forma en las operaciones individuales y masivas: por cada resultado individual. Ejecutar una búsqueda masiva de emails de 1000 nombres cuesta lo mismo por email encontrado que 1000 búsquedas individuales.
Cada solicitud que consume créditos devuelve un campo credits_used en su respuesta, para que puedas hacer un seguimiento del consumo por búsqueda. Consulta Find Single Email para ver un ejemplo de respuesta.

​
¿Cómo consulto mi saldo de créditos?

Consulta el endpoint de la cuenta con tu clave de API en el encabezado x-api-key para recuperar tu saldo de créditos actual. No se necesita ningún cuerpo en la solicitud: la cuenta se identifica a partir de la clave de API. 
curl https://api.enrow.io/account/info \
  -H "x-api-key: YOUR_API_KEY"
Respuesta
{
  "credits": 8500,
  "webhooks": ["https://your-app.com/webhooks/enrow"]
}
La respuesta contiene tu saldo y los webhooks registrados:
CampoDescripción
creditsTu saldo de créditos actual
webhooksArray de las URL de tus webhooks registrados
Para consultar la referencia completa del endpoint, consulta Account info. También puedes visitar tu Panel para ver los detalles de uso y facturación, o consultar la guía de Autenticación para saber cómo funciona el encabezado x-api-key en cada endpoint.

​
¿Cómo gestiono la configuración de facturación?

Desde la página de Facturación de la aplicación, puedes configurar tres opciones que mantienen tu cuenta con saldo y te avisan antes de que se agoten los créditos:
Renueva automáticamente tu plan cuando caduque. Define la cantidad de créditos a renovar en el campo situado junto al interruptor.
Compra automáticamente créditos adicionales de pago por uso cuando tu saldo sea bajo. Define la cantidad de créditos a recargar en el campo situado junto al interruptor.
Recibe una alerta por correo electrónico cuando tu saldo de créditos baje de un umbral. Define el umbral de créditos en el campo situado junto al interruptor.

​
¿Qué ocurre cuando se agotan los créditos?

Cuando tu saldo de créditos llega a cero, las solicitudes a la API devuelven un estado HTTP 402. Los endpoints individuales (búsqueda individual de email/teléfono, verificación individual) devuelven: 
{
  "reason": "Insufficient credits",
  "success": false
}
Los endpoints masivos devuelven { "message": "..." } en su lugar. Para ver la lista completa de códigos de estado y formatos de respuesta, consulta Códigos de estado y Manejo de errores.
Para evitar interrupciones, activa la Recarga automática o la Alerta de saldo bajo desde la página de Facturación.

​
¿Qué plan debería elegir?

Visita enrow.io/pricing para comparar planes y encontrar el más adecuado para tus necesidades. Los créditos de pago por uso se pueden añadir a cualquier plan mediante la Recarga automática.

​
FAQ

No. Los créditos solo se consumen cuando se encuentra un email o un número de teléfono, o cuando se realiza una comprobación de verificación. Una búsqueda que no devuelve ningún resultado no cuesta créditos.
No. Los créditos se cobran por cada resultado individual, por lo que una operación masiva cuesta lo mismo por email, teléfono o verificación encontrados que las solicitudes individuales equivalentes. Los endpoints masivos ahorran solicitudes, no créditos.
El Email Verifier consume 0.25 créditos por comprobación. El Email Finder consume 1 crédito por email encontrado, y el Phone Finder consume 40 créditos por teléfono encontrado (50 con planes heredados).
Las solicitudes devuelven un estado HTTP 402. Los endpoints individuales devuelven { "reason": "Insufficient credits", "success": false }, mientras que los endpoints masivos devuelven { "message": "..." }. Consulta Manejo de errores para más detalles.

​
Próximos pasos

Autenticación

Cómo pasar tu clave de API en el encabezado x-api-key.

Account info

Recupera tu saldo de créditos y los webhooks registrados.

Límites de tasa

Comprende los límites de solicitudes de la API antes de escalar.

Manejo de errores

Maneja con elegancia las respuestas de error 402 y otras.