Premiers pas avec l’API Prisradar
L’API Prisradar renvoie pour une voiture la valeur du marché en francs, avec la fourchette, la fiabilité et le nombre d’annonces comparables. Elle fonctionne avec tout langage de programmation capable d’envoyer une requête HTTPS.
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"
}'{
"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"
}Comment obtenir ma première estimation ?
En quatre étapes : créer un compte, obtenir une clé de test dans la console, envoyer la première requête à /v1/valuations et lire la réponse. Avec la clé de test, cela ne coûte rien. Dès que votre logiciel fonctionne, vous choisissez et payez un forfait dans la console et créez une clé live qui donne des valeurs réelles.
POSThttps://prisradar.ch/api/v1/valuations
- 1Créer un compteSous Créer un compte, avec entreprise, nom, e-mail et mot de passe. Vous confirmez l’e-mail d’un clic ; vous pouvez ensuite activer la connexion par code.
- 2Obtenir une clé de testDans la console, sous « Clés ». Les clés de test commencent par pr_test_ et donnent des valeurs d’exemple fixes.
- 3Envoyer la requêteJoindre la clé dans l’en-tête Authorization: Bearer … et envoyer la voiture en JSON.
- 4Lire la réponsevalue.chf est la valeur du marché, low et high la fourchette, confidence.level la fiabilité.
Quelles indications faut-il pour une estimation ?
Six indications sont obligatoires : marque, modèle, année de première immatriculation, kilométrage, carburant et boîte de vitesses. Puissance, traction, carrosserie, vendeur et état sont facultatifs et rendent la valeur plus précise. Vous pouvez écrire la marque et le modèle comme votre logiciel les connaît ; l’API trouve l’orthographe dans le catalogue.
Tous les champs figurent sous Estimation. La description lisible par machine de toute l’API est disponible sous forme de fichier OpenAPI. Pour en savoir plus sur le format : openapis.org.
Dans quel format l’API répond-elle ?
L’API répond en JSON, encodé en UTF-8. Les montants sont en francs entiers TVA comprise, arrondis à la centaine, par exemple 34600. Les kilomètres sont des nombres entiers, les heures suivent la norme ISO 8601 en UTC. Les noms de champs sont en anglais, les messages et remarques en allemand, pour être affichés tels quels.
Uniquement depuis le serveur.Interrogez l’API depuis votre serveur, jamais directement depuis une app ou un site web. Sinon, votre clé est visible pour tout le monde. Placez-la dans une variable d’environnement, jamais en dur dans le code.
Que ne fait pas l’API ?
L’API n’estime pas à partir du numéro de châssis ou de la réception par type, car il faudrait pour cela des données sous licence. Elle ne connaît pas l’équipement en détail ; la valeur vaut pour une voiture à l’équipement moyen. Elle ne fournit ni annonces, ni photos, ni données de vendeurs, et les voitures de plus de 25 ans n’obtiennent pas de valeur.
Des prix demandés, pas des prix de vente.La valeur repose sur des annonces suisses actuelles. Personne ne sait à quel prix une voiture a finalement été vendue.
Vous n’avez pas trouvé ce que vous cherchez ?Écrivez à info@prisradar.ch ou via le formulaire de contact.