LinkedIn Search Jobs
LinkedIn Search Jobs baut aus einem erforderlichen Standort und optionalen Filtern eine einzelne öffentliche Suchabfrage auf. Die Suche liefert Datensätze zu Stellenanzeigen zum Zeitpunkt der Erfassung für Recherche und Workflow-Eingang; eine zurückgegebene Anzeige belegt nicht, dass Bewerbungen noch möglich sind, und die Zahl der Ergebnisse misst weder Einstellungen noch Personalstärke.
Funktionen der LinkedIn Search Jobs API
- Standortbasierte EntdeckungBeginnen Sie jede Abfrage mit einem nicht leeren Standort und grenzen Sie die Stichprobe öffentlicher Anzeigen optional mit einem Keyword, Land, Unternehmen oder anderen Anbieterfilter ein.
- Flexible QuellfilterLeitet time_range, job_type, experience_level, remote, company, location_radius, selective_search und Ausschlusswerte weiter, ohne eigene SocQ-Enums zu erfinden.
- Konfigurierbare ErgebnisobergrenzeLegen Sie results_limit von 1 bis 2.000 für die einzelne Abfrage fest; der Standardwert ist 100, und der Anbieter kann weniger Datensätze liefern.
- Kanonische StellendatensätzeErhalten Sie stabile Felder zu Stelle, Unternehmen, Standort, Gehalt, Veröffentlichung, Ablauf und Erfassung statt anbieterspezifischer Verschachtelung.
- Treue zur Quelle mit null-WertenNicht verfügbare Werte zu Gehalt, Remote-Arbeit, Unternehmen, Erfahrung, Standort, Veröffentlichung und Ablauf bleiben null, statt abgeleitet zu werden.
Parameter der LinkedIn Search Jobs API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
location | Erforderlich | Erforderliche, nicht leere Standort-Zeichenfolge, aus der die Suchabfrage beim Anbieter aufgebaut wird. |
keyword | Optional | Optionale, nicht leere Zeichenfolge zu Rolle, Skill oder Thema, die an den Anbieter weitergeleitet wird. |
country | Optional | Optionale, nicht leere Länderfilter-Zeichenfolge, die ohne Übersetzung auf SocQ-Seite weitergeleitet wird. |
time_range | Optional | Optionale, nicht leere anbieterspezifische Zeichenfolge für Aktualität oder Zeitraum. |
job_type | Optional | Optionale, nicht leere anbieterspezifische Filterzeichenfolge für Beschäftigungsart oder Stellentyp. |
experience_level | Optional | Optionale, nicht leere anbieterspezifische Filterzeichenfolge für Erfahrung oder Seniorität. |
remote | Optional | Optionale, nicht leere anbieterspezifische Filterzeichenfolge für Arbeitsort oder Remote-Arbeit. |
company | Optional | Optionale, nicht leere Unternehmensfilter-Zeichenfolge, die an den Anbieter weitergeleitet wird. |
selective_search | Optional | Optionaler boolescher Wert, der an den Anbieter weitergeleitet wird, um dessen Verhalten bei der selektiven Suche zu steuern. |
jobs_to_not_include | Optional | Optionale Liste nicht leerer Ausschluss-Zeichenfolgen, die an den Anbieter weitergeleitet wird. |
location_radius | Optional | Optionale, nicht leere anbieterspezifische Radius-Zeichenfolge zur Standortabfrage. |
results_limit | Optional | Optionale ganzzahlige Obergrenze für diese Abfrage. Der Standardwert ist 100, das Minimum 1 und das Maximum 2.000. |
So verwenden Sie die LinkedIn Search Jobs API
Senden Sie eine standortbasierte Abfrage, fragen Sie die asynchrone Aufgabe ab und verarbeiten Sie jede zurückgegebene Ergebnisseite.
- Wählen Sie einen erforderlichen Standort und ergänzen Sie nur Filterwerte des Anbieters, deren Auslegung Sie getestet haben.
- Senden Sie die Abfrage per POST an /v1/linkedin/search-jobs 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-jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"location":"Seattle","keyword":"Python","country":"US","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 Search Jobs API
- Regionale Stellenentdeckung: Erfassen Sie öffentliche Anzeigen für eine gleichbleibende Abfrage aus Rolle und Standort und behalten Sie die Erfassungszeit für spätere Vergleiche.
- Prüfung von Arbeitgebern und Rollen: Prüfen Sie, welche Arbeitgeber, Titel, Orte, Arbeitsmodelle, Erfahrungsstufen und Beschäftigungsarten in der zurückgegebenen Stichprobe vorkommen.
- Verfügbarkeit von Vergütungsangaben: Erkennen Sie Anzeigen, die Gehaltsangaben enthalten, und behalten Sie fehlende Vergütung ausdrücklich als null.
- Eingang in Stellen-Workflows: Speisen Sie normalisierte URLs und Felder öffentlicher Anzeigen in Prüf-, Deduplizierungs-, Benachrichtigungs- oder weiterführende Analyse-Workflows ein.
Profi-Tipps zur LinkedIn Search Jobs API
- Testen Sie anbieterspezifische Schreibweisen von Filtern mit einer kleinen Abfrage, bevor Sie sie in einem wiederkehrenden Workflow verwenden.
- Verwenden Sie dieselben Filter und denselben Erfassungsrhythmus, wenn Sie Standorte oder Zeitpunkte vergleichen.
- Entfernen Sie Duplikate anhand der stabilen Stellen-ID oder der Anzeigen-URL, denn erneuerte und sich überschneidende Suchen können dieselbe Stelle liefern.
- Behandeln Sie Remote-Angaben als Signale der Quelle und lesen Sie die Beschreibung auf geografische, Wohnsitz- oder Zeitzonen-Einschränkungen.
- Halten Sie published_at, expires_at und collected_at getrennt, damit die Zeit der Anzeige nicht mit der Abrufzeit verwechselt wird.
- Betrachten Sie leere Ergebnisse als ein Erfassungsergebnis, nicht als Beleg dafür, dass es keine passenden öffentlichen Stellen gibt.
Verwandte APIs
Ergänzend zur LinkedIn Search 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 Jobs API — Öffentliche Stellenangebote aus vorbereiteten LinkedIn-URLs mit /jobs/ ermitteln – mit normalisierten Feldern zu Rolle, Unternehmen, Ort, Beschäftigung, Erfahrung, Remote, Gehalt und Zeitangaben.
- LinkedIn Company Posts API — Öffentliche Beiträge aus URLs von LinkedIn-Unternehmensseiten ermitteln – mit Text, Autorenkontext, Medien, Hashtags, Zeitstempeln und sichtbaren Interaktionen.