> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ajustes de API

> Configura el acceso a la API de Enrow, tu clave de API, una URL de webhook predeterminada y el parámetro country_code desde el panel

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](/es/credits-billing).

## ¿Dónde encuentro mi clave de API?

Tu clave de API está en el [Panel de Enrow](https://app.enrow.io) — 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](/es/authentication).

<Warning>
  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.
</Warning>

## ¿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](/es/how-webhooks-work).

## ¿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`.

<Info>
  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.
</Info>

El código de país es especialmente útil para los **homónimos** — empresas que comparten el mismo nombre en diferentes países:

```json theme={null}
// 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](/es/api-reference/email-finder/find-single) para ver la lista completa de ajustes disponibles.

## FAQ

<AccordionGroup>
  <Accordion title="¿Necesito una clave de API distinta por endpoint?">
    No. Una sola clave de API autentica todos los endpoints — [Email Finder](/es/api-reference/email-finder/find-single), [Email Verifier](/es/api-reference/email-verifier/verify-single) y [Phone Finder](/es/api-reference/phone/find-single). Pasa la clave en el encabezado `x-api-key` en cada solicitud.
  </Accordion>

  <Accordion title="¿Funciona country_code con company_domain?">
    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.
  </Accordion>

  <Accordion title="¿Qué ocurre si configuro tanto un webhook en el panel como un webhook por solicitud?">
    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`.
  </Accordion>
</AccordionGroup>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Autenticación" icon="key" href="/es/authentication">
    Cómo pasar tu clave de API en el encabezado x-api-key.
  </Card>

  <Card title="Cómo funcionan los webhooks" icon="bell" href="/es/how-webhooks-work">
    Configura webhooks para recibir notificaciones cuando una búsqueda finalice.
  </Card>

  <Card title="Créditos y facturación" icon="coins" href="/es/credits-billing">
    Consulta cómo se consumen los créditos en cada endpoint.
  </Card>

  <Card title="Buscar un email" icon="envelope" href="/es/api-reference/email-finder/find-single">
    Ejecuta una búsqueda de un solo email con ajustes personalizados.
  </Card>
</CardGroup>