Entscheider zählen (count_people)
count_people nimmt dieselben Parameter wie Entscheider finden und liefert nur die Anzahl. Der Call ist kostenlos und zählt nicht gegen dein Fair-Use-Kontingent.
Nutze diesen Endpunkt, um:
- abzuschätzen, wie viele Leads eine Kampagne hergibt
- zu prüfen, wie viele Firmen einer Liste überhaupt einen passenden Entscheider haben
Kostenlos: Dieser Endpunkt zählt nicht gegen dein Fair-Use-Kontingent.
POST https://api.hiwalter.de/api/v1/tools/count_peopleAuthentifizierung
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. Alle Felder sind optional.
| Parameter | Typ | Beschreibung |
|---|---|---|
… | Alle Parameter von Entscheider finden außer limit, cursor und save_as_list. |
Beispiel
Section titled “Beispiel”curl --request POST \ --url https://api.hiwalter.de/api/v1/tools/count_people \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "list_id": "lst_maschinenbau_nrw", "seniority": [ "Owner", "C Suite" ], "email_risk": [ "A", "B" ]}'Antwort
Section titled “Antwort”{ "results": { "total_contacts": 2207, "total_companies": 1312, "coverage": 0.71 }, "status": "ok"}| Feld | Typ | Beschreibung |
|---|---|---|
results.total_contacts | integer | Passende Kontakte. |
results.total_companies | integer | Firmen mit mindestens einem passenden Kontakt. |
results.coverage | number | Anteil der Zielfirmen mit mindestens einem Kontakt (nur bei domains oder list_id). |
status | string | Status der Anfrage. |