API v1

API de NameCheck360

Búsqueda de personas y empresas, perfiles, sanciones y secciones en JSON, con las mismas reglas que el sitio.

Autenticación

Cree una clave en Cuenta > Claves de API (planes Business y Enterprise) y envíela en la cabecera Authorization (o X-Api-Key).

curl -H "Authorization: Bearer nc360_xxxxxxxx_…" https://namecheck360.com/api/v1/usage
  • Abrir un perfil nuevo cuenta una consulta del mes, como en el sitio; volver a leerlo el mismo mes es gratis.
  • Las búsquedas por IA se descuentan de los créditos de IA mensuales de la organización.
  • Límite: 120 peticiones por minuto y por clave.
  • Cada llamada se registra en el registro de actividad de la organización.
  • El modo confidencial no está disponible a través de la API.

Flujo típico

  1. GET /search: encuentre la persona o empresa correcta entre los candidatos (gratis).
  2. POST /profiles con el «token» del candidato: el perfil se abre y sus búsquedas se ponen en cola.
  3. POST /profiles/{profile}/work, repetido hasta «pending»: 0 (cada llamada ejecuta un paso, 10 a 60 s).
  4. GET /profiles/{profile}/sections/{section} para leer cada sección (sanctions, pep, adverse, wealth…).

GET /api/v1/usage

Consultas, reaperturas y créditos de IA del mes.

Respuesta

{"plan":"business","period":"2026-10","profiles":{"used":12,"limit":400},"watched_reopenings":{"used":3,"limit":500},"ai_credits":{"used":240,"limit":10000,"left":9760},"max_power":"deep"}

GET /api/v1/search?q=Bernard%20Arnault&type=person

Candidatos de las fuentes gratuitas (Wikidata, registros, GLEIF, listas de sanciones). Filtros opcionales: country, year, city, company. No cuenta ninguna consulta.

Respuesta

{"query":"Bernard Arnault","type":"person","candidates":[{"name":"Bernard Arnault","birth_date":"1949-03-05","country":"France","source":"wikidata","wikidata_id":"Q32055","profile":"bernard-arnault-1949","token":"eyJ…"}]}

POST /api/v1/profiles

Abre el perfil de un candidato («token») o, sin candidato, lo crea a partir de criterios: name + al menos dos de year, country, role, context.

Cuerpo (JSON)

{"token":"eyJ…","type":"person"}

Respuesta

{"profile":"bernard-arnault-1949","name":"Bernard Arnault","risk":{"score":36,"level":"medium"},"pending":12,"sections":{"identity":{"status":"queued"}}}

GET /api/v1/profiles/{profile}

Resumen del perfil y estado de cada sección. Cuenta una consulta la primera vez en el mes.

POST /api/v1/profiles/{profile}/work

Ejecuta el siguiente paso de búsqueda y devuelve el estado del perfil. Llamar hasta que «pending» sea 0.

GET /api/v1/profiles/{profile}/sections/{section}

Datos de una sección, con sus fuentes, fecha y nivel de IA.

Respuesta

{"profile":"bernard-arnault-1949","section":"sanctions","status":"ready","data":{…},"sources":[…]}

POST /api/v1/profiles/{profile}/refresh

Vuelve a investigar secciones en el nivel de IA elegido, dentro del plan. Coste estimado en créditos en la respuesta.

Cuerpo (JSON)

{"sections":["wealth","adverse"],"power":"standard"}

Respuesta

{"profile":"bernard-arnault-1949","queued":2,"power":"standard","estimated_credits":12}

Errores

{"error": {"code": "credits_exhausted", "message": "Not enough AI credits left this month."}}

401 unauthorized · 402 quota_exhausted / credits_exhausted · 403 section_not_in_plan · 404 not_found · 409 not_opened · 422 invalid_query / invalid_token / criteria_needed · 429 rate_limited · 502 source_error