Firmen entdecken (discover_companies)
Mit discover_companies findest du nicht einzelne Firmen, sondern deinen Markt. Statt starrer Filter beschreibst du, wen du suchst, und HiWalter liefert die passendsten Firmen sortiert nach Ähnlichkeit.
Du kannst drei Suchwege kombinieren:
- Lookalike: Gib bis zu 10 Domains deiner besten Kunden an (
seed_domains), HiWalter findet Firmen, die ihnen ähneln. - Beschreibung: Beschreibe deinen ICP in normaler Sprache (
icp_text). HiWalter matcht semantisch gegen den Inhalt jeder Website. - Begriffe: Finde Firmen, auf deren Website bestimmte Begriffe stehen (
phrase_match), z. B. “ISO 9001” oder “Sondermaschinenbau”.
Alle Filter (Region, Größe, Gründungsdatum, Tech-Stack, Rechtsform) werden mit dem Suchvektor UND-verknüpft. Mit relevance steuerst du, wie weit die Liste in den Markt hineinreicht, bevor die Passung zu schwach wird.
Unsicher, wie groß dein Markt ist? Prüfe die Menge vorher kostenlos mit Firmen zählen.
Nutze diesen Endpunkt, um:
- aus 3-5 Bestandskunden eine Liste ähnlicher Zielfirmen zu bauen
- einen Markt zu kartieren, den kein Branchencode sauber abbildet (“Agenturen, die Outbound für Kunden machen”)
- Firmen über Signale auf der Website zu finden (Tools, Zertifikate, Leistungen)
- Neugründungen in einer Region und Branche zu finden
Fair-Use-Richtlinie: Dieser Endpunkt unterliegt unserer Fair-Use-Richtlinie für die Suche.
POST https://api.hiwalter.de/api/v1/tools/discover_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 |
|---|---|---|
seed_domains | string[] | Bis zu 10 Domains als Vorbild für die Lookalike-Suche, z. B. deine besten Kunden. Die Seed-Domains selbst sind nicht im Ergebnis, außer du setzt include_seeds: true. |
icp_text | string | Beschreibung deines ICP in normaler Sprache (3-4000 Zeichen). Beschreibe, was die Firma tut, nicht welche Filter gelten, z. B. “Mittelständische Maschinenbauer, die Sondermaschinen für die Lebensmittel- und Verpackungsindustrie konstruieren”. |
icp_prompt | string | Ein Satz, aus dem HiWalter alles selbst ableitet: Filter (Region, Größe, Branche), einen bereinigten icp_text und passende Seed-Domains. Die abgeleiteten Werte stehen in applied_filters der Antwort. Überschreibt icp_text. |
phrase_match | string[] | Exakte Begriffe, die auf der Website vorkommen müssen. Bis zu 20 Begriffe mit je mindestens 3 Zeichen. Mehrere Begriffe sind ODER-verknüpft. |
negate_domains | string[] | Bis zu 10 Domains, von denen sich das Ergebnis wegbewegen soll. Ideal, um bekannte Fehltreffer auszusteuern, ohne sie hart auszuschließen. |
negate_icp_text | string | Beschreibung dessen, was du nicht willst, z. B. “Personalvermittlungen und Jobbörsen”. |
negate_phrase_match | string[] | Firmen ausschließen, auf deren Website diese Begriffe stehen. |
country | string[] | Länder des Firmensitzes als vollständige englische Namen ("Germany", "Austria", "Switzerland") oder der Alias "DACH". Standard: ["Germany"]. |
state | string[] | Bundesländer oder Kantone, z. B. "Nordrhein-Westfalen", "Bayern", "Zürich". Funktioniert nur zusammen mit genau einem Land in country. |
near | object | Umkreissuche um einen Ort: {"city": "Köln", "radius_km": 50} oder {"lat": 50.94, "lon": 6.96, "radius_km": 30}. Maximal 500 km. |
industry | enumstring[] | Branchen-Buckets wie bei der Firmensuche, z. B. "Manufacturing", "Computer Software". |
sub_industry | string[] | Feinere Sub-Branche, z. B. "MANUFACTURING/INDUSTRIAL_MACHINERY", "ADVERTISING_AND_MARKETING/LEAD_GENERATION". Die vollständige Liste liefert GET /api/v1/reference/sub_industries. |
employee_range | string | Mitarbeiterzahl als "min,max", z. B. "11,200". Wird auf die Spannen 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001+ abgebildet. |
revenue_range | string | Jahresumsatz in Euro als "min,max", z. B. "1000000,20000000". Firmen ohne bekannten Umsatz bleiben enthalten, außer du setzt exclude_unknown_revenue: true. |
founded_after | string | Nur Firmen, die nach diesem Datum gegründet wurden (YYYY-MM-DD). Ideal für Neugründungen, z. B. "2026-01-01". |
founded_before | string | Nur Firmen, die vor diesem Datum gegründet wurden (YYYY-MM-DD). |
legal_form | string[] | Rechtsform laut Handelsregister, z. B. "GmbH", "UG", "AG", "GmbH & Co. KG". |
tech_stack | string[] | Nur Firmen, deren Website diese Tools einsetzt. Angabe als Anbieter-Domain, z. B. "hubspot.com", "shopify.com", "personio.de". Bis zu 50 Werte. |
negate_tech_stack | string[] | Firmen ausschließen, die diese Tools einsetzen, z. B. deinen Wettbewerber. |
business_model | enumstring[] | Geschäftsmodell. Verfügbare Optionen: B2B, B2C, B2G, D2C. |
language | string[] | Sprache der Website als ISO-Code, z. B. "de", "en". |
min_footprint | integer | Mindest-Footprint-Score (0-800). Misst, wie präsent eine Firma online ist. Standard: 25. Höher setzen, um Kleinst- und Briefkastenfirmen auszublenden. |
exclude_domains | string[] | Diese Domains hart ausschließen, z. B. deine Bestandskunden. Bis zu 1.000 Werte. |
exclude_list_id | string | Alle Firmen einer gespeicherten Liste ausschließen, z. B. dein CRM oder bereits kontaktierte Firmen. |
relevance | enumstring | Wie tief die Liste in den Markt reicht. MAX_RELEVANCE: kurze, sehr enge Liste. BALANCED (Standard): guter Mittelweg. MAX_COVERAGE: kartiert den ganzen Markt, mit mehr Grenzfällen am Ende. Gilt für Lookalike- und icp_text-Suchen. |
min_similarity | integer | Mindest-Ähnlichkeit (0-99). Treffer darunter werden verworfen. |
limit | integer | Anzahl der Ergebnisse pro Seite (Standard: 100, max.: 1.000). |
cursor | string | Cursor aus next_cursor der vorherigen Antwort, um die nächste Seite zu laden. |
save_as_list | string | Speichert das Ergebnis direkt als Liste unter diesem Namen. Die list_id steht in der Antwort. |
Beispiel
Section titled “Beispiel”curl --request POST \ --url https://api.hiwalter.de/api/v1/tools/discover_companies \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "seed_domains": [ "kunde-eins.de", "kunde-zwei.de", "kunde-drei.de" ], "icp_text": "Mittelständische Maschinenbauer, die Sondermaschinen für die Lebensmittel- und Verpackungsindustrie konstruieren", "country": [ "Germany" ], "state": [ "Nordrhein-Westfalen" ], "employee_range": "51,500", "exclude_list_id": "lst_crm_bestandskunden", "relevance": "BALANCED", "limit": 100}'Antwort
Section titled “Antwort”{ "results": { "results": [ { "domain": "mueller-maschinenbau.de", "name": "Müller Maschinenbau GmbH", "similarity": 91, "description": "Sondermaschinenbau für die Verpackungsindustrie, Konstruktion und Fertigung in Nordrhein-Westfalen.", "industry": "Manufacturing", "sub_industry": { "MANUFACTURING/INDUSTRIAL_MACHINERY": 0.93 }, "employees": "51-200", "revenue_range": "€10M - €20M", "founded": "1998-04-01", "legal_form": "GmbH", "address": { "city": "Bielefeld", "state": "Nordrhein-Westfalen", "country": "Germany" }, "tech_stack": [ "hubspot.com", "personio.de" ], "footprint_score": 412, "linkedin_url": "https://linkedin.com/company/mueller-maschinenbau", "_score": 0.91 } ], "returned": 100, "market_size": 1840, "next_cursor": "eyJvIjoxMDB9", "list_id": null }, "applied_filters": { "country": [ "Germany" ], "state": [ "Nordrhein-Westfalen" ], "employee_range": "51,500" }, "status": "ok", "metadata": { "fair_use": { "records_remaining_5h": 179999, "records_reset_5h": "2026-11-02T18:53:16Z", "records_remaining_1w": 899999, "records_reset_1w": "2026-11-09T13:53:16Z" } }}| Feld | Typ | Beschreibung |
|---|---|---|
results.results | array | Gefundene Firmen, sortiert nach Ähnlichkeit. |
results.results[].domain | string | Website-Domain der Firma, der eindeutige Schlüssel für alle weiteren Calls. |
results.results[].name | string | Firmenname. |
results.results[].similarity | integer | Ähnlichkeit zur Suche (0-100). |
results.results[].description | string | Kurzbeschreibung, was die Firma macht, abgeleitet aus der Website. |
results.results[].industry | string | Branchen-Bucket. |
results.results[].sub_industry | object | Sub-Branchen mit Konfidenz (0-1). {} heißt: geprüft, nichts passt. |
results.results[].employees | string | Mitarbeiterzahl-Spanne. |
results.results[].revenue_range | string | Umsatzspanne in Euro. |
results.results[].founded | string | Gründungsdatum. |
results.results[].legal_form | string | Rechtsform. |
results.results[].address | object | Stadt, Bundesland und Land des Firmensitzes. |
results.results[].tech_stack | string[] | Auf der Website erkannte Tools (Anbieter-Domains). |
results.results[].footprint_score | integer | Online-Präsenz der Firma (0-800). |
results.results[].linkedin_url | string | LinkedIn-Unternehmensseite, sofern vorhanden. |
results.returned | integer | Anzahl der Firmen in dieser Antwort. |
results.market_size | integer | Geschätzte Gesamtzahl passender Firmen bei der gewählten relevance. |
results.next_cursor | string | Cursor für die nächste Seite. null, wenn der Markt ausgeschöpft ist. |
results.list_id | string | ID der gespeicherten Liste, wenn save_as_list gesetzt war. |
applied_filters | object | Die tatsächlich angewendeten Filter, inklusive der aus icp_prompt abgeleiteten. |
status | string | Status der Anfrage, z. B. “ok”. |
metadata.fair_use | object | Verbleibendes Kontingent im 5-Stunden- und 1-Wochen-Fenster. |
- Starte mit 3-5 Seed-Domains plus
icp_text. Die Kombination ist präziser als jeder Weg allein. - Beschreibe in
icp_text, was die Firma tut, nicht welche Größe oder Region sie hat. Dafür sind die Filter da. - Fehltreffer im Ergebnis? Leg sie in
negate_domains, die nächste Suche driftet von ihnen weg. - Nach dem ersten Lauf: Segmentieren und ICP prüfen, bevor du Kontakte ziehst.