Valutazione: richiedere il valore di mercato di un’auto
La valutazione è la richiesta più importante dell’API. Invia i dati di un’auto e riceve il valore di mercato in franchi, la forbice e quanto è affidabile il valore. Se lo desidera, anche quante auto dello stesso modello sono in vendita in questo momento.
curl -X POST https://prisradar.ch/api/v1/valuations \
-H "Authorization: Bearer $PRISRADAR_KEY" \
-H "Content-Type: application/json" \
-d '{
"make": "Audi",
"model": "Q5",
"year": 2021,
"mileageKm": 50000,
"fuel": "diesel",
"transmission": "automatic",
"powerKw": 140,
"drive": "awd",
"include": [
"market"
]
}'{
"id": "val_kglReIcl8Sw0",
"test": false,
"vehicle": {
"make": "Audi",
"model": "Q5",
"year": 2021,
"mileageKm": 50000,
"fuel": "diesel",
"transmission": "automatic"
},
"value": {
"chf": 34600,
"low": 28400,
"high": 42100,
"basis": "asking_prices"
},
"confidence": {
"level": "hoch",
"score": 0.84
},
"comparables": {
"count": 10,
"closeness": "eng",
"level": "configuration"
},
"notes": [],
"attribution": {
"text": "Preisorientierung von prisradar.ch",
"url": "https://prisradar.ch"
},
"dataAsOf": "2026-10-13T00:21:50.494Z",
"market": {
"activeListings": 1269,
"medianDaysOnline": 48
}
}Quali dati invio?
Sono obbligatori make, model, year, mileageKm, fuel e transmission. Sono facoltativi potenza, trazione, carrozzeria, venditore e stato. Più dati invia, più gli annunci comparabili sono vicini e più il valore è affidabile. Senza indicazione sul venditore, l’API calcola con un commerciante. I campi facoltativi possono mancare o essere null.
POSThttps://prisradar.ch/api/v1/valuations
| Campo | Tipo | Significato |
|---|---|---|
makeObbligatorio | string | Marca, in qualsiasi grafia: Audi, Mercedes-Benz, VW. |
modelObbligatorio | string | Modello come nel catalogo, per esempio Q5 o Golf. |
yearObbligatorio | integer | Anno della prima immatricolazione. Le auto con più di 25 anni non ricevono un valore. |
mileageKmObbligatorio | integer | Chilometraggio, da 0 a 999999. |
fuelObbligatorio | enum | petrol diesel hybrid electric gas |
transmissionObbligatorio | enum | manual automatic |
powerKw | integer | Potenza in kW. In alternativa powerHp in CV. |
drive | enum | fwd rwd awd |
bodyType | enum | small sedan wagon suv coupe convertible van |
seller | enum | dealer o private. Senza indicazione: commerciante. |
condition.accident | boolean | Veicolo incidentato: il valore e l’affidabilità scendono; notes indica la deduzione. |
condition.damage | boolean | Danno visibile: il valore scende; notes indica la deduzione. |
include | array | ["market"] fornisce anche market. |
Cosa c’è nella risposta?
value.chf è il valore di mercato in franchi, value.low e value.high la forbice in cui si trova la maggior parte delle offerte comparabili. confidence dice quanto è affidabile il valore, comparables quanti annunci lo sostengono. notes contiene avvertenze in tedesco, attribution il testo e il link che devono figurare accanto al valore.
| Campo | Tipo | Significato |
|---|---|---|
value.chf | integer | Valore di mercato in franchi, arrotondato a 100. |
value.low · value.high | integer | Forbice in cui si trova la maggior parte delle offerte comparabili. |
value.basis | string | Sempre asking_prices: prezzi d’offerta degli annunci. |
confidence.level | enum | hoch (alta) da 0.7, mittel (media) da 0.5, altrimenti tief (bassa). In più score da 0 a 1. |
comparables.count | integer | Quanti annunci simili sostengono il valore, almeno 3. |
comparables.closeness | enum | eng (stretta): tutti vicini all’auto. weit (ampia): la cerchia ha dovuto allargarsi. |
comparables.level | enum | configuration: stesso carburante e stesso cambio. model: l’intero modello. |
market | object | Solo con include: activeListings in vendita in questo momento, medianDaysOnline giorni online medi. |
notes | string[] | Avvertenze in tedesco, per esempio su una deduzione per un incidente. |
attribution | object | Testo e link che devono figurare accanto al valore. |
dataAsOf | string | Quando i prezzi degli annunci comparabili sono stati ricalcolati l’ultima volta. |
Come leggo l’affidabilità?
confidence.level riassume quanto è sostenuto il valore: hoch, mittel o tief, cioè alta, media o bassa. Dipende da quanti annunci comparabili ci sono e da quanto sono vicini all’auto. Con tief mostri un’avvertenza accanto al valore oppure lo ometta, a seconda di ciò per cui il Suo software lo usa.
Cosa succede se non c’è un valore?
Se il catalogo non conosce la marca o il modello, arriva 404 con proposte in error.suggestions. Se ci sono troppo pochi annunci simili, arriva 422 too_few_comparables; non è un errore del Suo software, le auto rare hanno spesso troppo pochi confronti. In entrambi i casi la richiesta non conta nel contingente.
{
"error": {
"code": "unknown_make",
"message": "Die Marke «Ferari» kennen wir nicht.",
"suggestions": [
"Ferrari"
]
}
}{
"error": {
"code": "too_few_comparables",
"message": "Zu wenige ähnliche Inserate für einen sicheren Wert.",
"comparables": {
"count": 2,
"needed": 3
}
}
}Non ha trovato ciò che cerca?Scriva a info@prisradar.ch o tramite il modulo di contatto.