Promijenjeno: 16 Aug, 2026

Ovaj vodič pruža dokumentaciju za integraciju s Jooble REST API-jem. U nastavku ćete pronaći informacije o generiranju API ključa, krajnjim točkama, parametrima zahtjeva, JSON formatima i uobičajenim kodovima odgovora. Ako još niste započeli integraciju, pogledajte naš vodič korak po korak o tome Kako se povezati na Jooble REST API.

Važna regionalna ograničenja:
Svaka Jooble domena (država) zahtijeva vlastiti jedinstveni REST API ključ. Na primjer, ključ generiran na jooble.org omogućuje pristup isključivo oglasima za posao u SAD-u. Za dohvaćanje oglasa za druge zemlje, registrirajte se i pribavite API ključ na odgovarajućoj regionalnoj domeni (npr. hr.jooble.org/api/about za Hrvatsku).
Ograničenja upotrebe API-ja:
Besplatni REST API plan uključuje ukupno doživotno ograničenje od 500 zahtjeva po ključu (ovo je apsolutna doživotna kvota, a ne mjesečno ograničenje).

Kako dobiti Jooble REST API ključ

  1. Registrirajte račun na Jooble API portalu za željenu državu (npr. hr.jooble.org/api/about).
  2. Nakon registracije kopirajte i sigurno pohranite svoj generirani API ključ.

Parametri zahtjeva (JSON tijelo)

Payload zahtjeva mora biti poslan u application/json formatu sa sljedećim parametrima:

  • keywords(string, obavezno): Ključne riječi ili nazivi radnih mjesta za pretraživanje.
  • location(string, obavezno): Naziv lokacije (grad, regija ili država).
  • radius(string, neobavezno): Radijus pretraživanja u kilometrima. Dopuštene vrijednosti: 0, 4, 8, 16, 26, 40, 80.
  • salary(integer, neobavezno): Prag minimalne plaće.
  • page(integer, neobavezno): Broj stranice rezultata pretraživanja (zadano je 1).
  • ResultOnPage(integer, neobavezno): Broj rezultata po stranici.
  • SearchMode(integer, neobavezno): Način algoritma pretraživanja (zadano je 0).
  • companysearch(boolean, neobavezno):
    • true – Pretraživanje ključnih riječi isključivo unutar naziva tvrtki.
    • false – Pretraživanje ključnih riječi u nazivima oglasa i opisima poslova.

Parametri odgovora

Nakon uspješnog zahtjeva, poslužitelj vraća JSON objekt koji sadrži:

  • totalCount(integer): Ukupan broj pronađenih odgovarajućih oglasa.
  • jobs(array): Popis objekata poslova koji sadrži:
    • id(integer): Jedinstveni identifikator oglasa za posao.
    • title(string): Naziv radnog mjesta.
    • location(string): Lokacija radnog mjesta.
    • snippet(string): Kratki isječak opisa prikazan u rezultatima pretraživanja.
    • salary(string): Raspon plaće formatiran kao {min} - {max} {valuta}.
    • source(string): Izvor objave oglasa.
    • type(string): Vrsta zaposlenja (npr. puno radno vrijeme, nepuno radno vrijeme).
    • link(string): Izravni URL do oglasa za posao na Joobleu.
    • company(string): Naziv tvrtke.
    • updated(string): ISO vremenska oznaka posljednjeg ažuriranja oglasa.

Primjeri JSON zahtjeva i odgovora

Primjer payload-a zahtjeva:

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

Primjer uspješnog odgovora (200 OK):

{ "totalCount": 1, "jobs": [ { "id": 1234567890, "title": "Sales Manager", "location": "Zagreb", "snippet": "Ovo je sjajna prilika da se pridružite našem timu...", "salary": "1.500 EUR", "source": "jooble", "type": "puno radno vrijeme", "link": "https://hr.jooble.org/jdp/12345", "company": "ABC Corp", "updated": "2023-09-15T12:55:35.3870000" } ] }

HTTP odgovori i kodovi pogrešaka

  • 200 OK: Zahtjev je bio uspješan i podaci su vraćeni.
  • 403 Access Denied: Nevažeći ili nedostajući API ključ.
  • 404 Not Found: Tražena krajnja točka ili resurs ne postoji.

Primjeri implementacije koda

Možete integrirati Jooble REST API koristeći programske jezike kao što su PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby i druge. Primjere koda spremne za upotrebu i vodiče za implementaciju možete pronaći na našoj stranici s dokumentacijom Jooble API-ja.