LinkedIn Company Jobs
Stellenanzeigen von Unternehmen auf LinkedIn sind öffentliche Einträge mit Titel, Unternehmen, Standort, Beschäftigungsart, Erfahrungsstufe, Remote-Status, Gehalt und Zeitangaben. Diese Felder unterstützen die Verfolgung von Stellen, den Vergleich von Rollen, Recherche zum Recruiting und strukturierte Stellenverzeichnisse.
Funktionen der LinkedIn Company Jobs API
- Entdeckung über JobseitenSenden Sie eine oder mehrere öffentliche LinkedIn-URLs, deren Pfade mit /jobs/ beginnen, und erfassen Sie die Stellenanzeigen, die auf jeder vorbereiteten Seite erscheinen.
- Limit pro EingabeSetzen Sie results_limit von 1 bis 2000; die gewählte Obergrenze gilt unabhängig für jede URL der Anfrage.
- Kanonische StellendatensätzeSie erhalten stabile Felder zu Stelle, Unternehmen, Standort, Gehalt, Veröffentlichung, Ablauf und Erfassung statt quellenspezifischer Verschachtelung.
- Nullable Felder wie in der QuelleFelder bleiben null, wenn eine Anzeige Werte wie Gehalt, Remote-Status, Erfahrungsstufe oder genauen Standort nicht öffentlich angibt.
Parameter der LinkedIn Company Jobs API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche Liste öffentlicher LinkedIn-URLs mit http oder https. Jeder Host muss linkedin.com oder eine LinkedIn-Subdomain sein, und jeder Pfad muss mit /jobs/ beginnen. |
results_limit | Optional | Optionale Obergrenze als ganze Zahl, die auf jede Eingabe-URL angewendet wird. Der Standardwert ist 100, das Minimum 1 und das Maximum 2000. |
So verwenden Sie die LinkedIn Company Jobs API
Senden Sie vorbereitete URLs von Jobseiten, fragen Sie die asynchrone Aufgabe ab und verarbeiten Sie jede zurückgegebene Ergebnisseite.
- Bereiten Sie öffentliche LinkedIn-URLs vor, deren Pfad mit /jobs/ beginnt, und behalten Sie nützliche Query-Parameter bei.
- Senden Sie urls und results_limit per POST an /v1/linkedin/company-jobs und speichern Sie die task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe einen Endstatus erreicht.
- Verarbeiten Sie bei Erfolg data.results.items und folgen Sie next_cursor, sobald has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/linkedin/company-jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/jobs/microsoft-jobs/"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der LinkedIn Company Jobs API
- Beobachtung ausgewählter Arbeitgeber: Rufen Sie vorbereitete, auf Unternehmen ausgerichtete Jobseiten-URLs erneut ab und vergleichen Sie die öffentlichen Anzeigen, die zu verschiedenen Erfassungszeitpunkten zurückkommen.
- Anreicherung eines Stellenkatalogs: Ergänzen Sie einen öffentlichen Stellenkatalog um normalisierte Felder zu Unternehmen, Standort, Beschäftigungsart, Erfahrung, Remote, Gehalt und Datum.
- Recherche zu Karriereseiten: Vergleichen Sie die zurückgegebene Mischung an Stellen über ausgewählte Jobseiten hinweg und behalten Sie dabei jede Quell-URL und jeden Erfassungszeitstempel.
- Eingang in Workflows: Speisen Sie entdeckte öffentliche Anzeigendatensätze in Workflows für Prüfung, Deduplizierung, Benachrichtigung oder nachgelagerte Analyse ein.
Profi-Tipps zur LinkedIn Company Jobs API
- Behalten Sie aussagekräftige Query-Parameter in den vorbereiteten URLs bei, denn sie können beeinflussen, welche Anzeigen die Seite zeigt.
- Deduplizieren Sie über die stabile Stellen-ID oder die Anzeigen-URL, wenn sich überschneidende Jobseiten dieselbe Stelle zurückgeben.
- Behandeln Sie ein leeres Ergebnis für eine URL als Ergebnis der Erfassung und nicht als Beweis, dass ein Arbeitgeber keine offenen Stellen hat.
- Verwenden Sie die strukturierte Jobsuche, wenn Sie ausdrückliche Steuerung nach Keyword oder Standort brauchen statt vorbereiteter Seiten-URLs.
- Halten Sie published_at, expires_at und collected_at getrennt, damit der Zeitpunkt der Anzeige nicht mit dem Zeitpunkt des Abrufs verwechselt wird.
Verwandte APIs
Ergänzend zur LinkedIn Company Jobs 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 Company Posts API — Öffentliche Beiträge aus URLs von LinkedIn-Unternehmensseiten ermitteln – mit Text, Autorenkontext, Medien, Hashtags, Zeitstempeln und sichtbaren Interaktionen.
- LinkedIn Search Jobs API — Öffentliche LinkedIn-Jobs anhand eines erforderlichen Orts und optionaler Filter suchen und normalisierte Felder zu Rolle, Unternehmen, Ort, Beschäftigung, Erfahrung, Remote, Gehalt und Zeitangaben zurückgeben.