Vehicle Get Estimated Price

Method: POST
URL: {{baseUrl}}/kocek/vehicle/estimated/price

Description

Mengambil estimasi harga pasar kendaraan dari marketplace online (saat ini mendukung OLX). Sistem melakukan pencarian terhadap listing kendaraan sejenis di lokasi yang ditentukan untuk memberikan rentang harga yang relevan.

Endpoint ini biasanya digunakan setelah berhasil mendapatkan data kendaraan. Hasil yang dikembalikan berupa daftar listing kendaraan sejenis beserta rentang harga (range_price).

info

Cara Kerja Pengambilan Data Sistem mengambil maksimal 5 listing dari marketplace. Susunan data selalu sebagai berikut:

• 1 listing dengan harga tertinggi — ditampilkan pertama untuk menunjukkan batas atas pasar
• 1 listing dengan harga terendah — ditampilkan untuk menunjukkan batas bawah pasar
• 3 listing lainnya — dipilih secara acak (random) dari sisa data yang tersedia

Rentang harga (range_price) dihitung dari harga terendah dan harga tertinggi dari seluruh data yang ditemukan, bukan hanya dari 5 listing yang ditampilkan.

Parameter platform, brand, dan type menggunakan format slug. Gunakan referensi yang tersedia untuk mendapatkan nilai yang benar.

Request Headers

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

Request Body

Key/Field	Type	Contoh	Deskripsi
useplatformrname	string	olx	Marketplace platform lokasi pencarian kendaraan sejenis. Saat ini hanya support olx
location_id	string	2000002	Kode lokasi (provinsi) pencarian. Data referensi menggunaakan link Marketplace Location Master
vehicle_type	string	200	Jenis kendaraan bermotor (198: mobil, 200: motor)
brand	string	motor-bekas-honda	Brand atau merk kendaraan. Cek referensi di: Master Brand Motor dan Master Brand Mobil
type	string	motor-bekas-honda-vario	Tipe atau model kendaraan sesuai dengan merk. List model dapat diambil dari master brand
year	number	2010	Tahun produksi kendaraan
transmission	string	automatic	Jenis transmisi kendaraan. Opsi tersedia: manual, automatic, atau triptonic
color	string	putih	Warna kendaraan bermotor. Cek Referensi Warna Kendaraan

Contoh Request

{
	"platform": "olx",
	"location_id": "2000002",
	"vehicle_type": "200",
	"brand": "motor-bekas-honda",
	"type": "motor-bekas-honda-vario",
	"year": 2010,
	"transmission": "automatic",
	"color": "putih"
}

Responses

200 - Kendaraan Sejenis Ditemukan

Status: 200

{
    "data": {
        "id": "c554d8fa-8ed7-46a9-8a2d-724f64b74652",
        "vehicles": [
            {
                "id": "925176331",
                "title": "Vario cw th 2010 Deva motor",
                "price": 5350000,
                "price_formatted": "Rp 5.350.000",
                "url": "https://www.olx.co.id/item/vario-cw-th-2010-deva-motor-iid-925176331",
                "year": "2010",
                "mileage": "25.000-30.000 km",
                "location": "Denpasar Timur, Bali"
            },
            {
                "id": "925790889",
                "title": "Vario cw 2010 hitam silver",
                "price": 7400000,
                "price_formatted": "Rp 7.400.000",
                "url": "https://www.olx.co.id/item/vario-cw-2010-hitam-silver-iid-925790889",
                "year": "2010",
                "location": "Denpasar Barat, Bali"
            },
            {
                "id": "925241673",
                "title": "Vario cw th 2010 Deva motor",
                "price": 5350000,
                "price_formatted": "Rp 5.350.000",
                "url": "https://www.olx.co.id/item/vario-cw-th-2010-deva-motor-iid-925241673",
                "year": "2010",
                "mileage": "20.000-25.000 km",
                "location": "Nusa Dua, Bali"
            },
            {
                "id": "925068239",
                "title": "HONDA VARIO 2010",
                "price": 5950000,
                "price_formatted": "Rp 5.950.000",
                "url": "https://www.olx.co.id/item/honda-vario-2010-iid-925068239",
                "year": "2010",
                "mileage": "20.000-25.000 km",
                "location": "Denpasar Selatan, Bali"
            },
            {
                "id": "925091940",
                "title": "Honda Vario cw 2010 cash Bali dharma motor",
                "price": 6200000,
                "price_formatted": "Rp 6.200.000",
                "url": "https://www.olx.co.id/item/honda-vario-cw-2010-cash-bali-dharma-motor-iid-925091940",
                "year": "2010",
                "mileage": "50.000-55.000 km",
                "location": "Denpasar Selatan, Bali"
            }
        ],
        "range_price": "5350000-7400000",
        "range_price_formatted": "Rp. 5.350.000 - 7.400.000"
    },
    "message": "Berhasil memproses permintaan",
    "status": "success"
}

200 - Kendaraan Sejenis Tidak Ditemukan

Status: 200

{
    "data": {
        "id": "",
        "vehicles": [],
        "range_price": "",
        "range_price_formatted": ""
    },
    "message": "Berhasil memproses permintaan",
    "status": "success"
}

401 - Unauthorized

Status: 401

{
    "status": false,
    "message": "Unauthorized",
    "data": null
}

403 - Layanan Tidak Aktif

Status: 403

{
    "status": "fail",
    "error": "Layanan pengecekan perkiraan harga kendaraan sedang tidak tersedia",
    "message": "Layanan pengecekan perkiraan harga kendaraan sedang tidak tersedia"
}