Змінено: 16 Aug, 2026

Цей посібник містить документацію для інтеграції з Jooble REST API. Нижче ви знайдете інформацію про генерацію ключів API, кінцеві точки, параметри запитів, формати JSON та поширені коди відповідей. Якщо ви ще не розпочали інтеграцію, ознайомтеся з нашою покроковою інструкцією Як підключитися до Jooble REST API.

Важливі регіональні обмеження:
Для кожного домену (країни) Jooble потрібен власний унікальний ключ REST API. Наприклад, ключ, згенерований на jooble.org, надає доступ виключно до вакансій у США. Щоб шукати вакансії в інших країнах, зареєструйтеся та отримайте ключ API на відповідному регіональному домені (наприклад, uk.jooble.org/api/about для Великої Британії або de.jooble.org/api/about для Німеччини).
Ліміти використання API:
Безкоштовний тариф REST API передбачає загальний ліміт у 500 запитів на один ключ за весь час (це абсолютна квота на весь час дії ключа, а не щомісячний ліміт).

Як отримати ключ Jooble REST API

  1. Зареєструйте обліковий запис на API-порталі Jooble для вашої цільової країни (наприклад, ua.jooble.org/api/about).
  2. Після реєстрації скопіюйте та надійно збережіть згенерований ключ API.

Параметри запиту (тіло JSON)

Дані запиту потрібно надсилати у форматі application/json із такими параметрами:

  • keywords(string, обов’язковий): ключові слова або назви посад для пошуку.
  • location(string, обов’язковий): назва розташування (місто, регіон або країна).
  • radius(string, необов’язковий): радіус пошуку в кілометрах. Дозволені значення: 0, 4, 8, 16, 26, 40, 80.
  • salary(integer, необов’язковий): мінімальний поріг зарплати.
  • page(integer, необов’язковий): номер сторінки результатів пошуку (за замовчуванням 1).
  • ResultOnPage(integer, необов’язковий): кількість вакансій на сторінці.
  • SearchMode(integer, необов’язковий): режим алгоритму пошуку (за замовчуванням 0).
  • companysearch(boolean, neoбов’язковий):
    • true – шукати ключові слова безпосередньо в назвах компаній.
    • false – шукати ключові слова в назвах посад та описах вакансій.

Параметри відповіді

У разі успішного запиту сервер повертає об’єкт JSON, який містить:

  • totalCount(integer): загальна кількість знайдених відповідних вакансій.
  • jobs(array): список об’єктів вакансій, що містять:
    • id(integer): унікальний ідентифікатор вакансії.
    • title(string): назва посади.
    • location(string): розташування вакансії.
    • snippet(string): короткий фрагмент опису, що відображається в результатах пошуку.
    • salary(string): діапазон зарплати у форматі {min} - {max} {currency}.
    • source(string): джерело публікації вакансії.
    • type(string): тип зайнятості (наприклад, повна зайнятість, часткова зайнятість).
    • link(string): пряме посилання на вакансію на Jooble.
    • company(string): назва компанії.
    • updated(string): часова позначка ISO останнього оновлення вакансії.

Приклади JSON-запиту та відповіді

Приклад даних запиту:

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

Приклад успішної відповіді (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 та помилок

  • 200 OK: запит виконано успішно, дані повернуто.
  • 403 Access Denied: недійсний або відсутній ключ API.
  • 404 Not Found: запитувана кінцева точка або ресурс не існує.

Приклади реалізації коду

Ви можете інтегрувати Jooble REST API за допомогою таких мов програмування, як PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby тощо. Готові фрагменти коду та інструкції з налаштування доступні на нашій сторінці документації Jooble API.