Izmijenjeno: 16 Aug, 2026

Ovaj vodič pruža dokumentaciju za integraciju s Jooble REST API-jem. U nastavku ćete pronaći informacije o generisanju API ključa, krajnjim tačkama, parametrima zahtjeva, JSON formatima i uobičajenim kodovima odgovora. Ako još niste započeli integraciju, pogledajte naš vodič korak-po-korak na 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č generisan na jooble.org pruža pristup isključivo oglasima za posao u SAD-u. Da biste pretraživali slobodna radna mjesta za druge države, registrujte se i pribavite API ključ na odgovarajućoj regionalnoj domeni (npr. uk.jooble.org/api/about za UK ili de.jooble.org/api/about za Njemačku).
Ograničenja korištenja 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čni limit).

Kako dobiti Jooble REST API ključ

  1. Registrujte račun na Jooble API portalu za vašu ciljnu državu (npr. jooble.org/api/about).
  2. Nakon registracije, kopirajte i sigurno pohranite vaš generisani API ključ.

Parametri zahtjeva (JSON Body)

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

  • keywords(string, obavezno): Ključne riječi ili nazivi poslova koje pretražujete.
  • location(string, obavezno): Naziv lokacije (grad, regija ili država).
  • radius(string, opciono): Radijus pretrage u kilometrima. Dozvoljene vrijednosti: 0, 4, 8, 16, 26, 40, 80.
  • salary(integer, opciono): Minimalni prag plate.
  • page(integer, opciono): Broj stranice rezultata pretrage (podrazumijevano je 1).
  • ResultOnPage(integer, opciono): Broj oglasa za posao koji se vraćaju po stranici.
  • SearchMode(integer, opciono): Režim algoritma pretrage (podrazumijevano je 0).
  • companysearch(boolean, opciono):
    • true – Pretraga ključnih riječi isključivo unutar naziva kompanija.
    • false – Pretraga ključnih riječi u nazivima i opisima poslova.

Parametri odgovora

Nakon uspješnog zahtjeva, server vraća JSON objekat koji sadrži:

  • totalCount(integer): Ukupan broj pronađenih odgovarajućih poslova.
  • jobs(array): Lista objekata poslova koji sadrže:
    • id(integer): Jedinstveni identifikator oglasa za posao.
    • title(string): Naziv posla.
    • location(string): Lokacija posla.
    • snippet(string): Kratak isječak opisa prikazan u rezultatima pretrage.
    • salary(string): Raspon plate formatiran kao {min} - {max} {currency}.
    • source(string): Izvor slobodnog radnog mjesta.
    • type(string): Vrsta zaposlenja (npr. Puno radno vrijeme, Skraćeno radno vrijeme).
    • link(string): Direktni URL do oglasa za posao na Joobleu.
    • company(string): Naziv kompanije.
    • updated(string): ISO vremenska oznaka posljednjeg ažuriranja slobodnog radnog mjesta.

Primjeri JSON zahtjeva i odgovora

Primjer payload-a zahtjeva:

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

Primjer uspješnog odgovora (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" } ] }

HTTP kodovi odgovora i grešaka

  • 200 OK: Zahtjev je bio uspješan i vratio je podatke.
  • 403 Access Denied: Neispravan ili nedostajući API ključ.
  • 404 Not Found: Tražena krajnja tačka ili resurs ne postoji.

Primjeri implementacije koda

Možete integrisati Jooble REST API koristeći programske jezike kao što su PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby i drugi. Gotovi isječci koda i vodiči za implementaciju dostupni su na našoj Jooble API stranici s dokumentacijom.