Estimation : obtenir la valeur du marché d’une voiture
L’estimation est la requête la plus importante de l’API. Vous envoyez les indications sur une voiture et recevez la valeur du marché en francs, la fourchette et le degré de fiabilité de la valeur. Si vous le souhaitez, aussi le nombre de voitures du même modèle actuellement en vente.
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
}
}Quelles indications dois-je envoyer ?
Obligatoires : make, model, year, mileageKm, fuel et transmission. Facultatifs : puissance, traction, carrosserie, vendeur et état. Plus il y a d’indications, mieux les annonces comparables correspondent et plus la valeur est fiable. Sans indication sur le vendeur, l’API part d’un professionnel. Les champs facultatifs peuvent manquer ou valoir null.
POSThttps://prisradar.ch/api/v1/valuations
| Champ | Type | Signification |
|---|---|---|
makeObligatoire | string | Marque, dans n’importe quelle orthographe : Audi, Mercedes-Benz, VW. |
modelObligatoire | string | Modèle comme dans le catalogue, par exemple Q5 ou Golf. |
yearObligatoire | integer | Année de première immatriculation. Les voitures de plus de 25 ans n’obtiennent pas de valeur. |
mileageKmObligatoire | integer | Kilométrage, de 0 à 999999. |
fuelObligatoire | enum | petrol diesel hybrid electric gas |
transmissionObligatoire | enum | manual automatic |
powerKw | integer | Puissance en kW. Ou bien powerHp en ch. |
drive | enum | fwd rwd awd |
bodyType | enum | small sedan wagon suv coupe convertible van |
seller | enum | dealer ou private. Sans indication : professionnel. |
condition.accident | boolean | Véhicule accidenté : la valeur et la fiabilité baissent ; notes indique la déduction. |
condition.damage | boolean | Dégât visible : la valeur baisse ; notes indique la déduction. |
include | array | ["market"] fournit aussi market. |
Que contient la réponse ?
value.chf est la valeur du marché en francs, value.low et value.high la fourchette où se situent la plupart des offres comparables. confidence indique le degré de fiabilité de la valeur, comparables combien d’annonces l’étayent. notes contient des remarques en allemand, attribution le texte et le lien qui doivent figurer à côté de la valeur.
| Champ | Type | Signification |
|---|---|---|
value.chf | integer | Valeur du marché en francs, arrondie à la centaine. |
value.low · value.high | integer | Fourchette où se situent la plupart des offres comparables. |
value.basis | string | Toujours asking_prices : prix demandés dans les annonces. |
confidence.level | enum | hoch (élevée) dès 0.7, mittel (moyenne) dès 0.5, sinon tief (faible). En plus, score de 0 à 1. |
comparables.count | integer | Nombre d’annonces similaires qui étayent la valeur, au moins 3. |
comparables.closeness | enum | eng (étroit) : toutes proches de la voiture. weit (large) : le cercle a dû être élargi. |
comparables.level | enum | configuration : même carburant et même boîte. model : tout le modèle. |
market | object | Seulement avec include : activeListings voitures actuellement en vente, medianDaysOnline durée médiane en ligne, en jours. |
notes | string[] | Remarques en allemand, par exemple sur une déduction pour accident. |
attribution | object | Texte et lien qui doivent figurer à côté de la valeur. |
dataAsOf | string | Date du dernier recalcul des prix des annonces comparables. |
Comment lire la fiabilité ?
confidence.level résume à quel point la valeur est étayée : hoch (élevée), mittel (moyenne) ou tief (faible). Le niveau dépend du nombre d’annonces comparables et de leur proximité avec la voiture. Avec tief, affichez une remarque à côté de la valeur ou omettez-la, selon l’usage qu’en fait votre logiciel.
Que se passe-t-il s’il n’y a pas de valeur ?
Si le catalogue ne connaît pas la marque ou le modèle, vous recevez 404 avec des suggestions dans error.suggestions. S’il y a trop peu d’annonces similaires, vous recevez 422 too_few_comparables ; ce n’est pas une erreur de votre logiciel, les voitures rares ont souvent trop peu de comparaisons. Aucun des deux cas ne compte dans le quota.
{
"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
}
}
}Vous n’avez pas trouvé ce que vous cherchez ?Écrivez à info@prisradar.ch ou via le formulaire de contact.