Skip to content

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_icp

Übergib deinen API-Schlüssel als Bearer-Token im Authorization-Header. Schlüssel folgen dem Format hw_XXXXXXXXXXX.

Der Body wird als application/json gesendet. domains oder list_id sowie mandatory sind Pflicht.

ParameterTypBeschreibung
domainsstring[]Zu prüfende Firmen, bis zu 10.000.
list_idstringAlternativ: Firmen aus einer gespeicherten Liste.
mandatorystring[]Kriterien, die erfüllt sein müssen, z. B. ["konstruiert eigene Maschinen", "verkauft an Industriekunden"].
reject_ifstring[]Kriterien, die zum Ausschluss führen, z. B. ["reiner Händler", "Personalvermittlung"].
nice_to_havestring[]Kriterien, die den Score erhöhen, aber nicht zwingend sind.
icp_textstringAlternativ 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_liststringSpeichert 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
]
}
}
Terminal window
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"
}
'
{
"task_id": "tsk_7f3a91",
"status": "queued",
"total": 1840
}
FeldTypBeschreibung
task_idstringID des Tasks für Task-Status abrufen.
statusstringqueued, running, completed, failed oder cancelled.
totalintegerAnzahl der zu prüfenden Firmen.
results[].fitbooleanErfüllt alle mandatory und kein reject_if.
results[].scoreintegerICP-Score (0-100), inklusive nice_to_have.
results[].confidencestringHigh, Medium oder Low. Low heißt: knapp an der Grenze, manuell prüfen.
results[].reasoningstringBegründung in einem Satz.
results[].matchedobjectWelche 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.