Land Value Estimation

Method: POST URL: {{baseUrl}}/kocek/land-value-estimation

Description

Mengambil estimasi harga pasar tanah per meter persegi (m²) dari berbagai platform properti online. Sistem melakukan scraping data dari marketplace properti seperti OLX, Rumah123, Properti123, Pinhome, dan Lamudi untuk memberikan rentang harga pasar yang relevan.

Endpoint ini biasanya digunakan setelah berhasil mendapatkan data tanah dari Verify Land. Gunakan collateral_id dari respon verifikasi tanah untuk melakukan estimasi harga.

Request Headers

Key	Value	Deskripsi
Content-Type	application/json	-
Authentication	Bearer ACCESS_TOKEN	Akses token yang digenerate saat login

Request Body

Key/Field	Type	Wajib	Deskripsi
collateral_id	string	Ya	ID agunan tanah yang didapatkan dari respon Verify Land. Digunakan untuk mengidentifikasi data tanah yang akan diestimasi harganya
transaction_code	string	Ya	Kode unik transaksi untuk tracking status
location	string	Tidak	Deskripsi lokasi tambahan untuk mempertepat pencarian (contoh: nama desa/kelurahan dan kota)

Contoh Request

{
  "collateral_id": "6135451E32CEA82BE040A8C010012645",
  "transaction_code": "TXN-LAND-001",
  "location": "Pedungan, Denpasar"
}

Responses

200 - Success

Status: 200

Berhasil mengambil estimasi harga dari marketplace properti.

Field	Deskripsi
platform_name	Nama marketplace properti
platform_site	Domain website marketplace
range	Rentang harga per m² yang ditemukan, atau "Tidak ada data yang relevan" jika tidak ditemukan listing
image_url	URL logo marketplace

{
    "data": [
        {
            "platform_name": "OLX",
            "platform_site": "olx.co.id",
            "range": "Tidak ada data yang relevan",
            "image_url": "https://storage.googleapis.com/openpublic-documents/kocek/olx.png"
        },
        {
            "platform_name": "Rumah123",
            "platform_site": "rumah123.com",
            "range": "Rp 3.500.000 - Rp 3.500.000",
            "image_url": "https://storage.googleapis.com/openpublic-documents/kocek/rumah123.png"
        },
        {
            "platform_name": "Properti123",
            "platform_site": "properti123.com",
            "range": "Tidak ada data yang relevan",
            "image_url": "https://storage.googleapis.com/openpublic-documents/kocek/properti-123.png"
        },
        {
            "platform_name": "Pinhome",
            "platform_site": "pinhome.id",
            "range": "Tidak ada data yang relevan",
            "image_url": "https://storage.googleapis.com/openpublic-documents/kocek/pinhome.png"
        },
        {
            "platform_name": "Lamudi",
            "platform_site": "lamudi.co.id",
            "range": "Rp 7.000.000 - Rp 9.500.000",
            "image_url": "https://storage.googleapis.com/openpublic-documents/kocek/lamudi.png"
        }
    ],
    "message": "Berhasil memproses permintaan",
    "status": "success"
}

info

Catatan Harga yang ditampilkan merupakan estimasi berdasarkan data listing yang aktif di masing-masing marketplace. Tidak semua platform selalu memiliki data yang relevan untuk lokasi tertentu.

403 - Layanan Tidak Aktif

Status: 403

{
    "error": "Layanan estimasi harga tanah sedang tidak tersedia",
    "message": "Layanan estimasi harga tanah sedang tidak tersedia",
    "status": "fail"
}