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
- GET /search: die richtige Person oder Firma unter den Kandidaten finden (kostenlos).
- POST /profiles mit dem „token“ des Kandidaten: Das Profil wird geöffnet und seine Recherchen eingereiht.
- POST /profiles/{profile}/work wiederholen, bis „pending“: 0 (jeder Aufruf führt einen Schritt aus, 10 bis 60 s).
- 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