LinkedIn Search People
LinkedIn Search People macht aus dem Wert keywords in jeder übermittelten URL der Personensuche eine namensorientierte Abfrage beim Anbieter. Die Ergebnisse sind mögliche öffentliche Profile zur Identitätsprüfung und belegen nicht, dass ein Profil zur gemeinten Person gehört; zudem übernimmt der Endpunkt keine in der URL codierten Filter zu Unternehmen, Schule, Standort, Branche oder Kontakten.
Funktionen der LinkedIn Search People API
- URLs der Personensuche als EingabeSenden Sie eine oder mehrere öffentliche LinkedIn-URLs, deren Pfade mit /search/results/people beginnen.
- Ausdrückliche NamenszuordnungDecodiert keywords, ordnet das erste durch Leerraum getrennte Token first_name zu und fügt die übrigen Token als last_name zusammen.
- Entdeckung möglicher ProfileErhalten Sie öffentliche Profil-URLs und Identitätskontext, die den manuellen Abgleich oder eine spätere profilspezifische Erfassung unterstützen können.
- Kanonische KontodatensätzeLiefert stabile Felder zu Identität, Beschreibung, Bild, Website, Kontostatus, Standort, Kennzahlen und Erfassung.
- Treue zur Quelle mit null-WertenLässt nicht verfügbare Felder auf null und vermeidet Rückschlüsse auf private Kontaktdaten, Werdegang, Ausbildung, Skills oder Identitätssicherheit.
Parameter der LinkedIn Search People API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche Liste öffentlicher LinkedIn-URLs mit http oder https. Der Host muss linkedin.com oder eine LinkedIn-Subdomain sein, und der Pfad muss mit /search/results/people beginnen. Geben Sie keywords an, damit sich die namensorientierte Suche zuverlässig verhält. |
So verwenden Sie die LinkedIn Search People API
Bereiten Sie namensorientierte URLs der Personensuche vor, senden Sie die asynchrone Aufgabe ab und prüfen Sie jeden zurückgegebenen Kandidaten.
- Erstellen Sie eine LinkedIn-URL der Personensuche mit einem Abfragewert keywords, der den Namen der Person enthält.
- Senden Sie urls per POST an /v1/linkedin/search-people und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe einen Endstatus erreicht.
- Verarbeiten Sie nach einem Erfolg data.results.items und folgen Sie next_cursor, sobald has_more true ist.
curl -X POST "https://api.socq.ai/v1/linkedin/search-people" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/search/results/people/?keywords=Aakash%20Gupta"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der LinkedIn Search People API
- Entdeckung von Profil-URLs: Finden Sie mögliche öffentliche LinkedIn-Profil-URLs, bevor Sie einen Endpunkt für die profilspezifische Erfassung verwenden.
- Manuelle Identitätsklärung: Vergleichen Sie Namen, Beschreibungen, Standorte, Bilder und URLs mehrerer Kandidaten und behalten Sie die Unsicherheit im Blick.
- Aufnahme in öffentliche Verzeichnisse: Speisen Sie normalisierte Kandidatenkonten in eine Prüfwarteschlange ein, ohne Kontaktanreicherung oder private Attribute zu versprechen.
- Recherche zu Namensvarianten: Führen Sie sorgfältig gewählte Schreibweisen von Namen einzeln aus und vergleichen Sie die öffentlichen Kandidaten, die zum jeweiligen Erfassungszeitpunkt entstehen.
Profi-Tipps zur LinkedIn Search People API
- Geben Sie immer einen aussagekräftigen Wert für keywords an; eine gültige URL ohne ihn erzeugt eine leere Namenszeile, deren Verhalten beim Anbieter nicht zuverlässig ist.
- Beachten Sie, dass Mary Jane Smith auf first_name Mary und last_name Jane Smith abgebildet wird und nicht als allgemeiner Stichwortausdruck behandelt wird.
- Gehen Sie nicht davon aus, dass Filter zu Standort, Unternehmen, Schule, Branche oder Kontakten in der URL berücksichtigt werden; der aktuelle Adapter verwirft sie.
- Nutzen Sie die öffentliche Profil-URL zusammen mit mehreren bestätigenden Merkmalen, bevor Sie eine Person identifizieren.
- Entfernen Sie wiederholte Kandidaten anhand der stabilen Profil-URL, wenn sich mehrere gesendete Suchen überschneiden.
- Es gibt keine vom Aufrufer steuerbare Ergebnisobergrenze; planen Sie Abrechnung und Prüf-Workflows daher anhand der tatsächlich gespeicherten Ergebnisse.
Verwandte APIs
Ergänzend zur LinkedIn Search People API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher LinkedIn-Daten benötigen.
- LinkedIn Profiles API — Öffentliche Profilidentität, Rollen, Ort, sichtbare Zahlen zur Zielgruppe, Berufserfahrung, Ausbildung und Skills aus Profil-URLs normalisieren.
- LinkedIn Companies API — Öffentliche Unternehmensbeschreibungen, Websites, Logos, sichtbare Follower- und Mitarbeiterzahlen, Branchen, Standorte und Spezialgebiete normalisieren.
- LinkedIn Posts API — Öffentliche Beitragstexte, Autoren, sichtbare Interaktionen, Medien, Veröffentlichungszeit, Typ und Hashtags aus unterstützten URLs erfassen.
- LinkedIn Jobs API — Öffentliche Jobtitel, Unternehmen, Beschreibungen, Orte, Qualifikationen, Beschäftigungsdetails, Bewerbungslinks und verfügbare Gehaltsfelder normalisieren.
- LinkedIn Profile Posts API — Öffentliche Beiträge zu LinkedIn-Profil-URLs ermitteln – mit Autorenkontext, Medien, Hashtags, Zeitstempeln und sichtbaren Interaktionen.
- LinkedIn Search Posts API — Von Google indexierte öffentliche LinkedIn-Beiträge per Keyword und optionaler Datumsangabe als Text ermitteln und normalisierte Inhalte, Autoren, Medien, Tags, Zeitstempel und sichtbare Interaktionen zurückgeben.