Firmen zählen (count_companies)
count_companies nimmt exakt dieselben Parameter wie Firmen entdecken, liefert aber nur die Anzahl der passenden Firmen. So testest du Filterkombinationen, ohne Datensätze abzurufen.
Der Call ist kostenlos und zählt nicht gegen dein Fair-Use-Kontingent.
Nutze diesen Endpunkt, um:
- die Größe deines adressierbaren Marktes in DACH zu bestimmen
- Filter schrittweise zu verfeinern, bis die Menge passt
- große Märkte in Teilmengen aufzuteilen (z. B. nach Bundesland)
Kostenlos: Dieser Endpunkt zählt nicht gegen dein Fair-Use-Kontingent.
POST https://api.hiwalter.de/api/v1/tools/count_companiesAuthentifizierung
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 Firmen entdecken außer limit, cursor und save_as_list. |
Beispiel
Section titled “Beispiel”curl --request POST \ --url https://api.hiwalter.de/api/v1/tools/count_companies \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "icp_text": "Steuerberatungskanzleien mit Schwerpunkt auf digitaler Buchhaltung", "country": [ "Germany" ], "employee_range": "11,200"}'Antwort
Section titled “Antwort”{ "results": { "count": 3127, "by_country": { "Germany": 3127 } }, "applied_filters": { "country": [ "Germany" ], "employee_range": "11,200" }, "status": "ok"}| Feld | Typ | Beschreibung |
|---|---|---|
results.count | integer | Anzahl passender Firmen. |
results.by_country | object | Aufschlüsselung nach Land. |
applied_filters | object | Die tatsächlich angewendeten Filter. |
status | string | Status der Anfrage. |