Documentación de la API

Todo lo que necesitas para integrar el enriquecimiento de datos de DataEnrichPro en tu producto.

Autenticación

Cada petición a la API necesita el header Authorization: Bearer <tu-api-key>.

Tu API key se te entrega por email justo después de completar el pago de la suscripción. Guárdala en un lugar seguro: por motivos de seguridad no se almacena en texto plano y no se puede volver a mostrar si la pierdes. Si eso ocurre, contacta con soporte para que te ayudemos a resolverlo.

Endpoint

GET https://dataenrichpro.com/api/v1/enrich

Parámetros de query string (indica exactamente uno de los dos):

domain — un dominio de empresa. Ejemplo: ejemplo.com
email — una dirección de email a verificar. Ejemplo: persona@ejemplo.com

Búsqueda por dominio:

curl "https://dataenrichpro.com/api/v1/enrich?domain=ejemplo.com" \
  -H "Authorization: Bearer <tu-api-key>"

Verificación de un email:

curl "https://dataenrichpro.com/api/v1/enrich?email=persona@ejemplo.com" \
  -H "Authorization: Bearer <tu-api-key>"

Respuesta

Petición correcta: 200 OK

{
  "domain": "ejemplo.com",
  "organization": "Ejemplo Inc.",
  "emails": [
    {
      "value": "contacto@ejemplo.com",
      "first_name": "Ana",
      "last_name": "García",
      "position": "Marketing Manager",
      "confidence": 92
    }
  ]
}

La estructura exacta de la respuesta la define el proveedor mayorista de datos (actualmente Hunter.io) y puede variar entre la búsqueda por dominio y la verificación de email. El JSON de arriba es solo orientativo de la forma y los campos típicos que puedes esperar: nombre, empresa, emails encontrados y nivel de confianza.

Errores

Código	Error	Significado
400	invalid_query	Falta `domain` o `email` en la petición.
401	missing_api_key / invalid_api_key	Falta el header `Authorization` o la key no es válida.
402	insufficient_credits	Sin créditos restantes este mes. Se resetean el día de renovación de tu suscripción.
403	token_suspended	Suscripción suspendida por un cobro fallido. Regulariza el pago para reactivar el acceso.
429	rate_limit_exceeded	Más de 60 peticiones por minuto con la misma API key.
502	provider_unavailable	El proveedor de datos no respondió. Reintenta la petición.

Límites

60 peticiones por minuto por API key.