Izmijenjeno: 11 Nov, 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 ograničenje od 100 zahtjeva dnevno po ključu za određenu državu. Ovo ograničenje se resetuje u ponoć po UTC-u. Ako vam je potreban veći dnevni limit, možete nas kontaktirati kako biste zatražili prilagođeno povećanje limita za svoj ključ.

Kako dobiti Jooble REST API ključ

  1. Registrujte nalog na Jooble API portalu za vašu ciljnu državu (npr. jooble.org/api/about).
  2. Nakon registracije, vaš API ključ će vam biti poslan putem e-pošte. Ako ne možete pronaći poruku e-pošte s vašim ključem, provjerite mapu za neželjenu poštu (spam). Sigurno pohranite svoj API ključ nakon što ga primite.

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 firmi.
    • 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 firme.
    • updated(string): ISO vremenska oznaka posljednjeg ažuriranja slobodnog radnog mjesta.

Primjeri JSON zahtjeva i odgovora

Primjer payload-a zahtjeva:

POST https://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.
  • 429 Too Many Requests: Prekoračen je dnevni limit zahtjeva.

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.