---
title: "Search vehicle listings dataset"
method: GET
path: "/datasets/vehicle-listings/search"
tags: ["Datasets"]
---

# Search vehicle listings dataset

`GET /datasets/vehicle-listings/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/vehicle-listings/search`
- Auth: API key in header `x-api-key`

Searches the crawled used-vehicle listings index. source enum: `carmax`, `autotrader`, `carsdotcom`. CarMax's own national inventory is fully enumerable (re-crawled on a standing schedule); Autotrader/Cars.com coverage is a best-effort zip-code sweep, not exhaustive, and their rows approximate city/state from the searched area rather than the seller's exact location. seller_type enum: `retailer`, `dealer`, `private` (not populated for every row -- see the dataset markdown). Sort enum: `relevance`, `recently_updated`, `newly_listed`, `price_asc`, `price_desc`, `mileage_asc`, `mileage_desc`, `year_desc`, `year_asc`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

## Query parameters

- `q` string
- `source` 'carmax' | 'autotrader' | 'carsdotcom'
- `make` string
- `model` string
- `trim` string
- `body_style` string
- `transmission` string
- `drive_type` string
- `fuel_type` string
- `seller_type` 'retailer' | 'dealer' | 'private'
- `state` string
- `vin` string
- `run_id` string
- `is_price_reduced` boolean
- `min_year` integer
- `max_year` integer
- `min_price` number
- `max_price` number
- `max_mileage` integer
- `sort` 'relevance' | 'recently_updated' | 'newly_listed' | 'price_asc' | 'price_desc' | 'mileage_asc' | 'mileage_desc' | 'year_desc' | 'year_asc'
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsVehicleListingsSearchResponseDoc
  - `code` integer
  - `data` DatasetsVehicleListingSearchResponse
    - `dataset` string
    - `items` EsVehicleListingRecord[]
      - `accident_count` integer: AccidentCount/OwnerCount come from a source's vehicle-history detail (CarMax's own /vehicle/{stock_number} History block as of 2026-08-20; reserved for other sources with an equivalent field). Pointers, not plain ints: 0 is a real, safety-relevant claim ("confirmed zero accidents") distinct from "we haven't enriched this listing yet". Populated only for a bounded number of newly-discovered listings per crawl pass, not backfilled for the whole catalog at once.
      - `body_style` string
      - `city` string
      - `crawled_at` string
      - `drive_type` string
      - `engine` string
      - `exterior_color` string
      - `first_seen_at` string: FirstSeenAt/LastSeenAt are our own crawl-observed dates, not upstream fields -- see the type doc comment. Both are RFC3339.
      - `fuel_type` string
      - `id` string
      - `image_url` string
      - `interior_color` string
      - `is_price_reduced` boolean
      - `last_seen_at` string
      - `latitude` number
      - `longitude` number
      - `make` string
      - `mileage` integer
      - `model` string
      - `owner_count` integer
      - `previous_price` number
      - `price` number
      - `run_id` string
      - `schema_version` integer
      - `seller_name` string
      - `seller_type` string: SellerType is "retailer" for CarMax (its own inventory, not a dealer network) and reserved "dealer"/"private" values for future sources that aggregate third-party sellers (Autotrader, Cars.com).
      - `source` string
      - `source_listing_id` string
      - `state` string
      - `transmission` string
      - `trim` string
      - `url` string
      - `vin` string
      - `year` integer
    - `page` integer
    - `page_size` integer
    - `sort` string
    - `total` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)