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
- GET /search: encuentre la persona o empresa correcta entre los candidatos (gratis).
- POST /profiles con el «token» del candidato: el perfil se abre y sus búsquedas se ponen en cola.
- POST /profiles/{profile}/work, repetido hasta «pending»: 0 (cada llamada ejecuta un paso, 10 a 60 s).
- 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