linkedin/
company-jobs

Scopri le offerte di lavoro pubbliche di LinkedIn da URL /jobs/ preparati, con campi normalizzati di ruolo, azienda, sede, contratto, esperienza, lavoro da remoto, retribuzione e tempi.

LinkedIn Company Jobs API

Input con pagina delle offerte
Limite per URL
Record canonici delle offerte
0,5 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 Company Jobs

Gli annunci di lavoro aziendali su LinkedIn sono offerte pubbliche con titolo, azienda, sede, tipo di contratto, livello di esperienza, stato del lavoro da remoto, retribuzione e informazioni temporali. Questi campi supportano il monitoraggio degli annunci, il confronto tra ruoli, la ricerca sulle assunzioni e le directory strutturate di offerte di lavoro.

Funzionalità della LinkedIn Company Jobs API

  • Scoperta dalle pagine delle offerteInvia uno o più URL LinkedIn pubblici il cui percorso inizia con /jobs/ e raccogli le offerte proposte da ogni pagina preparata.
  • Limite per inputImposta results_limit da 1 a 2.000; il tetto scelto si applica in modo indipendente a ogni URL della richiesta.
  • Record canonici delle offerteRicevi campi stabili di offerta, azienda, sede, retribuzione, pubblicazione, scadenza e raccolta, invece di strutture annidate specifiche della fonte.
  • Fedeltà alla fonte con campi nullableMantiene i campi null quando un’offerta non espone pubblicamente valori come retribuzione, lavoro da remoto, livello di esperienza o sede esatta.

Parametri della LinkedIn Company Jobs API

ParametriObbligatorioDescrizione
urlsObbligatorioElenco obbligatorio di URL LinkedIn pubblici http o https. Ogni host deve essere linkedin.com o un sottodominio di LinkedIn e ogni percorso deve iniziare con /jobs/.
results_limitFacoltativoTetto intero facoltativo dei risultati, applicato a ogni URL di input. Il valore predefinito è 100, il minimo è 1 e il massimo è 2.000.

Come usare la LinkedIn Company Jobs API

Invia gli URL preparati delle pagine delle offerte, interroga l’attività asincrona ed elabora ogni pagina di risultati restituita.

  1. Prepara URL LinkedIn pubblici il cui percorso inizia con /jobs/ e conserva gli eventuali parametri di query utili.
  2. Invia con POST urls e results_limit a /v1/linkedin/company-jobs, poi salva task_id.
  3. Interroga /v1/tasks/{task_id} finché l’attività raggiunge uno stato finale.
  4. In caso di successo, elabora data.results.items e segui next_cursor ogni volta che has_more è true.
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 true

Casi d’uso della LinkedIn Company Jobs API

  • Monitoraggio di datori di lavoro selezionati: Torna sugli URL preparati delle offerte di lavoro legate alle aziende e confronta le offerte pubbliche restituite in momenti di raccolta diversi.
  • Arricchimento di un catalogo di ruoli: Aggiungi campi normalizzati di azienda, sede, contratto, esperienza, lavoro da remoto, retribuzione e date a un catalogo pubblico di offerte di lavoro.
  • Ricerca sulle pagine di assunzione: Confronta la varietà di ruoli restituita da pagine di offerte selezionate, conservando ogni URL di origine e ogni timestamp di raccolta.
  • Acquisizione nei flussi di lavoro: Invia i record delle offerte pubbliche individuate a flussi di revisione, deduplicazione, avviso o analisi a valle.

Consigli degli esperti per la LinkedIn Company Jobs API

  • Mantieni nei URL preparati i parametri di query significativi, perché possono influire su quali offerte espone la pagina.
  • Deduplica per id stabile dell’offerta o per URL dell’annuncio quando pagine di offerte sovrapposte restituiscono la stessa posizione.
  • Considera un risultato vuoto per un URL come un esito della raccolta, non come la prova che un datore di lavoro non abbia posizioni aperte.
  • Usa la ricerca strutturata delle offerte quando ti servono controlli espliciti per parola chiave o sede, invece degli URL di pagine preparate.
  • Tieni distinti published_at, expires_at e collected_at, così l’orario dell’annuncio non viene confuso con quello del recupero.

Oltre alla LinkedIn Company 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 Jobs API — Normalizza titoli delle offerte pubbliche, aziende, descrizioni, sedi, qualifiche, dettagli del contratto, link per candidarsi e campi sulla retribuzione, se disponibili.
  • 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 Company Jobs API — FAQ

LinkedIn Company Jobs API è un’interfaccia programmatica per scoprire le offerte di lavoro pubbliche da URL LinkedIn /jobs/ preparati. Restituisce campi normalizzati di ruolo, azienda, sede, contratto, esperienza, lavoro da remoto, retribuzione e tempi per le offerte proposte al momento della raccolta.

Ogni valore deve essere un URL http o https completo su linkedin.com o su un sottodominio di LinkedIn, con un percorso che inizia con /jobs/. I normali URL di profili /company/ non superano la validazione.

Il limite intero si applica separatamente a ogni URL. Per esempio, un limite di 20 consente fino a 20 offerte restituite per ogni pagina di offerte inviata.

No. Una raccolta vuota significa solo che per quell’URL, in quel momento, non è stata restituita nessuna offerta pubblica supportata.

No. L’endpoint restituisce dati pubblici delle offerte e non permette di candidarsi ai ruoli, contattare chi recluta o accedere ad analisi di selezione private.

Ogni record di offerta restituito costa 0,5 crediti SocQ, senza costo base. Un insieme di risultati vuoto non ha alcun costo per i risultati e l’utilizzo effettivo può superare la stima quando consentito.