linkedin/
search-jobs

Cerca le offerte di lavoro pubbliche di LinkedIn per località e filtri facoltativi del provider, con campi normalizzati su ruolo, azienda, luogo, tipo di impiego, esperienza, lavoro da remoto, stipendio e tempistiche.

LinkedIn Search Jobs API

Località obbligatoria
Ricerca strutturata
Record di offerte canonici
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 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

ParametriObbligatorioDescrizione
locationObbligatorioStringa obbligatoria e non vuota con la località, usata per costruire l’interrogazione di ricerca del provider.
keywordFacoltativoStringa facoltativa e non vuota con un ruolo, una competenza o un argomento, inoltrata al provider.
countryFacoltativoStringa facoltativa e non vuota con il filtro per paese, inoltrata senza traduzione da parte di SocQ.
time_rangeFacoltativoStringa facoltativa e non vuota con un intervallo di tempo o di recenza specifico del provider.
job_typeFacoltativoStringa facoltativa e non vuota con un filtro sul tipo di impiego o di lavoro specifico del provider.
experience_levelFacoltativoStringa facoltativa e non vuota con un filtro sull’esperienza o sulla seniority specifico del provider.
remoteFacoltativoStringa facoltativa e non vuota con un filtro sul luogo di lavoro o sul lavoro da remoto specifico del provider.
companyFacoltativoStringa facoltativa e non vuota con il filtro per azienda, inoltrata al provider.
selective_searchFacoltativoBooleano facoltativo inoltrato al provider per controllare il comportamento della sua ricerca selettiva.
jobs_to_not_includeFacoltativoElenco facoltativo di stringhe di esclusione non vuote, inoltrate al provider.
location_radiusFacoltativoStringa facoltativa e non vuota con un raggio specifico del provider, associato all’interrogazione per località.
results_limitFacoltativoLimite 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.

  1. Scegli una località obbligatoria e aggiungi solo valori di filtro del provider di cui hai verificato l’interpretazione.
  2. Invia con POST l’interrogazione a /v1/linkedin/search-jobs e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività raggiunge uno stato finale.
  4. 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 true

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

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.

Esplora altre piattaforme

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

LinkedIn Search Jobs API — FAQ

LinkedIn Search Jobs API è un’interfaccia programmatica per trovare le offerte di lavoro pubbliche di LinkedIn a partire da una località obbligatoria e da filtri facoltativi del provider. Restituisce campi normalizzati su ruolo, azienda, località, impiego, esperienza, lavoro da remoto, stipendio e tempistiche per le offerte disponibili al momento della raccolta.

location è obbligatorio e deve contenere una stringa non vuota. Indicare solo una parola chiave, un’azienda o un altro filtro facoltativo non soddisfa la validazione attuale.

No. SocQ inoltra al provider di ricerca le stringhe di filtro non vuote, senza definire né tradurre le grafie e le combinazioni accettate.

No. È un limite intero da 1 a 2000, con valore predefinito 100. Disponibilità pubblica, combinazioni di filtri, paginazione, duplicati e comportamento del provider possono produrre meno record.

No. Ogni risultato è un record pubblico rilevato al momento della raccolta. Verifica sull’annuncio stato della candidatura, responsabilità, vincoli di località e retribuzione prima di agire.

No. L’endpoint non invia candidature, non salva offerte, non crea avvisi, non recupera i candidati, non accede a Recruiter e non fornisce punteggi di corrispondenza personalizzati.

Ogni record di offerta restituito costa 0,5 crediti SocQ, senza costo di base. La stima predefinita è di 100 risultati, i set di risultati vuoti non hanno costi per risultato e l’utilizzo effettivo può superare la stima, quando consentito.