Market intelligence
Precomputed price snapshots for a brand, model, and year window.
Cars.bg Bulgarian retail market snapshot.
Requires the market scope.
Parameters
brand / makestring · query stringrequiredBrand name.
Example BMW·Where the value comes from /api/brands -> brands[].name
modelstring · query stringrequiredModel name.
Example 320d·Where the value comes from /api/models?brand=bmw -> models[].name
yearinteger · query stringrequiredCentre registration year.
Example 2019·Where the value comes from Centre year chosen by your application.
flexinteger · query stringYear tolerance from 0 to 10. Default 1.
Example 2·Where the value comes from Tolerance chosen by your application.
Example requests
GET https://api.thecarapi.com/api/cars-bg-market?brand=BMW&model=320d&year=2019GET https://api.thecarapi.com/api/cars-bg-market?make=Audi&model=A4&year=2020&flex=2Example response
{
"success": true,
"snapshot": {
"brand": "BMW",
"model": "320d",
"year": 2019,
"sample_size": 42,
"avg_price_eur": 23100,
"min_price_eur": 17900,
"max_price_eur": 29500
}
}Auction-market price snapshot for the same brand, model, and year window.
Requires the market scope.
Parameters
brand / makestring · query stringrequiredBrand name.
Example BMW·Where the value comes from /api/brands -> brands[].name
modelstring · query stringrequiredModel name.
Example 320d·Where the value comes from /api/models?brand=bmw -> models[].name
yearinteger · query stringrequiredCentre registration year.
Example 2019·Where the value comes from Centre year chosen by your application.
flexinteger · query stringYear tolerance from 0 to 10. Default 1.
Example 2·Where the value comes from Tolerance chosen by your application.
scopeenum · query stringDefault all.
Example active·Where the value comes from Choose all, active, or inactive.
Example requests
GET https://api.thecarapi.com/api/auction-market?brand=BMW&model=320d&year=2019&scope=activeGET https://api.thecarapi.com/api/auction-market?brand=Kia&model=EV6&year=2023&flex=1Example response
{
"success": true,
"snapshot": {
"brand": "BMW",
"model": "320d",
"year": 2019,
"scope": "active",
"sample_size": 118,
"avg_price_eur": 18400
}
}