Saltar al contenido principal
Los ajustes de API controlan cómo accedes a la API de Enrow y cómo se comporta en cada solicitud. Esta página cubre quién puede acceder a la API, dónde encontrar tu clave de API, cómo configurar una URL de webhook predeterminada y cómo el parámetro country_code cambia el comportamiento de las búsquedas.

¿Quién puede acceder a la API de Enrow?

La API de Enrow está disponible para clientes con una suscripción activa o créditos de pago por uso. Si tu cuenta no tiene ninguno de los dos, la sección de API no estará accesible. Para ver cómo se consumen los créditos por endpoint, consulta Créditos y facturación.

¿Dónde encuentro mi clave de API?

Tu clave de API está en el Panel de Enrow — haz clic en API en el menú de la izquierda y copia la clave. La misma clave autentica todos los endpoints a través del encabezado x-api-key. Para ejemplos de solicitudes y manejo de errores, consulta Autenticación.
Mantén tu clave de API segura. Nunca incluyas la clave de API en el control de versiones ni la compartas públicamente. Trátala como una contraseña.

¿Cómo configuro una URL de webhook predeterminada?

Puedes configurar una URL de webhook predeterminada en el panel. Esta URL se usa siempre que no se especifique un webhook en una solicitud individual, así no tienes que repetirla en cada llamada. Un webhook por solicitud en el objeto settings siempre anula el valor predeterminado del panel. Para conocer los formatos de carga útil, los reintentos y la seguridad, consulta Cómo funcionan los webhooks.

¿Qué hace el parámetro country_code?

El parámetro country_code (ISO 3166-1 alpha-2) establece qué versión local de Google usa la API para resolver una empresa. Pásalo en el objeto settings de tu solicitud. Si no se proporciona nada, el valor predeterminado es US.
El código de país solo es útil al buscar con company_name (no company_domain). Le indica a Enrow qué versión local de Google usar para resolver la empresa — por ejemplo, google.de para Alemania o google.fr para Francia.
El código de país es especialmente útil para los homónimos — empresas que comparten el mismo nombre en diferentes países:
// Dove the soap brand (UK)
{
  "company_name": "Dove",
  "fullname": "John Doe",
  "settings": { "country_code": "GB" }
}

// Dove the chocolate brand (Germany)
{
  "company_name": "Dove",
  "fullname": "Hans Müller",
  "settings": { "country_code": "DE" }
}
El objeto settings también acepta webhook (una URL de webhook por solicitud), retrieve_gender (booleano) y retrieve_company_info (booleano). Consulta la referencia de Buscar email para ver la lista completa de ajustes disponibles.

FAQ

No. Una sola clave de API autentica todos los endpoints — Email Finder, Email Verifier y Phone Finder. Pasa la clave en el encabezado x-api-key en cada solicitud.
No. El parámetro country_code solo afecta a las búsquedas que usan company_name. Cuando pasas un company_domain, el dominio ya identifica a la empresa, por lo que el código de país no tiene efecto.
El webhook por solicitud en el objeto settings tiene prioridad. El valor predeterminado del panel solo se usa cuando una solicitud no incluye su propia URL de webhook.

Próximos pasos

Autenticación

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

Cómo funcionan los webhooks

Configura webhooks para recibir notificaciones cuando una búsqueda finalice.

Créditos y facturación

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

Buscar un email

Ejecuta una búsqueda de un solo email con ajustes personalizados.