Business-Profil per Name suchen

Die Business-Profile-Finder-API findet das vollständige Business-Profil einer Person allein aus ihrem Namen und der Firmen-Domain.

Sie führt in einem einzigen Aufruf eine LinkedIn-Profilsuche und eine firmografische Abfrage aus und liefert dir Jobtitel und Firma der Person sowie Firmendetails wie Branche, Größe und Standort zurück. Übergib entweder einen vollständigen Namen oder getrennte Felder first_name und last_name und gib die Firma als Domain an, zum Beispiel acme.com. URLs werden automatisch normalisiert, und Tokens werden nur berechnet, wenn ein Treffer gefunden wird.

Nutze diesen Endpunkt, um:

• ein vollständiges Bild eines Kontakts und seines Arbeitgebers in einem Aufruf aufzubauen
• Leads vor der Ansprache mit Firmenkontext zu qualifizieren
• CRM-Datensätze mit Jobtitel und firmografischen Daten anzureichern

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

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

Anfrage

Übergib deinen API-Schlüssel als Bearer-Token. Schlüssel haben das Format hw_XXXXXXXXXXX.

Der Anfrage-Body wird als application/json gesendet.

Feld	Typ	Beschreibung
name	string	Vollständiger Name (z. B. ‘John Smith’) – wird automatisch in Vor- und Nachname aufgeteilt.
first_name	string	Vorname (wird verwendet, wenn name nicht angegeben ist).
last_name	string	Nachname (wird verwendet, wenn name nicht angegeben ist).
company	string	Firmen-Domain (z. B. ‘acme.com’) oder URL (z. B. ‘https://acme.com’) – wird auf die Domain normalisiert.
company_domain	string	Alias für company – Firmen-Domain oder URL.

Beispiel

curl --request POST \
  --url https://api.hiwalter.de/api/v1/tools/search_business_profile_by_name \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Smith",
  "company": "acme.com"
}
'

Antwort

{
  "results": {
    "full_name": "John Smith",
    "first_name": "John",
    "last_name": "Smith",
    "title": "VP of Engineering",
    "company": "Acme Inc",
    "company_domain": "acme.com",
    "linkedin_url": "https://linkedin.com/in/john-smith-123",
    "firmographics": {
      "industry": "Software",
      "employee_count": "201-500",
      "revenue": "$50M-$100M"
    }
  },
  "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.full_name	string	Vollständiger Name der Person.
results.first_name	string	Vorname.
results.last_name	string	Nachname.
results.title	string	Jobtitel der Person.
results.company	string	Firmenname des Arbeitgebers.
results.company_domain	string	Firmen-Domain.
results.linkedin_url	string	URL des LinkedIn-Profils.
results.firmographics.industry	string	Branche der Firma.
results.firmographics.employee_count	string	Mitarbeiterzahl (Spanne).
results.firmographics.revenue	string	Umsatz (Spanne).
status	string	Status der Anfrage (z. B. ok).
metadata.fair_use	object	Verbleibende Kontingente und Zurücksetzungszeitpunkte der Fair-Use-Fenster (5 Stunden und 1 Woche).