Catalogue: the API’s makes and models
The catalogue lists all the makes and models the API can value. It suits drop-down lists in your software and follows the Swiss market: what is often listed here is in the catalogue.
curl https://prisradar.ch/api/v1/catalog/makes/audi/models \ -H "Authorization: Bearer $PRISRADAR_KEY"
{
"make": {
"id": "AUDI",
"name": "Audi"
},
"models": [
{
"id": "A3",
"name": "A3"
},
{
"id": "Q5",
"name": "Q5"
},
{
"id": "Q5 SPORTBACK",
"name": "Q5 Sportback"
}
]
}How do I get all makes?
With GET /v1/catalog/makes. The response is a list with the id and name of each make. name is the spelling for display, id the catalogue’s own. For a valuation you may send either, or a spelling of your own; the API will still find the make.
GEThttps://prisradar.ch/api/v1/catalog/makes
How do I get the models of a make?
With GET /v1/catalog/makes/{make}/models, for example …/makes/audi/models. The response names the make and its models, each with id and name. If the catalogue does not know the make, you get 404 unknown_make with suggestions for similar names. You can use either directly for a valuation.
GEThttps://prisradar.ch/api/v1/catalog/makes/{make}/models
How up to date is the catalogue?
The catalogue follows the market and is recalculated regularly. When a new model appears often enough in Swiss listings, it shows up in the catalogue; when a rare model disappears from the market, it may drop out. So reload the lists regularly instead of storing them for good.
Didn’t find what you’re looking for?Write to info@prisradar.ch or use the contact form.