Endpoint Playground
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). Dataset Playground requests query indexed data and do not apply proxy routing.
14 Oct 2026: 20 items; 29 fields had a value in every checked item and 2 varied between items.
Sample value profiles: first_seen_at: 2026-09-18 to 2026-10-13; year: 2,014 to 2,025, median 2,022; image_url: img2.carmax.com.
curl "https://api.crawlora.net/api/v1/datasets/vehicle-listings/search?source=carmax&seller_type=retailer&sort=relevance" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Full-text query over make, model and trim, max 256 characters | |
| source | string | No | carmax | Exact source marketplace filter: carmax, autotrader, carsdotcom |
| make | string | No | Exact make filter (e.g. Honda, Toyota), max 128 characters | |
| model | string | No | Exact model filter (e.g. Civic), max 128 characters | |
| trim | string | No | Exact trim filter, max 128 characters | |
| body_style | string | No | Exact body style filter (e.g. Sedan, SUV), max 128 characters | |
| transmission | string | No | Exact transmission filter, max 128 characters | |
| drive_type | string | No | Exact drivetrain filter, max 128 characters | |
| fuel_type | string | No | Exact fuel type filter (e.g. Gas, Hybrid, Electric), max 128 characters | |
| seller_type | string | No | retailer | Exact seller type filter: retailer, dealer, private |
| state | string | No | Exact US state abbreviation filter (e.g. CA), max 8 characters | |
| vin | string | No | Exact VIN filter. Best-effort: not guaranteed on every listing | |
| run_id | string | No | Exact crawl run-id filter, max 128 characters | |
| is_price_reduced | boolean | No | Filter for listings currently marked down from a previous price | |
| min_year | integer | No | Minimum model year | |
| max_year | integer | No | Maximum model year | |
| min_price | number | No | Minimum price in US dollars | |
| max_price | number | No | Maximum price in US dollars | |
| max_mileage | integer | No | Maximum odometer mileage | |
| sort | string | No | relevance | Sort enum: relevance, recently_updated, newly_listed, price_asc, price_desc, mileage_asc, mileage_desc, year_desc, year_asc |
| page | integer | No | Page number, defaults to 1 | |
| page_size | integer | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 |
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "vehicle-listings",
"items": [
{
"id": "carmax:28187774",
"source": "carmax",
"source_listing_id": "28187774",
"vin": "1FMJK1K89REA27006",
"year": 2024,
"make": "Ford",
"model": "Expedition Max",
"trim": "Limited",
"body_style": "4D Sport Utility",
"mileage": 41406,
"exterior_color": "Black",
"transmission": "Automatic",
"drive_type": "Rear Wheel Drive",
"fuel_type": "Gas",
"price": 45998,
"is_price_reduced": false,
"seller_type": "retailer",
"seller_name": "Canoga Park",
"city": "Los Angeles",
"state": "CA",
"url": "https://www.carmax.com/car/28187774",
"accident_count": 0,
"owner_count": 1,
"first_seen_at": "2026-08-20T00:00:00Z",
"last_seen_at": "2026-08-20T00:00:00Z",
"schema_version": 1
}
],
"page": 1,
"page_size": 20,
"total": 1,
"sort": "recently_updated"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.