Skip to content

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_people

Ü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. Alle Felder sind optional.

ParameterTypBeschreibung
…Alle Parameter von Entscheider finden außer limit, cursor und save_as_list.
Terminal window
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"
]
}
'
{
"results": {
"total_contacts": 2207,
"total_companies": 1312,
"coverage": 0.71
},
"status": "ok"
}
FeldTypBeschreibung
results.total_contactsintegerPassende Kontakte.
results.total_companiesintegerFirmen mit mindestens einem passenden Kontakt.
results.coveragenumberAnteil der Zielfirmen mit mindestens einem Kontakt (nur bei domains oder list_id).
statusstringStatus der Anfrage.