ClearVin API - Estimarea valorii de piață prin VIN
API-ul oferă acces la datele actuale privind valoarea de piață a unui vehicul, inclusiv valorile de vânzare cu amănuntul, de tranzacționare și de depozit, ceea ce ajută la determinarea prețului real acceptabil al unui vehicul. Toate prețurile sunt calculate ținând cont de kilometrajul și istoricul mașinii.
Vă rugăm să rețineți: datele de evaluare de piață nu includ nicio modificare după vânzare a vehiculului. Valorile la nivel național sunt returnate în mod implicit, dar oferim parametri suplimentari pentru a extrage date pentru o anumită stare.
autorizație
Va trebui să utilizați e-mailul și parola pentru a obține simbolul de acces folosind acest URL:POST https://www.clearvin.com/rest/vendor/login
Solicitarea trebuie să fie de la o adresă IP înregistrată.Sarcina utilă ar trebui să fie:
{
"email" : “[email protected]”,
"password": "11111111"
}răspuns
| element | descriere | format |
|---|---|---|
| status | precizează dacă solicitarea a fost tratată cu succes sau s-a încheiat cu o eroare | Șir error sau ok |
| message | Conține detalii despre rezultat dacă starea este error | șir |
| token | Simbolul web JSON. Simbolul expiră în 120 minute | șir |
Dacă e-mailul și parola sunt corecte, tokenul va primi răspuns cu token după urmează:
{
"status": "ok",
"token": " I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}Raport
După ce primiți acest simbol, îl puteți utiliza pentru a accesa rapoarte utilizând acest URL:GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050
Pentru a utiliza acest punct final, trebuie să furnizați antetul HTTP cu simbolul furnizat după urmează:Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
răspuns
| element | descriere | tip |
|---|---|---|
| status | precizează dacă solicitarea a fost tratată cu succes sau s-a încheiat cu o eroare | Șir error sau ok |
| message | Conține detalii despre rezultat dacă starea este error | șir |
| Report id | Conține ID-ul curent al raportului | șir |
| Report vin | Vin solicitat | șir |
| Report report | Conține informații complete despre vehicul | Obiect JSON |
De asemenea, puteți primi rapoarte în vizualizarea HTML utilizând URL-uri de acest fel:
GET https://www.clearvin.com/rest/vendor/report?vin=5UXFA13544LU21050&format=html
Și furnizați următoarele anteturi HTTP:
Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0
Content-Type: text/html
Auth succes
Cerere
curl -X POST \
https://www.clearvin.com/rest/vendor/login \
-H 'Content-Type: application/json' \
-d '{
"email": "[email protected]",
"password": "yourpassword"
}Răspuns de succes
{
"status": "ok",
"token": "I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0"
}Eroare de răspuns
{
"status": "error",
"message": "Wrong username or password"
}Raport
Cerere
curl - X GET\ 'https://www.clearvin.com/rest/vendor/report?vin=WBAFR7C57CC811956'\ -
H 'Authorization: Bearer I6MTgxLCJpYXQiOjE1MDk1NTg4MTksIm4cCI6MTUwOTU1OTQxOX0.ACV0t3UyHXs0'\ -
H 'Content-Type: application/json'Răspuns de succes
{
"status": "ok",
"result": {
"id": "00CA168F",
"vin": "WAUDG74F25N111998",
"report": {
"blackbook": {
"publish_date": "12/29/2023",
"data_freq": "D",
"state": "NT",
"country": "US",
"vin": "3FAHP0HAB",
"uvc": "2011300901",
"groupnum": "0023",
"model_year": "2011",
"make": "Ford",
"model": "Fusion",
"series": "SE",
"style": "4D Sedan",
"mileage_cat": "B",
"class_code": "C",
"class_name": "Mid-Size Car",
"description_score": "",
"first_values_flag": false,
"risk_score": "",
"base_whole_xclean": 3900,
"mileage_whole_xclean": 0,
"add_deduct_whole_xclean": 0,
"regional_whole_xclean": 0,
"adjusted_whole_xclean": 3900,
"mileage_whole_clean": 0,
"add_deduct_whole_clean": 0,
"regional_whole_clean": 0,
"adjusted_whole_clean": 2900,
"mileage_whole_avg": 0,
"add_deduct_whole_avg": 0,
"regional_whole_avg": 0,
"adjusted_whole_avg": 1550,
"mileage_whole_rough": 0,
"add_deduct_whole_rough": 0,
"regional_whole_rough": 0,
"adjusted_whole_rough": 350,
"base_retail_xclean": 7800,
"mileage_retail_xclean": 0,
"add_deduct_retail_xclean": 0,
"regional_retail_xclean": 0,
"adjusted_retail_xclean": 7800,
"base_retail_clean": 6550,
"mileage_retail_clean": 0,
"add_deduct_retail_clean": 0,
"regional_retail_clean": 0,
"adjusted_retail_clean": 6550,
"base_retail_avg": 4400,
"mileage_retail_avg": 0,
"add_deduct_retail_avg": 0,
"regional_retail_avg": 0,
"adjusted_retail_avg": 4400,
"base_retail_rough": 2500,
"mileage_retail_rough": 0,
"add_deduct_retail_rough": 0,
"regional_retail_rough": 0,
"adjusted_retail_rough": 2500,
"base_tradein_clean": 2980,
"mileage_tradein_clean": 0,
"add_deduct_tradein_clean": 0,
"regional_tradein_clean": 0,
"adjusted_tradein_clean": 2980,
"base_tradein_avg": 1630,
"mileage_tradein_avg": 0,
"add_deduct_tradein_avg": 0,
"regional_tradein_avg": 0,
"adjusted_tradein_avg": 1630,
"base_tradein_rough": 350,
"mileage_tradein_rough": 0,
"add_deduct_tradein_rough": 0,
"regional_tradein_rough": 0,
"adjusted_tradein_rough": 350,
"region2": 0,
"region3": 0,
"region4": 0,
"region5": 0,
"region6": 0,
"msrp": 21515,
"retail_equipped": 23585,
"price_includes": "AC AT",
"wheel_base": 107.4,
"tire_size": "225/50R17",
"gvw": 3285,
"seat_cap": "5",
"fuel_type": "Gas",
"fuel_cap": "17.5",
"fuel_delivery": "SMPI",
"hwy_mpg": "32",
"city_mpg": "22",
"engine_description": "2.5L I-4 SMPI DOHC",
"cylinders": "4",
"engine_displacement": "2.5L",
"base_hp": "175 @ 6000",
"taxable_hp": 19.6,
"torque": "172 @ 4500",
"oil_cap": "5.0",
"transmission": "A",
"drivetrain": "FWD",
"num_gears": "6",
"ext_doors": "4",
"airbags": "Personal Safety System; Side Curtain",
"basic_warranty": "3-year/36,000-mile, Limited",
"powertrain_warranty": "5-year/60,000-mile",
"road_assist_warranty": "5-year/60,000-mile",
"add_deduct_list": [{
"uoc": "87",
"name": "Aluminum Wheels",
"xclean": 100,
"clean": 100,
"avg": 100,
"rough": 100,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
}, {
"uoc": "12",
"name": "Power Moonroof",
"xclean": 150,
"clean": 150,
"avg": 150,
"rough": 150,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
}, {
"uoc": "16",
"name": "V6",
"xclean": 200,
"clean": 200,
"avg": 200,
"rough": 200,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
}, {
"uoc": "05",
"name": "w/o Auto Trans",
"xclean": -450,
"clean": -450,
"avg": -450,
"rough": -450,
"auto": "N",
"resid12": 0,
"resid24": 0,
"resid30": 0,
"resid36": 0,
"resid42": 0,
"resid48": 0,
"resid60": 0,
"resid72": 0
}],
"mileage_list": [{
"model_year": "2011",
"range_begin": 1,
"range_end": 8000,
"xclean": 1475,
"clean": 1550,
"avg": 1625,
"rough": 1625,
"finadv": 1500,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 8001,
"range_end": 20000,
"xclean": 1375,
"clean": 1475,
"avg": 1550,
"rough": 1625,
"finadv": 1425,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 20001,
"range_end": 32000,
"xclean": 1300,
"clean": 1375,
"avg": 1475,
"rough": 1550,
"finadv": 1350,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 32001,
"range_end": 44000,
"xclean": 1225,
"clean": 1300,
"avg": 1375,
"rough": 1475,
"finadv": 1275,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 44001,
"range_end": 56000,
"xclean": 1150,
"clean": 1225,
"avg": 1300,
"rough": 1375,
"finadv": 1175,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 56001,
"range_end": 68000,
"xclean": 1075,
"clean": 1150,
"avg": 1225,
"rough": 1300,
"finadv": 1100,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 68001,
"range_end": 80000,
"xclean": 950,
"clean": 1075,
"avg": 1150,
"rough": 1225,
"finadv": 1000,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 80001,
"range_end": 87000,
"xclean": 800,
"clean": 950,
"avg": 1075,
"rough": 1150,
"finadv": 875,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 87001,
"range_end": 94000,
"xclean": 675,
"clean": 800,
"avg": 950,
"rough": 1075,
"finadv": 750,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 94001,
"range_end": 101000,
"xclean": 550,
"clean": 675,
"avg": 800,
"rough": 950,
"finadv": 600,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 101001,
"range_end": 108000,
"xclean": 400,
"clean": 550,
"avg": 675,
"rough": 800,
"finadv": 475,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 108001,
"range_end": 115000,
"xclean": 350,
"clean": 400,
"avg": 550,
"rough": 675,
"finadv": 375,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 115001,
"range_end": 122000,
"xclean": 300,
"clean": 350,
"avg": 400,
"rough": 550,
"finadv": 325,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 122001,
"range_end": 125000,
"xclean": 250,
"clean": 300,
"avg": 350,
"rough": 400,
"finadv": 275,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 125001,
"range_end": 128000,
"xclean": 175,
"clean": 250,
"avg": 300,
"rough": 350,
"finadv": 200,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 128001,
"range_end": 131000,
"xclean": 125,
"clean": 175,
"avg": 250,
"rough": 300,
"finadv": 150,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 131001,
"range_end": 134000,
"xclean": 75,
"clean": 125,
"avg": 175,
"rough": 250,
"finadv": 100,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 134001,
"range_end": 137000,
"xclean": 0,
"clean": 75,
"avg": 125,
"rough": 175,
"finadv": 50,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 137001,
"range_end": 140000,
"xclean": -75,
"clean": 0,
"avg": 75,
"rough": 125,
"finadv": -50,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 140001,
"range_end": 143000,
"xclean": -125,
"clean": -75,
"avg": 0,
"rough": 75,
"finadv": -100,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 143001,
"range_end": 146000,
"xclean": -175,
"clean": -125,
"avg": -75,
"rough": 0,
"finadv": -150,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 146001,
"range_end": 149000,
"xclean": -250,
"clean": -175,
"avg": -125,
"rough": -75,
"finadv": -200,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 149001,
"range_end": 152000,
"xclean": -300,
"clean": -250,
"avg": -175,
"rough": -125,
"finadv": -275,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 152001,
"range_end": 155000,
"xclean": -350,
"clean": -300,
"avg": -250,
"rough": -175,
"finadv": -325,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 155001,
"range_end": 158000,
"xclean": -400,
"clean": -350,
"avg": -300,
"rough": -250,
"finadv": -375,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 158001,
"range_end": 161000,
"xclean": -550,
"clean": -400,
"avg": -350,
"rough": -300,
"finadv": -475,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 161001,
"range_end": 164000,
"xclean": -675,
"clean": -550,
"avg": -400,
"rough": -350,
"finadv": -600,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 164001,
"range_end": 171000,
"xclean": -800,
"clean": -675,
"avg": -550,
"rough": -400,
"finadv": -750,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 171001,
"range_end": 178000,
"xclean": -950,
"clean": -800,
"avg": -675,
"rough": -550,
"finadv": -875,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 178001,
"range_end": 185000,
"xclean": -1075,
"clean": -950,
"avg": -800,
"rough": -675,
"finadv": -1000,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 185001,
"range_end": 192000,
"xclean": -1200,
"clean": -1075,
"avg": -950,
"rough": -800,
"finadv": -1150,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 192001,
"range_end": 199000,
"xclean": -1350,
"clean": -1200,
"avg": -1075,
"rough": -950,
"finadv": -1275,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 199001,
"range_end": 206000,
"xclean": -1575,
"clean": -1350,
"avg": -1200,
"rough": -1075,
"finadv": -1450,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 206001,
"range_end": 213000,
"xclean": -1650,
"clean": -1575,
"avg": -1350,
"rough": -1200,
"finadv": -1600,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 213001,
"range_end": 225000,
"xclean": -1650,
"clean": -1650,
"avg": -1575,
"rough": -1350,
"finadv": -1650,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 225001,
"range_end": 237000,
"xclean": -1650,
"clean": -1650,
"avg": -1650,
"rough": -1575,
"finadv": -1650,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 237001,
"range_end": 249000,
"xclean": -1650,
"clean": -1650,
"avg": -1650,
"rough": -1650,
"finadv": -1650,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 249001,
"range_end": 261000,
"xclean": -1650,
"clean": -1650,
"avg": -1650,
"rough": -1650,
"finadv": -1650,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 261001,
"range_end": 273000,
"xclean": -1650,
"clean": -1650,
"avg": -1650,
"rough": -1650,
"finadv": -1650,
"mileage_cat": "B"
}, {
"model_year": "2011",
"range_begin": 273001,
"range_end": 999999,
"xclean": -1650,
"clean": -1650,
"avg": -1650,
"rough": -1650,
"finadv": -1650,
"mileage_cat": "B"
}],
"model_number_list": ["P0H"]
}
}
}
}