API v1

NameCheck360-API

Personen- und Firmensuche, Profile, Sanktionen und Abschnitte als JSON, mit denselben Regeln wie die Website.

Authentifizierung

Erstellen Sie einen Schlüssel unter Konto > API-Schlüssel (Tarife Business und Enterprise) und senden Sie ihn im Header Authorization (oder X-Api-Key).

curl -H "Authorization: Bearer nc360_xxxxxxxx_…" https://namecheck360.com/api/v1/usage
  • Das Öffnen eines neuen Profils zählt eine Abfrage des Monats, wie auf der Website; erneutes Lesen im selben Monat ist kostenlos.
  • KI-Recherchen werden von den monatlichen KI-Credits der Organisation abgezogen.
  • Limit: 120 Anfragen pro Minute und Schlüssel.
  • Jeder Aufruf wird im Aktivitätsprotokoll der Organisation erfasst.
  • Der vertrauliche Modus ist über die API nicht verfügbar.

Typischer Ablauf

  1. GET /search: die richtige Person oder Firma unter den Kandidaten finden (kostenlos).
  2. POST /profiles mit dem „token“ des Kandidaten: Das Profil wird geöffnet und seine Recherchen eingereiht.
  3. POST /profiles/{profile}/work wiederholen, bis „pending“: 0 (jeder Aufruf führt einen Schritt aus, 10 bis 60 s).
  4. GET /profiles/{profile}/sections/{section}, um jeden Abschnitt zu lesen (sanctions, pep, adverse, wealth…).

GET /api/v1/usage

Abfragen, Wiederaufrufe und KI-Credits des Monats.

Antwort

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

Kandidaten aus den kostenlosen Quellen (Wikidata, Register, GLEIF, Sanktionslisten). Optionale Filter: country, year, city, company. Keine Abfrage angerechnet.

Antwort

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

Öffnet das Profil eines Kandidaten („token“) oder erstellt es ohne Kandidat aus Kriterien: name + mindestens zwei von year, country, role, context.

Body (JSON)

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

Antwort

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

GET /api/v1/profiles/{profile}

Profilübersicht und Status jedes Abschnitts. Zählt beim ersten Mal im Monat eine Abfrage.

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

Führt den nächsten Rechercheschritt aus und gibt den Profilstatus zurück. Aufrufen, bis „pending“ 0 ist.

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

Daten eines Abschnitts mit Quellen, Datum und KI-Stufe.

Antwort

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

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

Recherchiert Abschnitte erneut auf der gewählten KI-Stufe im Rahmen des Tarifs. Geschätzte Kosten in Credits in der Antwort.

Body (JSON)

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

Antwort

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

Fehler

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