Modificato il: 16 Aug, 2026

Questa guida fornisce la documentazione per l'integrazione con la Jooble REST API. Qui sotto trovi informazioni sulla generazione delle chiavi API, gli endpoint, i parametri di richiesta, i formati JSON e i codici di risposta comuni. Se non hai ancora avviato l'integrazione, vedi la nostra guida passo passo su Come connettersi alla Jooble REST API.

Importanti restrizioni regionali:
Ogni dominio (paese) Jooble richiede una propria chiave REST API univoca. Ad esempio, una chiave generata su jooble.org consente l'accesso esclusivamente alle offerte di lavoro negli Stati Uniti. Per cercare offerte di lavoro in altri paesi, registrati e ottieni una chiave API sul relativo dominio regionale (ad es. uk.jooble.org/api/about per il Regno Unito o de.jooble.org/api/about per la Germania).
Limiti di utilizzo dell'API:
Il piano gratuito della Jooble REST API include un limite totale di 500 richieste per chiave per l'intero ciclo di vita (si tratta di una quota assoluta per tutta la durata della chiave, non di un limite mensile).

Come ottenere una chiave per la Jooble REST API

  1. Registra un account sul portale API di Jooble per il paese di tuo interesse (ad es. it.jooble.org/api/about).
  2. Dopo la registrazione, copia e conserva in modo sicuro la chiave API generata.

Parametri di richiesta (corpo JSON)

Il payload della richiesta deve essere inviato in formato application/json con i seguenti parametri:

  • keywords (stringa, obbligatorio): parole chiave o titoli di lavoro da cercare.
  • location (stringa, obbligatorio): nome della località (città, regione o paese).
  • radius (stringa, opzionale): raggio di ricerca in chilometri. Valori consentiti: 0, 4, 8, 16, 26, 40, 80.
  • salary (intero, opzionale): soglia minima dello stipendio.
  • page (intero, opzionale): numero di pagina dei risultati di ricerca (il valore predefinito è 1).
  • ResultOnPage (intero, opzionale): numero di offerte di lavoro restituite per pagina.
  • SearchMode (intero, opzionale): modalità dell'algoritmo di ricerca (il valore predefinito è 0).
  • companysearch (booleano, opzionale):
    • true – cerca le parole chiave specificamente all'interno dei nomi delle aziende.
    • false – cerca le parole chiave nei titoli e nelle descrizioni delle offerte di lavoro.

Parametri di risposta

In caso di richiesta andata a buon fine, il server restituisce un oggetto JSON contenente:

  • totalCount (intero): numero totale di offerte di lavoro corrispondenti trovate.
  • jobs (array): elenco di oggetti di offerte di lavoro contenenti:
    • id (intero): identificativo univoco dell'annuncio di lavoro.
    • title (stringa): titolo dell'offerta di lavoro.
    • location (stringa): località dell'offerta di lavoro.
    • snippet (stringa): breve frammento di descrizione visualizzato nei risultati di ricerca.
    • salary (stringa): fascia di stipendio formattata come {min} - {max} {valuta}.
    • source (stringa): fonte della pubblicazione dell'offerta di lavoro.
    • type (stringa): tipo di impiego (ad es. Full-time, Part-time).
    • link (stringa): URL diretto all'offerta di lavoro su Jooble.
    • company (stringa): nome dell'azienda.
    • updated (stringa): timestamp ISO dell'ultimo aggiornamento dell'offerta di lavoro.

Esempi di richiesta e risposta JSON

Esempio di payload di richiesta:

POST https://it.jooble.org/api/{api_Key} Content-Type: application/json { "keywords": "Sales Manager, Administrator", "location": "Kyiv", "radius": "80", "page": "1", "companysearch": "false" }

Esempio di risposta corretta (200 OK):

{ "totalCount": 1, "jobs": [ { "id": 1234567890, "title": "Sales Manager", "location": "Kyiv", "snippet": "This is a great opportunity to join our team...", "salary": "17,600 UAH", "source": "jooble", "type": "Full-time", "link": "https://ua.jooble.org/jdp/12345", "company": "ABC Corp", "updated": "2023-09-15T12:55:35.3870000" } ] }

Codici di risposta e di errore HTTP

  • 200 OK: la richiesta è andata a buon fine e ha restituito i dati.
  • 403 Access Denied: chiave API non valida o mancante.
  • 404 Not Found: l'endpoint o la risorsa richiesta non esiste.

Esempi di implementazione del codice

Puoi integrare la Jooble REST API usando linguaggi di programmazione come PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby e altri. Gli snippet di codice pronti all'uso e le guide all'implementazione sono disponibili sulla nostra pagina della documentazione delle API di Jooble.