API para desarrolladores

API REST con desbloqueos por unidad. Las búsquedas nunca devuelven datos de contacto.

OpenAPI 3.1 (JSON)

Autenticación

Crea una clave en tu cuenta (Prueba o Producción). Envíala como Authorization: Bearer ibd_…. Las claves se muestran una vez; solo guardamos un hash.

Endpoints

• POST /companies/search — datos básicos y disponibilidad
• POST /contacts/reveal — revela email/teléfono; 3 créditos API por email y 4 por teléfono entregado
• POST /contacts/bulk-reveal → GET /jobs/{id} — lotes asíncronos
• GET /balance, GET /usage

Reglas de cobro

• La API usa sus propios créditos API, que se compran en packs API y son independientes de los créditos web. Precios API
• Cada email entregado cuesta 3 créditos API y cada teléfono 4. Solo se cobra lo que se entrega.
• Los datos ausentes nunca se cobran. Volver a pedir un campo ya adquirido es gratis (web y API comparten permisos).
• La resolución por nombre con varias coincidencias devuelve candidatos (HTTP 300) sin cobrar.
• Las actualizaciones posteriores de un campo comprado no generan nuevo cargo (política configurable antes del lanzamiento).

cURL

curl -X POST https://nifdata.com/api/v1/contacts/reveal \
  -H "Authorization: Bearer ibd_test_xxxxxxxx_..." \
  -H "Content-Type: application/json" \
  -d '{"id":"<record_id>","fields":["email","phone"]}'

JavaScript

const r = await fetch("https://nifdata.com/api/v1/contacts/reveal", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.IBERIADATA_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ name: "Panadería Ejemplo SL", province: "28", fields: ["email"] }),
});
const data = await r.json();
if (r.status === 300) console.log("candidates:", data.candidates); // varias coincidencias: no se cobra
else console.log(data.delivered, data.consumed, data.balance);

Python

import os, requests
r = requests.post("https://nifdata.com/api/v1/contacts/reveal",
    headers={"Authorization": f"Bearer {os.environ['IBERIADATA_KEY']}"},
    json={"id": "<record_id>", "fields": ["phone"]})
print(r.status_code, r.json())

Conectar desde Clay (acción HTTP API)

1. En Clay, añade una columna de enriquecimiento → «HTTP API».
2. Method: POST · URL: https://nifdata.com/api/v1/contacts/reveal
3. Headers: Authorization: Bearer {{API key}} · Content-Type: application/json
4. Body: {"name": "{{Company name}}", "province": "{{Province code}}", "fields": ["email"]}
5. Mapea delivered.email a una columna. Gestiona el estado 300 (candidatos) y 402 (saldo).

Esta es una guía de integración HTTP genérica; no existe un acuerdo oficial con Clay.

Licencia de uso

Los datos obtenidos por la API se licencian únicamente para uso interno de la organización titular de la cuenta. Está prohibido revenderlos, sublicenciarlos, redistribuirlos o incorporarlos a productos ofrecidos a terceros; su incumplimiento supone la revocación inmediata de las claves. Términos, cláusula 3.

Límites

Por clave y por cuenta: por minuto, día y mes; tamaño de lote y trabajos simultáneos. Las respuestas incluyen X-Request-Id. 429 incluye Retry-After.