Prisradar
Points d’accès

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.

Mis à jour le 21.10.2026L’équipe Prisradar

Sur cette page
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"
    ]
  }'
Réponse 200
{
  "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

ChampTypeSignification
makeObligatoirestringMarque, dans n’importe quelle orthographe : Audi, Mercedes-Benz, VW.
modelObligatoirestringModèle comme dans le catalogue, par exemple Q5 ou Golf.
yearObligatoireintegerAnnée de première immatriculation. Les voitures de plus de 25 ans n’obtiennent pas de valeur.
mileageKmObligatoireintegerKilométrage, de 0 à 999999.
fuelObligatoireenumpetrol diesel hybrid electric gas
transmissionObligatoireenummanual automatic
powerKwintegerPuissance en kW. Ou bien powerHp en ch.
driveenumfwd rwd awd
bodyTypeenumsmall sedan wagon suv coupe convertible van
sellerenumdealer ou private. Sans indication : professionnel.
condition.accidentbooleanVéhicule accidenté : la valeur et la fiabilité baissent ; notes indique la déduction.
condition.damagebooleanDégât visible : la valeur baisse ; notes indique la déduction.
includearray["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.

ChampTypeSignification
value.chfintegerValeur du marché en francs, arrondie à la centaine.
value.low · value.highintegerFourchette où se situent la plupart des offres comparables.
value.basisstringToujours asking_prices : prix demandés dans les annonces.
confidence.levelenumhoch (élevée) dès 0.7, mittel (moyenne) dès 0.5, sinon tief (faible). En plus, score de 0 à 1.
comparables.countintegerNombre d’annonces similaires qui étayent la valeur, au moins 3.
comparables.closenessenumeng (étroit) : toutes proches de la voiture. weit (large) : le cercle a dû être élargi.
comparables.levelenumconfiguration : même carburant et même boîte. model : tout le modèle.
marketobjectSeulement avec include : activeListings voitures actuellement en vente, medianDaysOnline durée médiane en ligne, en jours.
notesstring[]Remarques en allemand, par exemple sur une déduction pour accident.
attributionobjectTexte et lien qui doivent figurer à côté de la valeur.
dataAsOfstringDate 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.

Réponse 404
{
  "error": {
    "code": "unknown_make",
    "message": "Die Marke «Ferari» kennen wir nicht.",
    "suggestions": [
      "Ferrari"
    ]
  }
}
Réponse 422
{
  "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.

Tapez ce que vous cherchez : une fonction, une question ou un code d’erreur.

↑ ↓ sélectionner↵ ouvrirEsc fermer