Změněno dne: 16 Aug, 2026

Tento průvodce přináší dokumentaci pro integraci s Jooble REST API. Najdete zde informace o generování klíčů API, koncových bodech, parametrech požadavků, formátech JSON a běžných kódech odpovědí. Pokud jste integraci ještě nezahájili, podívejte se na našeho podrobného průvodce Jak se připojit k Jooble REST API.

Důležitá regionální omezení:
Každá doména Jooble (země) vyžaduje vlastní jedinečný klíč k REST API. Například klíč vygenerovaný na jooble.org poskytuje přístup výhradně k pracovním nabídkám v USA. Chcete-li vyhledávat pracovní nabídky pro jiné země, zaregistrujte se a získejte klíč API na příslušné regionální doméně (např. uk.jooble.org/api/about pro Spojené království nebo de.jooble.org/api/about pro Německo).
Limity použití API:
Bezplatný tarif REST API obsahuje celkový celoživotní limit 500 požadavků na jeden klíč (jde o absolutní celoživotní kvótu, nikoli o měsíční limit).

Jak získat klíč k Jooble REST API

  1. Zaregistrujte si účet na portálu Jooble API pro cílovou zemi (např. cz.jooble.org/api/about).
  2. Po registraci si vygenerovaný klíč API zkopírujte a bezpečně uložte.

Parametry požadavku (tělo JSON)

Tělo požadavku musí být odesláno ve formátu application/json s následujícími parametry:

  • keywords(string, povinné): Klíčová slova nebo názvy pracovních pozic k vyhledání.
  • location(string, povinné): Název místa (město, region nebo země).
  • radius(string, volitelné): Rádius vyhledávání v kilometrech. Povolené hodnoty: 0, 4, 8, 16, 26, 40, 80.
  • salary(integer, volitelné): Minimální výše platu.
  • page(integer, volitelné): Číslo stránky výsledků vyhledávání (výchozí hodnota je 1).
  • ResultOnPage(integer, volitelné): Počet zobrazených pracovních nabídek na stránce.
  • SearchMode(integer, volitelné): Režim vyhledávacího algoritmu (výchozí hodnota je 0).
  • companysearch(boolean, volitelné):
    • true – Vyhledávat klíčová slova specificky v názvech společností.
    • false – Vyhledávat klíčová slova v názvech pracovních pozic a popisech.

Parametry odpovědi

Po úspěšném požadavku vrátí server objekt JSON obsahující:

  • totalCount(integer): Celkový počet nalezených odpovídajících pracovních nabídek.
  • jobs(array): Seznam objektů pracovních nabídek obsahující:
    • id(integer): Jedinečný identifikátor pracovní nabídky.
    • title(string): Název pracovní pozice.
    • location(string): Místo výkonu práce.
    • snippet(string): Stručný úryvek popisu zobrazený ve výsledcích vyhledávání.
    • salary(string): Rozmezí platu ve formátu {min} - {max} {měna}.
    • source(string): Zdroj pracovní nabídky.
    • type(string): Typ pracovního poměru (např. Plný úvazek, Zkrácený úvazek).
    • link(string): Přímý odkaz na pracovní nabídku na Jooble.
    • company(string): Název společnosti.
    • updated(string): Časové razítko ISO poslední aktualizace pracovní nabídky.

Příklady požadavků a odpovědí v JSON

Příklad těla požadavku:

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

Příklad úspěšné odpovědi (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" } ] }

Kódy odpovědí HTTP a chybové kódy

  • 200 OK: Požadavek byl úspěšný a vrátil data.
  • 403 Access Denied: Neplatný nebo chybějící klíč API.
  • 404 Not Found: Požadovaný koncový bod nebo prostředek neexistuje.

Příklady implementace kódu

Jooble REST API můžete integrovat pomocí programovacích jazyků jako PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby a dalších. Připravené ukázky kódu a návody k implementaci najdete na naší stránce dokumentace k Jooble API.