classifieds

Counted filter vocabulary for the classifieds feed

Precomputed by the nightly scrape and read back in ~10 ms, so it is warm as soon as the data changes and no request pays to compute it. Any dimension not yet precomputed is counted on demand and cached for an hour.

The default trim matters most for sources: there are ~680 origin portals, so the full list is useful as data but not as a picker. value_counts.sources tells you how many exist; limit=0 returns them all.

get/api/classifieds/facets

Request

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

Query parameters

limitinteger

Values returned per dimension. 0 returns all of them.

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 vocabulary.

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.

value_countsobject

How many distinct values each dimension really has.

totalsobject

Listing count and the price and year bounds. totals.total follows the same capping rule as the listings feed and carries its own total_capped.

Example response

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

Changes

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