Firmensuche

Mit der Firmensuche durchsuchst du die Firmendatenbank von Hi Walter nach Name, Domain, Branche, Mitarbeiterzahl oder Jahresumsatz, um Zielkunden zu finden und zu qualifizieren.

Nutze query für die Freitextsuche nach dem Firmennamen, domain für eine exakte Suche über die Website-Domain und die Filter (industry, employee_range, revenue_range), um deine Ergebnisse einzugrenzen. Die Kombination aus query und Filtern liefert dir die präzisesten Treffer. Jedes Ergebnis kommt sortiert zurück, wobei ein höherer _score einen stärkeren Treffer bedeutet.

Nutze diesen Endpunkt, um:

Interessentenlisten für Account-based Marketing aufzubauen
Zielkunden vor der Ansprache zu qualifizieren
CRM-Datensätze mit firmografischen Daten anzureichern

Fair-Use-Policy: Dieser Endpunkt unterliegt unserer Fair-Use-Policy für die Suche.

POST https://api.hiwalter.de/api/v1/tools/search_companies

Anfrage

Übergib deinen API-Key als Bearer-Token im Authorization-Header. Keys haben das Format hw_XXXXXXXXXXX.

Der Request-Body wird als application/json gesendet.

Parameter	Typ	Beschreibung
`query`	string	Volltextsuche ausschließlich über den Firmennamen. Setze hier keine Domain, Branche, Mitarbeiterzahl oder Umsatz ein, nutze dafür die dedizierten Filter-Parameter.
`domain`	string	Exakter Filter über die Firmen-Domain. Vollständige URLs werden automatisch normalisiert (`https://www.acme.com/about` wird zu `acme.com`), du musst Protokoll und Pfad also nicht selbst entfernen. Bevorzuge diesen Parameter gegenüber `query`, wenn du die Domain kennst, da es sich um einen exakten Treffer statt einer Textsuche handelt. Beispiel: `"hiwalter.de"`
`industry`	enum`string`	Exakter Branchenfilter. Muss exakt einem der aufgezählten Werte entsprechen. Verfügbare Optionen: `Professional and Business Services`, `Information Technology`, `Manufacturing`, `Retail`, `Health and Pharmaceuticals`, `Creative Arts and Entertainment`, `Construction`, `Marketing & Advertising`, `Finance and Banking`, `Tourism and Hospitality`, `Non-Profit and Social Services`, `Food and Beverage`, `Real Estate`, `Education`, `Transportation and Logistics`, `Media and Publishing`, `Energy`, `Automotive`, `Government and Public Administration`, `Telecommunications`, `Agriculture`, `Utilities`, `Corporate Services`, `Insurance`, `Banks`, `Computer Software`, `Pharmaceuticals and Biotechnology`, `Aerospace and Defense`, `Electronics`, `Mining and Metals`
`employee_range`	enum`string`	Exakter Filter für die Mitarbeiterzahl. Die Werte sind feste Bucket-Bereiche (z. B. `"51-200"`, `"1001-5000"`); die Alt-Werte (`"Small"`, `"Mid-Market"`, `"Enterprise"`, `"Unknown"`) existieren ebenfalls, haben aber deutlich weniger Abdeckung als die numerischen Bereiche. Verfügbare Optionen: `1-10`, `11-20`, `21-50`, `51-200`, `201-500`, `501-1000`, `1001-5000`, `5001+`, `Small`, `Mid-Market`, `Enterprise`, `Unknown`
`revenue_range`	enum`string`	Exakter Filter für den Jahresumsatz. `"$1 - $1M"` ist ein Alt-Format, das `"$500k - $1M"` entspricht, aber deutlich weniger Datensätze hat, bevorzuge für diesen Bereich `"$500k - $1M"`. Verfügbare Optionen: `Below $500k`, `$500k - $1M`, `$1M - $5M`, `$5M - $10M`, `$10M - $20M`, `$20M - $50M`, `Above $50M`, `$50M - $100M`, `$100M - $250M`, `$250M - $500M`, `$500M - $1B`, `$1B - $2.5B`, `$2.5B - $5B`, `Over $5B`, `$1 - $1M`
`naics_code`	string	Exakter Filter über den NAICS-Branchencode (~50 % befüllt). Funktioniert auf jeder Hierarchieebene, vom 2-stelligen Sektor (`"23"` = Bau, `"54"` = Professional Services) bis zur 6-stelligen nationalen Branche (`"541120"` = Notarbüros, `"511210"` = Software-Verlage). Nutze einen kurzen Code für breites Branchen-Targeting und einen längeren Code für Präzision, der standardisierteste verfügbare Branchenfilter. Beispiel: `"541120"`
`linkedin_industry`	string	Exakter Filter über das LinkedIn-Branchenlabel (~50 % befüllt). Verwendet LinkedIns eigenes Branchenvokabular mit ~150 Werten, das feingranularer ist als die Buckets in `industry`. Muss dem gespeicherten Label exakt entsprechen, mit Standard-Großschreibung, zum Beispiel `"Software Development"`, `"Hospitality"`, `"Legal Services"`, `"Staffing and Recruiting"`, `"Wellness and Fitness Services"`. Beispiel: `"Software Development"`
`country`	string	Exakter Filter über den Ländernamen am Standort der Firma. Nutze den vollständigen englischen Ländernamen. Beachte, dass der Firmenstandort daraus abgeleitet wird, wo das Team der Firma sitzt: Das ist genau für die kleinen Firmen, die den Index dominieren, aber große multinationale Konzerne werden einem einzelnen ihrer Büros zugeordnet, kombiniere den Filter mit anderen Filtern, statt dich beim Targeting globaler Firmen allein auf den Standort zu verlassen. Beispiel: `"United States"`
`state`	string	Exakter Filter über den Namen des Bundeslands oder der Region am Standort der Firma. Vollständige Namen mit Standard-Großschreibung (`"Texas"`, nicht `"TX"`). Kombiniere ihn mit `country` für Präzision. Der Standort wird auf dieselbe Weise wie bei `country` aus dem Team abgeleitet und ist daher für kleinere Firmen am genauesten. Beispiel: `"Texas"`
`limit`	integer	Anzahl der zurückzugebenden Ergebnisse (Standard: 10, max.: 25). Zulässiger Bereich: `1 <= x <= 25`
`offset`	integer	Anzahl der zu überspringenden Ergebnisse für die Paginierung (Standard: 0). Nutze ihn zusammen mit `limit`, um durch die Ergebnisse zu blättern, z. B. `offset: 10`, um die zweite Seite mit 10 Ergebnissen zu erhalten.

Beispiel

curl --request POST \
  --url https://api.hiwalter.de/api/v1/tools/search_companies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "Hi Walter",
  "industry": "Information Technology",
  "employee_range": "51-200",
  "limit": 10,
  "offset": 0
}
'

Antwort

{
  "results": {
    "results": [
      {
        "logo": "https://cdn.mixrank.com/md5/0e4e81c8ff584b1ce3e4c3067e8cXXXXX",
        "name": "Hi Walter",
        "type": "Privately Held",
        "domain": "hiwalter.de",
        "industry": "Information Technology",
        "linkedin_url": "https://linkedin.com/company/hiwalter",
        "exact_revenue": 1200000000,
        "revenue_range": "Above $50M",
        "employee_count": 57,
        "employee_range": "51-200",
        "follower_count": 3677,
        "linkedin_company_id": "13223077",
        "_id": "hiwalter.de",
        "_score": 15.2394
      },
      {
        "name": "Acme",
        "type": "Privately Held",
        "domain": "acme.com",
        "industry": "Information Technology",
        "linkedin_url": "https://linkedin.com/company/acme",
        "revenue_range": "$10M - $20M",
        "employee_count": 90,
        "employee_range": "51-200",
        "follower_count": 121,
        "linkedin_company_id": "82353383",
        "_id": "acme.com",
        "_score": 13.1942
      }
    ],
    "total": 210
  },
  "status": "ok",
  "metadata": {
    "fair_use": {
      "records_remaining_5h": 179999,
      "records_reset_5h": "2026-07-15T18:53:16Z",
      "records_remaining_1w": 899999,
      "records_reset_1w": "2026-07-22T13:53:16Z"
    }
  }
}

Feld	Typ	Beschreibung
`results.results`	array	Liste der gefundenen Firmen, sortiert nach `_score`.
`results.results[].logo`	string	URL zum Firmenlogo.
`results.results[].name`	string	Firmenname.
`results.results[].type`	string	Firmentyp (z. B. `"Privately Held"`).
`results.results[].domain`	string	Website-Domain der Firma.
`results.results[].industry`	string	Branche der Firma.
`results.results[].linkedin_url`	string	URL zum LinkedIn-Profil der Firma.
`results.results[].exact_revenue`	integer	Exakter Jahresumsatz, sofern verfügbar.
`results.results[].revenue_range`	string	Umsatzbereich der Firma.
`results.results[].employee_count`	integer	Exakte Mitarbeiterzahl.
`results.results[].employee_range`	string	Bereich der Mitarbeiterzahl.
`results.results[].follower_count`	integer	Anzahl der LinkedIn-Follower.
`results.results[].linkedin_company_id`	string	LinkedIn-Firmen-ID.
`results.results[]._id`	string	Eindeutiger Bezeichner des Datensatzes (die Domain).
`results.results[]._score`	number	Treffer-Score; ein höherer Wert bedeutet einen stärkeren Treffer.
`results.total`	integer	Gesamtzahl der zur Anfrage passenden Firmen.
`status`	string	Status der Anfrage (`"ok"` bei Erfolg).
`metadata.fair_use.records_remaining_5h`	integer	Verbleibende Datensätze im 5-Stunden-Fenster.
`metadata.fair_use.records_reset_5h`	string	Zeitpunkt, zu dem das 5-Stunden-Kontingent zurückgesetzt wird.
`metadata.fair_use.records_remaining_1w`	integer	Verbleibende Datensätze im 1-Wochen-Fenster.
`metadata.fair_use.records_reset_1w`	string	Zeitpunkt, zu dem das 1-Wochen-Kontingent zurückgesetzt wird.