Diubah pada: 16 Aug, 2026

Panduan ini menyediakan dokumentasi untuk berintegrasi dengan Jooble REST API. Di bawah ini, Anda akan menemukan informasi tentang pembuatan kunci API, endpoint, parameter permintaan, format JSON, dan kode respons umum. Jika Anda belum memulai integrasi, lihat panduan langkah demi langkah kami tentang Cara Menghubungkan ke Jooble REST API.

Batasan Regional Penting:
Setiap domain (negara) Jooble memerlukan kunci REST API uniknya sendiri. Misalnya, kunci yang dibuat di jooble.org memberikan akses eksklusif ke daftar lowongan AS. Untuk mencari lowongan di negara lain, daftar dan dapatkan kunci API di domain regional yang sesuai (misalnya, uk.jooble.org/api/about untuk Inggris Raya atau de.jooble.org/api/about untuk Jerman).
Batasan Penggunaan API:
Paket REST API gratis mencakup batas seumur hidup sebanyak 500 permintaan per kunci (ini adalah kuota seumur hidup mutlak, bukan batas bulanan).

Cara Mendapatkan Kunci Jooble REST API

  1. Daftar akun di portal API Jooble untuk negara target Anda (misalnya, id.jooble.org/api/about).
  2. Setelah terdaftar, salin dan simpan dengan aman kunci API yang telah dibuat.

Parameter Permintaan (JSON Body)

Payload permintaan harus dikirim dalam format application/json dengan parameter berikut:

  • keywords(string, wajib): Kata kunci atau jabatan yang ingin dicari.
  • location(string, wajib): Nama lokasi (kota, wilayah, atau negara).
  • radius(string, opsional): Radius pencarian dalam kilometer. Nilai yang diperbolehkan: 0, 4, 8, 16, 26, 40, 80.
  • salary(integer, opsional): Batas gaji minimum.
  • page(integer, opsional): Nomor halaman hasil pencarian (default adalah 1).
  • ResultOnPage(integer, opsional): Jumlah item lowongan yang dikembalikan per halaman.
  • SearchMode(integer, opsional): Mode algoritme pencarian (default adalah 0).
  • companysearch(boolean, opsional):
    • true – Cari kata kunci secara khusus dalam nama perusahaan.
    • false – Cari kata kunci dalam jabatan dan deskripsi.

Parameter Respons

Setelah permintaan berhasil, server mengembalikan objek JSON yang berisi:

  • totalCount(integer): Jumlah total lowongan cocok yang ditemukan.
  • jobs(array): Daftar objek lowongan yang berisi:
    • id(integer): Pengidentifikasi unik lowongan.
    • title(string): Jabatan.
    • location(string): Lokasi lowongan.
    • snippet(string): Cuplikan deskripsi singkat yang ditampilkan dalam hasil pencarian.
    • salary(string): Rentang gaji yang diformat sebagai {min} - {max} {currency}.
    • source(string): Sumber postingan lowongan.
    • type(string): Jenis pekerjaan (misalnya, Penuh waktu, Paruh waktu).
    • link(string): URL langsung ke lowongan di Jooble.
    • company(string): Nama perusahaan.
    • updated(string): Stempel waktu ISO dari pembaruan lowongan terakhir.

Contoh Permintaan & Respons JSON

Contoh Payload Permintaan:

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

Contoh Respons Sukses (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://id.jooble.org/jdp/12345", "company": "ABC Corp", "updated": "2023-09-15T12:55:35.3870000" } ] }

Respons HTTP & Kode Kesalahan

  • 200 OK: Permintaan berhasil dan mengembalikan data.
  • 403 Access Denied: Kunci API tidak valid atau hilang.
  • 404 Not Found: Endpoint atau sumber daya yang diminta tidak ada.

Contoh Implementasi Kode

Anda dapat mengintegrasikan Jooble REST API menggunakan bahasa pemrograman seperti PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby, dan lainnya. Cuplikan kode siap pakai dan panduan implementasi tersedia di Halaman Dokumentasi Jooble API.