LinkedIn Jobs
Un’offerta di lavoro pubblica su LinkedIn descrive una posizione aperta specifica attraverso ruolo, datore di lavoro, descrizione, sede, livello di seniority, tipo di contratto, settore, modalità di candidatura ed eventuale retribuzione pubblicata. Questi dettagli supportano il monitoraggio delle posizioni, il confronto tra ruoli, la ricerca sul reclutamento e i cataloghi strutturati di offerte di lavoro.
Funzionalità della LinkedIn Jobs API
- Input con URL di dettaglio dell’offertaElabora una o più pagine LinkedIn pubbliche /jobs/view/{slug}, rifiutando i risultati di ricerca e gli URL di raccolte di offerte.
- Ruolo e datore di lavoro in un solo recordRestituisce insieme titolo dell’offerta, descrizione completa, URL dell’annuncio e identità pubblica normalizzata dell’azienda che assume.
- Attributi strutturati del rapporto di lavoroEspone sede, livello di seniority, tipo di contratto e settori come campi separati, invece di lasciarli nella descrizione.
- Campi di candidatura e retribuzioneRestituisce apply_link, il segnale Easy Apply, la retribuzione, l’orario di pubblicazione e quello di raccolta come campi separati dell’offerta.
Parametri della LinkedIn Jobs API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di URL di dettaglio pubblici delle offerte LinkedIn. Ogni URL deve usare il percorso /jobs/view/{slug} su linkedin.com o su un sottodominio di LinkedIn. |
Come usare la LinkedIn Jobs API
Invia link noti di dettaglio delle offerte, attendi che i record delle assunzioni siano pronti e recupera ogni pagina di risultati disponibile.
- Filtra l’elenco di input lasciando solo i link pubblici di dettaglio /jobs/view/{slug}.
- Invia con POST quei link in urls a /v1/linkedin/jobs e salva task_id.
- Interroga /v1/tasks/{task_id} finché l’attività sulle offerte raggiunge uno stato finale.
- In caso di successo, elabora data.results.items e usa next_cursor per ogni pagina segnalata da has_more.
curl -X POST "https://api.socq.ai/v1/linkedin/jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/jobs/view/software-engineer-at-microsoft-4429527118"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della LinkedIn Jobs API
- Monitoraggio delle posizioni aperte: Usa ruolo, datore di lavoro, sede, orario di pubblicazione e URL di origine per mantenere un elenco strutturato delle posizioni aperte note.
- Confronto tra ruoli e requisiti: Confronta descrizioni, seniority, tipo di contratto, settore, sede e retribuzione disponibile tra le offerte selezionate.
- Ricerche di mercato sul reclutamento: Raggruppa le posizioni selezionate per datore di lavoro, sede, settore o tipo di contratto per studiare i modelli di assunzione visibili.
- Gestione dei percorsi di candidatura: Usa apply_link e il segnale Easy Apply per indirizzare ogni offerta salvata verso il percorso di candidatura disponibile.
Consigli degli esperti per la LinkedIn Jobs API
- Estrai e deduplica l’identificatore dell’offerta dai link /jobs/view/, così le forme alternative degli URL non creano offerte ripetute.
- Considera la retribuzione come un dato facoltativo della fonte, perché molte offerte la omettono e i valori esposti possono non avere un formato comune.
- Verifica apply_link prima di presentarlo come azione verso l’esterno in un’interfaccia a valle.
- Tieni distinti created_at e collected_at, così l’orario di pubblicazione non viene confuso con quello in cui l’offerta è stata recuperata.
API correlate
Oltre alla LinkedIn Jobs API, usa queste API quando ti serve un altro tipo di dati pubblici di LinkedIn.
- LinkedIn Profiles API — Normalizza identità del profilo pubblico, ruoli, località, conteggi visibili del pubblico, esperienze, formazione e competenze a partire dagli URL dei profili.
- LinkedIn Companies API — Normalizza descrizioni pubbliche delle aziende, siti web, logo, conteggi visibili di pubblico e dipendenti, settori, sedi e specializzazioni.
- LinkedIn Posts API — Raccoglie testo dei post pubblici, autori, engagement visibile, media, data di pubblicazione, tipo e hashtag dagli URL supportati.
- LinkedIn Company Jobs API — Individua le offerte di lavoro pubbliche dagli URL /jobs/ di LinkedIn preparati, con campi normalizzati di ruolo, azienda, sede, contratto, esperienza, lavoro da remoto, retribuzione e tempistiche.
- LinkedIn Company Posts API — Individua i post pubblici dagli URL delle pagine aziendali di LinkedIn con testo, contesto dell’autore, media, hashtag, date ed engagement visibile.
- LinkedIn Search Jobs API — Cerca offerte di lavoro pubbliche su LinkedIn a partire da una località obbligatoria e filtri facoltativi, restituendo campi normalizzati di ruolo, azienda, luogo, contratto, esperienza, lavoro da remoto, retribuzione e tempistiche.