Skip to content

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_companies

Ü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
seed_domainsstring[]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_textstringBeschreibung 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_promptstringEin 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_matchstring[]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_domainsstring[]Bis zu 10 Domains, von denen sich das Ergebnis wegbewegen soll. Ideal, um bekannte Fehltreffer auszusteuern, ohne sie hart auszuschließen.
negate_icp_textstringBeschreibung dessen, was du nicht willst, z. B. “Personalvermittlungen und Jobbörsen”.
negate_phrase_matchstring[]Firmen ausschließen, auf deren Website diese Begriffe stehen.
countrystring[]Länder des Firmensitzes als vollständige englische Namen ("Germany", "Austria", "Switzerland") oder der Alias "DACH". Standard: ["Germany"].
statestring[]Bundesländer oder Kantone, z. B. "Nordrhein-Westfalen", "Bayern", "Zürich". Funktioniert nur zusammen mit genau einem Land in country.
nearobjectUmkreissuche um einen Ort: {"city": "Köln", "radius_km": 50} oder {"lat": 50.94, "lon": 6.96, "radius_km": 30}. Maximal 500 km.
industryenumstring[]Branchen-Buckets wie bei der Firmensuche, z. B. "Manufacturing", "Computer Software".
sub_industrystring[]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_rangestringMitarbeiterzahl 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_rangestringJahresumsatz in Euro als "min,max", z. B. "1000000,20000000". Firmen ohne bekannten Umsatz bleiben enthalten, außer du setzt exclude_unknown_revenue: true.
founded_afterstringNur Firmen, die nach diesem Datum gegründet wurden (YYYY-MM-DD). Ideal für Neugründungen, z. B. "2026-01-01".
founded_beforestringNur Firmen, die vor diesem Datum gegründet wurden (YYYY-MM-DD).
legal_formstring[]Rechtsform laut Handelsregister, z. B. "GmbH", "UG", "AG", "GmbH & Co. KG".
tech_stackstring[]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_stackstring[]Firmen ausschließen, die diese Tools einsetzen, z. B. deinen Wettbewerber.
business_modelenumstring[]Geschäftsmodell. Verfügbare Optionen: B2B, B2C, B2G, D2C.
languagestring[]Sprache der Website als ISO-Code, z. B. "de", "en".
min_footprintintegerMindest-Footprint-Score (0-800). Misst, wie präsent eine Firma online ist. Standard: 25. Höher setzen, um Kleinst- und Briefkastenfirmen auszublenden.
exclude_domainsstring[]Diese Domains hart ausschließen, z. B. deine Bestandskunden. Bis zu 1.000 Werte.
exclude_list_idstringAlle Firmen einer gespeicherten Liste ausschließen, z. B. dein CRM oder bereits kontaktierte Firmen.
relevanceenumstringWie 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_similarityintegerMindest-Ähnlichkeit (0-99). Treffer darunter werden verworfen.
limitintegerAnzahl der Ergebnisse pro Seite (Standard: 100, max.: 1.000).
cursorstringCursor aus next_cursor der vorherigen Antwort, um die nächste Seite zu laden.
save_as_liststringSpeichert das Ergebnis direkt als Liste unter diesem Namen. Die list_id steht in der Antwort.
Terminal window
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
}
'
{
"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"
}
}
}
FeldTypBeschreibung
results.resultsarrayGefundene Firmen, sortiert nach Ähnlichkeit.
results.results[].domainstringWebsite-Domain der Firma, der eindeutige Schlüssel für alle weiteren Calls.
results.results[].namestringFirmenname.
results.results[].similarityintegerÄhnlichkeit zur Suche (0-100).
results.results[].descriptionstringKurzbeschreibung, was die Firma macht, abgeleitet aus der Website.
results.results[].industrystringBranchen-Bucket.
results.results[].sub_industryobjectSub-Branchen mit Konfidenz (0-1). {} heißt: geprüft, nichts passt.
results.results[].employeesstringMitarbeiterzahl-Spanne.
results.results[].revenue_rangestringUmsatzspanne in Euro.
results.results[].foundedstringGründungsdatum.
results.results[].legal_formstringRechtsform.
results.results[].addressobjectStadt, Bundesland und Land des Firmensitzes.
results.results[].tech_stackstring[]Auf der Website erkannte Tools (Anbieter-Domains).
results.results[].footprint_scoreintegerOnline-Präsenz der Firma (0-800).
results.results[].linkedin_urlstringLinkedIn-Unternehmensseite, sofern vorhanden.
results.returnedintegerAnzahl der Firmen in dieser Antwort.
results.market_sizeintegerGeschätzte Gesamtzahl passender Firmen bei der gewählten relevance.
results.next_cursorstringCursor für die nächste Seite. null, wenn der Markt ausgeschöpft ist.
results.list_idstringID der gespeicherten Liste, wenn save_as_list gesetzt war.
applied_filtersobjectDie tatsächlich angewendeten Filter, inklusive der aus icp_prompt abgeleiteten.
statusstringStatus der Anfrage, z. B. “ok”.
metadata.fair_useobjectVerbleibendes 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.