Измењено на: 16 Aug, 2026

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

Važna regionalna ograničenja:
Svaki Jooble domen (država) zahteva sopstveni jedinstveni REST API ključ. Na primer, ključ generisan na jooble.org omogućava pristup isključivo oglasima za posao u SAD. Da biste pretraživali oglase za posao u drugim zemljama, registrujte se i pribavite API ključ na odgovarajućem regionalnom domenu (npr. uk.jooble.org/api/about za UK ili de.jooble.org/api/about za Nemačku).
Ograničenja korišćenja API-ja:
Besplatni plan za REST API uključuje ukupan doživotni limit od 500 zahteva po ključu (ovo je apsolutna doživotna kvota, a ne mesečni limit)

Kako dobiti Jooble REST API ključ

  1. Registrujte nalog na Jooble API portalu za željenu zemlju (npr., rs.jooble.org/api/about)
  2. Nakon registracije, kopirajte i bezbedno sačuvajte generisani API ključ

Parametri zahteva (JSON telo)

Telo zahteva mora biti poslato u formatu application/json sa sledećim parametrima:

  • keywords(string, obavezno): ključne reči ili nazivi radnih mesta za pretragu
  • location(string, obavezno): naziv lokacije (grad, region ili država)
  • radius(string, opciono): poluprečnik pretrage u kilometrima. Dozvoljene vrednosti: 0, 4, 8, 16, 26, 40, 80.
  • salary(integer, opciono): minimalni prag plate
  • page(integer, opciono): broj stranice rezultata pretrage (podrazumevana vrednost je 1)
  • ResultOnPage(integer, opciono): broj oglasa za posao koji se vraćaju po stranici
  • SearchMode(integer, opciono): režim algoritma pretrage (podrazumevana vrednost je 0)
  • companysearch(boolean, opciono):
    • true – pretraga ključnih reči isključivo unutar naziva kompanija
    • false – pretraga ključnih reči u nazivima radnih mesta i opisima poslova

Parametri odgovora

Nakon uspešnog zahteva, server vraća JSON objekat koji sadrži:

  • totalCount(integer): ukupan broj pronađenih odgovarajućih oglasa za posao
  • jobs(array): lista objekata oglasa za posao koji sadrže:
    • id(integer): jedinstveni identifikator oglasa za posao
    • title(string): naziv radnog mesta
    • location(string): lokacija oglasa za posao
    • snippet(string): kratak isečak opisa prikazan u rezultatima pretrage
    • salary(string): raspon plate formatiran kao {min} - {max} {valuta}
    • source(string): izvor oglasa za posao
    • type(string): vrsta zaposlenja (npr. Puno radno vreme, Nepuno radno vreme)
    • link(string): direktan URL do oglasa za posao na sajtu Jooble
    • company(string): naziv kompanije
    • updated(string): ISO vremenska oznaka poslednjeg ažuriranja oglasa za posao

Primeri JSON zahteva i odgovora

Primer tela zahteva:

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

Primer uspeš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: Zahtev je bio uspešan i vratio je podatke
  • 403 Access Denied: Nevažeći ili nedostajući API ključ
  • 404 Not Found: Zahtevana krajnja tačka ili resurs ne postoji

Primeri 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 isečci koda i vodiči za implementaciju dostupni su na našoj stranici sa Jooble API dokumentacijom.