LinkedIn Search Jobs
LinkedIn Search Jobs costruisce un’unica interrogazione pubblica a partire da una località obbligatoria e da filtri facoltativi. Restituisce record di offerte rilevati al momento della raccolta, utili per la ricerca e per l’avvio di flussi di lavoro; un’offerta restituita non dimostra che le candidature siano ancora aperte, e il numero di risultati non misura direttamente le assunzioni o l’organico.
Funzionalità della LinkedIn Search Jobs API
- Ricerca guidata dalla localitàParti sempre da una località non vuota e, se vuoi, restringi il campione di offerte pubbliche con una parola chiave, un paese, un’azienda o un altro filtro del provider.
- Filtri flessibili della fonteInoltra i valori di time_range, job_type, experience_level, remote, company, location_radius, selective_search e di esclusione, senza inventare enum di SocQ.
- Limite di risultati configurabileImposta results_limit da 1 a 2000 per la singola interrogazione di ricerca; il valore predefinito è 100 e il provider può restituire meno record.
- Record di offerte canoniciRicevi campi stabili per offerta, azienda, località, stipendio, pubblicazione, scadenza e raccolta, invece di strutture annidate specifiche del provider.
- Fedeltà alla fonte con valori nulliMantieni null i valori non disponibili di stipendio, lavoro da remoto, azienda, esperienza, località, pubblicazione e scadenza, senza dedurli.
Parametri della LinkedIn Search Jobs API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
location | Obbligatorio | Stringa obbligatoria e non vuota con la località, usata per costruire l’interrogazione di ricerca del provider. |
keyword | Facoltativo | Stringa facoltativa e non vuota con un ruolo, una competenza o un argomento, inoltrata al provider. |
country | Facoltativo | Stringa facoltativa e non vuota con il filtro per paese, inoltrata senza traduzione da parte di SocQ. |
time_range | Facoltativo | Stringa facoltativa e non vuota con un intervallo di tempo o di recenza specifico del provider. |
job_type | Facoltativo | Stringa facoltativa e non vuota con un filtro sul tipo di impiego o di lavoro specifico del provider. |
experience_level | Facoltativo | Stringa facoltativa e non vuota con un filtro sull’esperienza o sulla seniority specifico del provider. |
remote | Facoltativo | Stringa facoltativa e non vuota con un filtro sul luogo di lavoro o sul lavoro da remoto specifico del provider. |
company | Facoltativo | Stringa facoltativa e non vuota con il filtro per azienda, inoltrata al provider. |
selective_search | Facoltativo | Booleano facoltativo inoltrato al provider per controllare il comportamento della sua ricerca selettiva. |
jobs_to_not_include | Facoltativo | Elenco facoltativo di stringhe di esclusione non vuote, inoltrate al provider. |
location_radius | Facoltativo | Stringa facoltativa e non vuota con un raggio specifico del provider, associato all’interrogazione per località. |
results_limit | Facoltativo | Limite intero facoltativo per questa interrogazione. Il valore predefinito è 100, il minimo è 1 e il massimo è 2000. |
Come usare la LinkedIn Search Jobs API
Invia una sola interrogazione basata sulla località, interroga lo stato dell’attività asincrona ed elabora ogni pagina di risultati restituita.
- Scegli una località obbligatoria e aggiungi solo valori di filtro del provider di cui hai verificato l’interpretazione.
- Invia con POST l’interrogazione a /v1/linkedin/search-jobs e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività raggiunge uno stato finale.
- Dopo il successo elabora data.results.items e segui next_cursor ogni volta che has_more è true.
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 trueCasi d’uso della LinkedIn Search Jobs API
- Ricerca di ruoli per area geografica: Raccogli le offerte pubbliche per un’interrogazione coerente di ruolo e località e conserva l’ora di raccolta per i confronti successivi.
- Analisi di aziende e ruoli: Esamina quali aziende, titoli, luoghi, modalità di lavoro, livelli di esperienza e tipi di impiego compaiono nel campione restituito.
- Disponibilità delle informazioni retributive: Individua le offerte che indicano lo stipendio, mantenendo la retribuzione mancante come null esplicito.
- Avvio di flussi di lavoro sulle offerte: Invia URL e campi normalizzati delle offerte pubbliche a flussi di revisione, deduplicazione, avvisi o analisi a valle.
Consigli degli esperti per la LinkedIn Search Jobs API
- Prova le grafie dei filtri specifici del provider con una piccola interrogazione prima di usarle in un flusso di lavoro ricorrente.
- Usa gli stessi filtri e la stessa pianificazione di raccolta quando confronti località o date.
- Deduplica per id stabile dell’offerta o per URL dell’annuncio, perché ricerche rinnovate o sovrapposte possono mostrare la stessa posizione.
- Considera le etichette del lavoro da remoto come segnali della fonte e leggi la descrizione per vincoli geografici, di residenza o di fuso orario.
- Tieni distinti published_at, expires_at e collected_at, così la data dell’annuncio non si confonde con quella del recupero.
- Considera un risultato vuoto come un esito della raccolta, non come prova che non esistano offerte pubbliche corrispondenti.
API correlate
Oltre alla LinkedIn Search 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 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.