API publik & panduan AI

Mulai dari sini

OpenAPI JSON · llms.txt untuk AI

curl 'https://maganghub.ngerti.in/api/v1/jobs?q=mengolah%20data%20dan%20membuat%20dashboard&education=sarjana&limit=12'

API memakai HTTPS pada domain produksi. Tidak memerlukan API key; kredensial embedding dikelola server.

Endpoint

• GET /api/v1/jobs — pencarian, filter, sort, dan pagination.
• GET /api/v1/jobs/{id} — detail, deskripsi yang tersedia, dan tautan sumber.
• GET /api/v1/facets — pilihan filter; gunakan nilai value, bukan label. Nilai kota menyertakan provinsi.

Parameter pencarian

q

Kata kunci atau deskripsi minat/keahlian, maksimal 250 karakter.

mode

Default hybrid; keyword tidak memanggil embedding provider. Pilihan: hybrid, keyword.

category

Kategori posisi. Pilihan: administrasi, ai, bisnis, data, desain, hukum, it, kesehatan, keuangan, lingkungan, logistik, pariwisata, pemasaran, pendidikan, pertanian, manufaktur, publik, riset, sdm, dev, teknik, lain.

province

value provinsi dari /api/v1/facets.

city

value kota dari facets, termasuk prefix provinsi.

organizationType

Jenis penyelenggara. Pilihan: company, government.

education

Jenjang pendidikan. Pilihan: diploma, sarjana, profesi.

interview

Tipe wawancara; online tidak berarti pekerjaan remote. Pilihan: online, onsite.

minQuota

Kuota minimal, 0 sampai 1000000.

disability

1 untuk posisi ramah disabilitas. Pilihan: 0, 1.

sort

Urutan hasil; score adalah skor peluang, bukan relevansi. Pilihan: relevance, portal, score, quota, appl, az.

page

Halaman mulai dari 1, maksimal 100000.

limit

Hasil per halaman, 1-50; default 12.

Bidang pekerjaan

Tersedia 22 pilihan bidang, termasuk kesehatan, keuangan, hukum, pendidikan, SDM, pertanian, logistik, dan teknik. Bidang diperkirakan dari judul posisi, bukan klasifikasi resmi penyelenggara. Posisi yang belum dikenali masuk Bidang lainnya. Periksa detail untuk memastikan kesesuaiannya; versi klasifikasi tersedia dalam meta.categoryVersion.

Hasil dan pagination

Respons berisi jobs, total, page, pages, pageSize, dan meta. Halaman yang melewati batas diarahkan ke halaman terakhir. Tanpa query, seluruh katalog terfilter dapat dijelajahi. Dalam mode hybrid, total menghitung seluruh hasil keyword ditambah maksimal 200 kandidat semantic yang melewati batas relevansi, setelah deduplikasi. Identitas snapshot tersedia di metadata.

Judul persis diprioritaskan. Sort eksplisit tetap berlaku. Skor peluang dan skor relevansi bukan probabilitas diterima magang.

Batas penggunaan dan fallback

Maksimal 60 request per menit per client. Pembuatan embedding query baru dibatasi 10 per menit per client dan memiliki batas harian bersama; query yang sudah tersimpan dapat menggunakan cache. Batas client mengikuti identitas proxy tepercaya; pada lingkungan tanpa proxy tepercaya, bucket dibagi bersama.

HTTP 429 menyertakan Retry-After. Parameter pencarian resmi yang tidak valid atau berulang menghasilkan 400. Parameter tambahan yang tidak dikenal, termasuk tracking dari platform AI, diabaikan dan tidak menjadi filter. Detail yang tidak ditemukan menghasilkan 404, dan gangguan database 503. Jika layanan semantic gagal atau kuotanya habis, hasil keyword tetap dapat dikembalikan; periksa meta.mode dan meta.fallbackReason.

Catatan untuk AI dan pengguna data

Snapshot awal diambil 31 Oktober 2026 dan dapat menerima pembaruan incremental dari bot. Periksa meta.dataMode, meta.revision, dan meta.lastIngestedAt. Waktu batch terakhir tidak menjamin seluruh lowongan diperbarui bersamaan. Gunakan observedAt tiap lowongan, atau snapshotDate jika nilainya null, serta sourceUrl saat mengutip. API membaca data terbaru tanpa cache respons.

Batas pelamaran pada snapshot awal adalah 4 November 2026. Aplikasi ini bukan portal resmi atau data live; periksa ketersediaan di sumber resmi. Deskripsi yang tidak tersedia dikembalikan sebagai null. Wawancara online tidak berarti kerja WFH. Gunakan filter terstruktur untuk lokasi dan pendidikan; menuliskannya di query saja tidak menjamin batas tersebut diterapkan. llms.txt menyediakan panduan dan tautan; penggunaan otomatis tetap bergantung pada platform AI.