ICP prüfen (validate_icp)
Discovery liefert ähnliche Firmen. validate_icp beantwortet die härtere Frage: Passt diese Firma wirklich?
Du formulierst deine Kriterien in drei Blöcken: was zwingend ist (mandatory), was ein Ausschluss ist (reject_if) und was ein Plus ist (nice_to_have). HiWalter liest die Website jeder Firma und urteilt pro Firma einzeln.
Dieser Endpunkt arbeitet asynchron: Du bekommst sofort eine task_id zurück und fragst das Ergebnis mit Task-Status abrufen ab, am besten alle 5 Sekunden. Zwischenergebnisse stehen schon während der Verarbeitung in partial_results.
Nutze diesen Endpunkt, um:
- eine Discovery-Liste vor dem Kontakte-Ziehen zu bereinigen
- Grenzfälle am Ende einer
MAX_COVERAGE-Liste auszusortieren - eine bestehende CRM-Liste gegen einen neuen ICP zu bewerten
Fair-Use-Richtlinie: Dieser Endpunkt unterliegt unserer Fair-Use-Richtlinie für die Suche.
POST https://api.hiwalter.de/api/v1/tools/validate_icpAuthentifizierung
Section titled “Authentifizierung”Übergib deinen API-Schlüssel als Bearer-Token im Authorization-Header. Schlüssel folgen dem Format hw_XXXXXXXXXXX.
Anfrage
Section titled “Anfrage”Der Body wird als application/json gesendet. domains oder list_id sowie mandatory sind Pflicht.
| Parameter | Typ | Beschreibung |
|---|---|---|
domains | string[] | Zu prüfende Firmen, bis zu 10.000. |
list_id | string | Alternativ: Firmen aus einer gespeicherten Liste. |
mandatory | string[] | Kriterien, die erfüllt sein müssen, z. B. ["konstruiert eigene Maschinen", "verkauft an Industriekunden"]. |
reject_if | string[] | Kriterien, die zum Ausschluss führen, z. B. ["reiner Händler", "Personalvermittlung"]. |
nice_to_have | string[] | Kriterien, die den Score erhöhen, aber nicht zwingend sind. |
icp_text | string | Alternativ zu den drei Blöcken: eine ICP-Beschreibung, aus der HiWalter die Kriterien selbst ableitet. Die abgeleiteten Blöcke stehen in criteria der Antwort. |
save_fits_as_list | string | Speichert alle Firmen mit fit: true als neue Liste. |
Nach Abschluss liefert Task-Status abrufen pro Firma:
{ "domain": "mueller-maschinenbau.de", "fit": true, "score": 86, "confidence": "High", "reasoning": "Konstruiert Sondermaschinen für Verpackungsanlagen und verkauft an Lebensmittelhersteller, exportiert nach Österreich und Polen.", "matched": { "mandatory": [ true, true ], "reject_if": [ false, false ], "nice_to_have": [ true ] }}Beispiel
Section titled “Beispiel”curl --request POST \ --url https://api.hiwalter.de/api/v1/tools/validate_icp \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "list_id": "lst_maschinenbau_nrw", "mandatory": [ "konstruiert und fertigt eigene Maschinen", "verkauft an Industriekunden" ], "reject_if": [ "reiner Händler oder Ersatzteilshop", "Personalvermittlung" ], "nice_to_have": [ "exportiert ins Ausland" ], "save_fits_as_list": "Maschinenbau NRW geprüft"}'Antwort
Section titled “Antwort”{ "task_id": "tsk_7f3a91", "status": "queued", "total": 1840}| Feld | Typ | Beschreibung |
|---|---|---|
task_id | string | ID des Tasks für Task-Status abrufen. |
status | string | queued, running, completed, failed oder cancelled. |
total | integer | Anzahl der zu prüfenden Firmen. |
results[].fit | boolean | Erfüllt alle mandatory und kein reject_if. |
results[].score | integer | ICP-Score (0-100), inklusive nice_to_have. |
results[].confidence | string | High, Medium oder Low. Low heißt: knapp an der Grenze, manuell prüfen. |
results[].reasoning | string | Begründung in einem Satz. |
results[].matched | object | Welche Kriterien erfüllt sind, in derselben Reihenfolge wie in der Anfrage. |
- Formuliere Kriterien so, dass man sie auf der Website erkennen kann. “Hat Budget” lässt sich nicht prüfen, “bietet Wartungsverträge an” schon.
- Prüfe erst 50 Firmen, schau dir die
reasoning-Spalte an und schärfe dann die Kriterien nach.