API v1

API NameCheck360

Recherche de personnes et de sociétés, profils, sanctions et sections en JSON, avec les mêmes règles que le site.

Authentification

Créez une clé dans Compte > Clés d’API (offres Business et Enterprise), puis envoyez-la dans l’en-tête Authorization (ou X-Api-Key).

curl -H "Authorization: Bearer nc360_xxxxxxxx_…" https://namecheck360.com/api/v1/usage
  • Ouvrir un nouveau profil compte une consultation du mois, comme sur le site ; le relire le même mois est gratuit.
  • Les recherches IA sont déduites des crédits IA du mois de l’organisation.
  • Limite : 120 requêtes par minute et par clé.
  • Chaque appel est inscrit au journal d’activité de l’organisation.
  • Le mode confidentiel n’est pas disponible par l’API.

Déroulé type

  1. GET /search : trouvez la bonne personne ou société parmi les candidats (gratuit).
  2. POST /profiles avec le « token » du candidat : le profil est ouvert et ses recherches mises en file.
  3. POST /profiles/{profile}/work à répéter jusqu’à « pending »: 0 (chaque appel fait avancer une étape, 10 à 60 s).
  4. GET /profiles/{profile}/sections/{section} pour lire chaque section (sanctions, pep, adverse, wealth…).

GET /api/v1/usage

Consultations, réouvertures et crédits IA du mois.

Réponse

{"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

Candidats issus des sources gratuites (Wikidata, registres, GLEIF, listes de sanctions). Filtres facultatifs : country, year, city, company. Ne compte aucune consultation.

Réponse

{"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

Ouvre le profil d’un candidat (« token ») ou, sans candidat, crée-le à partir de critères : name + au moins deux de year, country, role, context.

Corps (JSON)

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

Réponse

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

GET /api/v1/profiles/{profile}

Résumé du profil et état de chaque section. Compte une consultation la première fois dans le mois.

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

Exécute l’étape de recherche suivante et renvoie l’état du profil. À appeler jusqu’à ce que « pending » vaille 0.

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

Données d’une section, avec ses sources, sa date et son niveau d’IA.

Réponse

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

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

Relance des sections, au niveau d’IA choisi dans la limite de l’offre. Coût estimé en crédits dans la réponse.

Corps (JSON)

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

Réponse

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

Erreurs

{"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