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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco 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_limit | Facoltativo | Tetto 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.
- Prepara URL LinkedIn pubblici il cui percorso inizia con /jobs/ e conserva gli eventuali parametri di query utili.
- Invia con POST urls e results_limit a /v1/linkedin/company-jobs, poi salva task_id.
- Interroga /v1/tasks/{task_id} finché l’attività raggiunge uno stato finale.
- 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 trueCasi 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.
API correlate
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.