linkedin/
jobs

Recupera le offerte di lavoro pubbliche di LinkedIn dagli URL /jobs/view/{slug}, con contesto normalizzato di ruolo e datore di lavoro, condizioni contrattuali, opzioni di candidatura, retribuzione e timestamp.

LinkedIn Jobs API

Input con URL dell’offerta
Contesto del ruolo
Campi di candidatura
0,8 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlsObbligatorioElenco 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.

  1. Filtra l’elenco di input lasciando solo i link pubblici di dettaglio /jobs/view/{slug}.
  2. Invia con POST quei link in urls a /v1/linkedin/jobs e salva task_id.
  3. Interroga /v1/tasks/{task_id} finché l’attività sulle offerte raggiunge uno stato finale.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

Combina i dati di LinkedIn con i dati pubblici delle altre piattaforme social supportate.

LinkedIn Jobs API — FAQ

LinkedIn Jobs API recupera dati pubblici delle offerte di lavoro da uno o più URL /jobs/view/{slug} accettati. Restituisce ruolo, datore di lavoro, descrizione, sede, seniority, tipo di contratto, settori, campi di candidatura, retribuzione disponibile e timestamp.

No. Ogni input deve essere un URL LinkedIn http o https completo di una singola pagina di dettaglio /jobs/view/{slug}; i percorsi di ricerca e di raccolte non superano la validazione.

No. Questo prodotto risolve solo gli URL pubblici di dettaglio delle offerte forniti in urls e non effettua una ricerca di offerte su LinkedIn.

Un record di offerta può includere un apply_link esterno e un segnale is_easy_apply quando l’offerta pubblica li espone. L’endpoint restituisce le informazioni di candidatura ma non invia candidature.

L’offerta pubblica può non indicare una retribuzione, un link di candidatura esterno o il segnale Easy Apply, quindi questi campi facoltativi possono essere null o vuoti.

I record di offerta restituiti sono fatturati a 0,8 crediti SocQ ciascuno. Non viene applicato alcun costo per i risultati quando l’attività produce un insieme di risultati vuoto.