Endpoint Playground
Returns CarMax's own similar-vehicle recommendations for a listing: stock number, description, display mileage/price, store location, and image, for vehicles CarMax considers comparable. An empty list is a normal result, not an error.
14 Oct 2026: 10 recommendations; 8 fields had a value in every checked item.
Sample value profiles: price_display: $15,998 (5), $16,998 (4), $18,998 (1); stock_number: 27,928,757 to 70,298,849, median 70,205,143; description: “2016 Honda Civic EX” and 9 other values.
curl 'https://api.crawlora.net/api/v1/carmax/vehicle/28187774/recommendations?store_id=7124' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| stock_number (path) | string | Yes | 28187774 | CarMax stock number to find similar vehicles for, the numeric path segment of a /car/{stock_number} URL |
| store_id | string | Yes | 7124 | CarMax store id used as the recommendation's location context. See any search/vehicle/store response's store id field |
{
"code": 200,
"msg": "OK",
"data": {
"stock_number": 28187774,
"recommendations": [
{
"stock_number": 70078825,
"description": "2022 Honda Civic Sport",
"mileage_display": "78K",
"price_display": "$22,998",
"location": "San Gabriel Valley/Duarte",
"vehicle_caption": "Only available at CarMax San Gabriel Valley/Duarte, CA",
"hero_image_url": "https://img2.carmax.com/assets/70078825/hero.jpg?width=400&height=225",
"url": "https://www.carmax.com/car/70078825"
}
],
"source_url": "https://mobileapps-afd-prod-endpoint-drgsgffchcfkbmg4.z01.azurefd.net/api/vehicles/recommendations?locationId=7124&stockNumber=28187774"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.