LinkedIn-Profil suchen

Die LinkedIn-Profil-Such-API findet das LinkedIn-Profil einer Person oder eines Unternehmens aus einem Namen und einer Firmendomain.

Übergib einen vollständigen Namen (Hi Walter zerlegt ihn automatisch in Vor- und Nachname) oder sende first_name und last_name getrennt, und ergänze das Unternehmen als Domain, zum Beispiel acme.com. URLs werden automatisch normalisiert, du musst deine Eingaben also nicht vorher bereinigen.

Führe zuerst eine kostenlose Zählung mit count_only: true durch, um zu sehen, wie viele Treffer existieren, und verfeinere oder erweitere dann deine Suche, bevor du Tokens ausgibst. Vollständige Ergebnisse werden nur berechnet, wenn tatsächlich ein Treffer gefunden wird, eine leere Suche kostet also nichts.

Nutze diesen Endpunkt, um:

• vor dem Anreichern eines Kontakts das richtige LinkedIn-Profil zu bestätigen
• die Trefferanzahl vor einer Massensuche zu prüfen
• LinkedIn-URLs an Kontaktdatensätze anzuhängen, denen eine fehlt

Fair-Use-Richtlinie: Diese API unterliegt unserer Fair-Use-Richtlinie für die Suche.

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

Anfrage

Feld	Typ	Beschreibung
name	string	Vollständiger Name (z. B. ‘John Smith’), wird automatisch in Vor- und Nachname zerlegt.
first_name	string	Vorname (wird verwendet, wenn name nicht angegeben ist).
last_name	string	Nachname (wird verwendet, wenn name nicht angegeben ist).
company	string	Firmendomain (z. B. ‘acme.com’) oder URL (z. B. ‘https://acme.com’), wird auf die Domain normalisiert.
company_domain	string	Alias für company, Firmendomain oder URL.
count_only	boolean	Standard: false. Kostenlos, gibt die Anzahl der passenden Ergebnisse zurück, ohne Daten abzurufen oder Tokens zu berechnen. Nutze dies zuerst, um das Treffervolumen abzuschätzen, bevor du eine vollständige Suche startest.

Deinen API-Schlüssel übergibst du als Bearer-Token im Authorization-Header. Schlüssel haben das Format hw_XXXXXXXXXXX.

Beispiel

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

Antwort

{
  "results": {
    "count": 3
  },
  "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	object	Enthält die Ergebnisse der Suche.
results.count	integer	Anzahl der passenden Treffer (bei count_only: true).
status	string	Status der Anfrage, z. B. ok.
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-Fenster 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-Fenster zurückgesetzt wird.