Get A Job API — Dokumentasi

Base URL: https://ggaj.prstya.my.id

API ini menyediakan tiga endpoint utama: mencari lowongan kerja, melihat detail lowongan, dan membuat cover letter otomatis dari CV kamu.

---

Endpoints

1. Cari Lowongan Kerja

POST /get-job

Endpoint ini digunakan untuk mencari daftar lowongan kerja berdasarkan nama posisi dan lokasi.

Request (form-data)

Parameter	Tipe	Wajib	Keterangan
name_job	string	Ya	Nama posisi yang dicari, contoh: it support, programmer, sales
location	string	Ya	Lokasi pekerjaan, contoh: Jawa Barat, Jakarta
max_job	integer	Tidak	Jumlah maksimal lowongan yang diambil (default: 10)

Contoh Response

[
    {
        "platform": "linkedin",
        "title": "Dukungan Teknis IT",
        "link": "https://id.linkedin.com/jobs/view/dukungan-teknis-it-at-pt-berca-hardayaperkasa-4320230749",
        "company": "PT Berca Hardayaperkasa",
        "location": "Jakarta",
        "posted": "2025-10-31"
    },
    {
        "platform": "linkedin",
        "title": "IT Governance",
        "link": "https://id.linkedin.com/jobs/view/it-governance-at-ocbc-indonesia-4330241837",
        "company": "OCBC Indonesia",
        "location": "Kota Tangerang",
        "posted": "2026-05-04"
    }
]

---

2. Detail Lowongan

POST /detail-job

Endpoint ini mengambil informasi lengkap dari sebuah lowongan berdasarkan link yang didapat dari /get-job.

Request (form-data)

Parameter	Tipe	Wajib	Keterangan
link_job	string	Ya	Link lowongan dari field link di response /get-job
job_source	string	Ya	Platform sumber lowongan dari field platform di response /get-job

Contoh Response

{
    "job_title": "Dukungan Teknis IT",
    "job_desc": "Menyediakan dukungan teknis untuk perangkat keras dan perangkat lunak. Mengidentifikasi dan menyelesaikan masalah teknologi yang dihadapi End User...",
    "company": "PT Berca Hardayaperkasa",
    "location": "Jakarta",
    "salary": null,
    "job_type": "Asosiasi | Penuh waktu | Teknologi Informasi | Jasa TI dan Konsultan TI"
}

---

3. Generate Cover Letter

POST /generate-cover-letter

Endpoint ini membuat cover letter secara otomatis berdasarkan CV yang kamu upload dan deskripsi pekerjaan dari link yang diberikan.

Request (form-data)

Parameter	Tipe	Wajib	Keterangan
cv	file (PDF)	Ya	File CV kamu dalam format PDF
link_job	string	Ya	Link lowongan dari field link di response /get-job
source_job	string	Ya	Platform sumber lowongan dari field platform di response /get-job
ai_provider	string	Ya	Provider AI yang digunakan. Saat ini mendukung: openrouter, groq
base_url_provider	string	Ya	Base URL dari provider AI, contoh: https://openrouter.ai/api/v1
model	string	Ya	Nama model AI yang digunakan, contoh: meta-llama/llama-3.1-8b-instruct
api_key	string	Ya	API key dari provider AI kamu
lang	string	Ya	Bahasa output cover letter: id untuk Indonesia, en untuk Inggris

Contoh Response

{
    "message": "success",
    "content": "Kepada HRD / Tim Rekrutmen PT Berca Hardayaperkasa\n\nSaya sangat senang untuk melamar posisi IT Support di PT Berca Hardayaperkasa..."
}

---

Alur Penggunaan

Urutan yang disarankan kalau ingin generate cover letter dari awal:

1. Panggil /get-job untuk mendapatkan daftar lowongan
2. Pilih lowongan yang relevan, ambil link dan platform-nya
3. (Opsional) Panggil /detail-job untuk melihat deskripsi lengkap lowongan tersebut
4. Panggil /generate-cover-letter dengan CV kamu dan link lowongan yang sudah dipilih

---

Catatan

• File CV yang dikirim ke /generate-cover-letter harus berformat PDF. Format lain akan ditolak.
• Nilai salary pada response /detail-job bisa bernilai null jika informasi gaji tidak dicantumkan di lowongan.
• Parameter max_job pada /get-job tidak wajib diisi. Jika tidak diisi, secara default akan mengambil 10 lowongan.