Modificat la: 16 Aug, 2026

Acest ghid oferă documentație pentru integrarea cu Jooble REST API. Mai jos veți găsi informații despre generarea cheii API, endpoint-uri, parametrii de solicitare, formatele JSON și codurile de răspuns comune. Dacă nu ați inițiat încă integrarea, vă rugăm să consultați ghidul nostru pas cu pas despre Cum să vă conectați la Jooble REST API după primirea cheii.

Restricții regionale importante:
Fiecare domeniu Jooble (țară) necesită o cheie REST API unică. De exemplu, o cheie generată pe jooble.org oferă acces exclusiv la ofertele de muncă din SUA. Pentru a căuta locuri de muncă pentru alte țări, înregistrați-vă și obțineți o cheie API pe domeniul regional corespunzător (de exemplu, uk.jooble.org/api/about pentru Regatul Unit sau de.jooble.org/api/about pentru Germania).

Limite de utilizare a API-ului:
Planul gratuit REST API include o limită totală pe viață de 500 de solicitări per cheie (aceasta este o cotă absolută pe viață, nu o limită lunară).

Cum să obțineți o cheie Jooble REST API

1. Înregistrați un cont pe portalul API Jooble pentru țara țintă (de exemplu, ro.jooble.org/api/about).
2. După înregistrare, copiați și păstrați în siguranță cheia API generată.

Parametrii de solicitare (corp JSON)

Corpul solicitării (payload-ul) trebuie trimis în format application/json cu următorii parametri:

• keywords(string, obligatoriu): Cuvinte-cheie sau titluri ale posturilor de căutat.
• location(string, obligatoriu): Numele locației (oraș, regiune sau țară).
• radius(string, opțional): Raza de căutare în kilometri. Valori permise: 0, 4, 8, 16, 26, 40, 80.
• salary(integer, opțional): Pragul minim de salariu.
• page(integer, opțional): Numărul paginii pentru rezultatele căutării (implicit este 1).
• ResultOnPage(integer, opțional): Numărul de locuri de muncă returnate pe pagină.
• SearchMode(integer, opțional): Modul algoritmului de căutare (implicit este 0).
• companysearch(boolean, opțional):
  • true – Căutați cuvintele-cheie în mod specific în numele companiilor.
  • false – Căutați cuvintele-cheie în titlurile posturilor și în descrieri.

Parametrii de răspuns

În cazul unei solicitări de succes, serverul returnează un obiect JSON care conține:

• totalCount(integer): Numărul total de locuri de muncă potrivite găsite.
• jobs(array): Lista de obiecte de locuri de muncă care conțin:
  • id(integer): Identificatorul unic al anunțului de angajare.
  • title(string): Titlul postului.
  • location(string): Locația locului de muncă.
  • snippet(string): Un scurt fragment de descriere afișat în rezultatele căutării.
  • salary(string): Intervalul salarial formatat ca {min} - {max} {currency}.
  • source(string): Sursa publicării locului de muncă.
  • type(string): Tipul de angajare (de exemplu, Full-time, Part-time).
  • link(string): URL-ul direct către anunțul de angajare pe Jooble.
  • company(string): Numele companiei.
  • updated(string): Marcajul temporal ISO al ultimei actualizări a locului de muncă.

Exemple de solicitări și răspunsuri JSON

Exemplu de corp al solicitării (payload):

Exemplu de răspuns de succes (200 OK):

Răspunsuri HTTP și coduri de eroare

• 200 OK: Solicitarea a fost finalizată cu succes și a returnat date.
• 403 Access Denied: Cheia API este nevalidă sau lipsește.
• 404 Not Found: Endpoint-ul sau resursa solicitată nu există.

Exemple de implementare a codului

Puteți integra Jooble REST API utilizând limbaje de programare precum PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby și altele. Snippet-urile de cod gata de utilizat și ghidurile de implementare sunt de asemenea disponibile pe Pagina de documentație Jooble API.