market

Cars.bg retail market snapshot

A precomputed price snapshot for a brand/model/year window on the Bulgarian retail market. Cycle prices, never live-refreshed.

get/api/cars-bg-market

Request

  • Base URL: https://api.thecarapi.com
  • URL: https://api.thecarapi.com/api/cars-bg-market
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer
    • API key in query parameter api_key

Query parameters

brandstring
Example:BMW

Required, unless given as make.

makestring
Example:BMW

Alias for brand.

modelstring required
Example:320d
yearinteger required
Example:2019

Centre year of the window.

flexinteger

Year tolerance either side of year.

Headers

If-None-Matchstring
Example:W/"6f1c0a9d8e"

Echo back the ETag from your last response for this URL. An unchanged page answers 304 Not Modified with no body. ETags are weak, so the tag stays valid whether or not the body came back compressed.

Response

The snapshot.

successboolean required
contract_versionstring

Matches info.version of this document.

request_idstring

Also returned as the X-Request-ID header.

server_timestring date-time

UTC ISO-8601 timestamp of the response.

data_updated_atstring date-time

Route-supplied data timestamp, falling back to server_time. Not a guaranteed source refresh time; inspect listing observation timestamps and live_price.fetched_at where available.

snapshotobject

Price aggregates for the window.

Example response

{
  "success": true,
  "contract_version": "2026-09-03"
}

Changes

No recorded changes to this operation across all 1 revision of this API.