Autotrader API endpoint
Returns an Autotrader vehicle listing: full vehicle spec (make, model, trim, mileage, colors, transmission, fuel type, engine, images, pricing), the full listing description, and seller detail (dealership or private seller).
/autotrader/vehicle/{id}Returns an Autotrader vehicle listing: the full vehicle spec (make, model, trim, mileage, colors, transmission, fuel type, drivetrain, engine, images, pricing, listed packages, vehicle history flags), the full listing description, seller detail — a dealership (name, phone, address, rating, website) or, when dealer.is_private_seller is true, a private individual seller — and a short list of similar listings Autotrader itself surfaces on the same page.
Path parameters:
id (required) — the Autotrader listing id, the numeric path segment of
a /cars-for-sale/vehicle/{id} URL (e.g. 754822172 for
https://www.autotrader.com/cars-for-sale/vehicle/754822172).Notable response behavior:
id must be numeric; a non-numeric value returns 400 before any
upstream request is made.404, not an empty 200.dealer is omitted when Autotrader's page does not carry a resolvable
seller record for the listing (parser drift or an incomplete listing).pricing.no_price_label (e.g. "Contact Dealer For Price") is set
instead of a numeric price when the dealer requires direct contact for
pricing.similar_listings is a list of vehicle summaries (the same shape as a search result, not full detail) for other listings Autotrader surfaces as similar on the same page. It is omitted when Autotrader's page does not carry a similar-listings shelf for this vehicle.| Field | In the sample | Value in the sample |
|---|---|---|
| id | Has a value | |
| vin | Has a value | |
| year | Has a value | 2,026 |
| make.code | Has a value | |
| make.name | Has a value | “Toyota” |
| model.code | Has a value | |
| model.name | Has a value | “Camry” |
| trim.code | Has a value | |
| trim.name | Has a value | “XLE” |
| mileage.label | Has a value | “Mileage” |
| mileage.value | Has a value | “7,240” |
| color.exterior_color | Has a value | “Heavy Metal” |
| color.exterior_color_simple | Has a value | “GRAY” |
| color.interior_color | Has a value | “Black” |
| color.interior_color_simple | Has a value | “BLACK” |
| transmission.code | Has a value | |
| transmission.name | Has a value | “Automatic” |
| transmission.description | Has a value | “Continuously Variable Automatic” |
| transmission.group | Has a value | “Automatic” |
| fuel_type.code | Has a value | |
| fuel_type.name | Has a value | “Hybrid Gas/Electric” |
| fuel_type.group | Has a value | “Hybrid: Gas/Electric” |
| drive_type.name | Has a value | “FWD” |
| drive_type.description | Has a value | “2 wheel drive - front” |
| engine.code | Has a value | |
| engine.name | Has a value | “Hybrid” |
| listing_type | Has a value | “Used” |
| days_on_site | Has a value | 58 |
| stock_id | Has a value | |
| images | Has a value | 24 entries |
| pricing.sale_price | Has a value | 34,723 |
| pricing.display_price | Has a value | 34,948 |
| pricing.no_price_label | Has a value | “Contact Dealer For Price” |
| vehicle_history_flags | Has a value | 3 entries |
| url | Has a value | autotrader.com |
| description | Has a value | 2,436 characters |
| dealer.id | Has a value | |
| dealer.name | Has a value | “Covert Chrysler Dodge Jeep Ram” |
| dealer.phone | Has a value | 5,127,659,405 |
| dealer.website | Has a value | covertchryslerdodgejeepram.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Autotrader listing id, the numeric path segment of a /cars-for-sale/vehicle/{id} URL | 754822172 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/autotrader/vehicle/754822172" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": 754822172,
"vin": "5GAEVAKS4TJ113378",
"title": "New 2026 Buick Enclave Preferred w/ Power Package",
"year": 2026,
"make": {
"code": "BUICK",
"name": "Buick"
},
"model": {
"code": "ENCLAVE",
"name": "Enclave"
},
"trim": {
"code": "ENCLAVE|Preferred",
"name": "Preferred"
},
"mileage": {
"label": "Mileage",
"value": "1,111"
},
"color": {
"exterior_color": "Ocean Blue Metallic",
"exterior_color_simple": "BLUE",
"interior_color": "Sandstone With Ebony"
},
"transmission": {
"code": "AUT",
"name": "Automatic",
"description": "8-Speed Automatic"
},
"fuel_type": {
"code": "G",
"name": "Gasoline",
"group": "Gas"
},
"drive_type": {
"name": "AWD4WD",
"description": "All wheel drive"
},
"engine": {
"code": "4CLDR",
"name": "4-Cylinder Turbo"
},
"mpg_city": 20,
"mpg_highway": 25,
"listing_type": "NEW",
"stock_id": "TJ113378",
"packages": [
"Power Package",
"LPO, Floor Liner Package"
],
"vehicle_history_flags": [
"NO_SALVAGE_TITLE",
"NO_ACCIDENTS_REPORTED"
],
"pricing": {
"sale_price": 45235,
"msrp": 53055,
"dealer_discounted_price": 46985,
"display_price": 45235
},
"description": "This 2026 Buick Enclave Preferred in Ocean Blue Metallic comes with the following features: ...",
"dealer": {
"id": 64141623,
"name": "Chuck Nash Chevrolet Buick GMC",
"phone": "7373444772",
"address1": "3209 N I 35",
"city": "San Marcos",
"state": "TX",
"zip": "78666",
"rating": 4.7,
"rating_count": 4332,
"is_private_seller": false
},
"url": "https://www.autotrader.com/cars-for-sale/vehicle/754822172",
"similar_listings": [
{
"id": 754822999,
"title": "New 2026 Buick Enclave Essence",
"year": 2026,
"make": {
"code": "BUICK",
"name": "Buick"
},
"model": {
"code": "ENCLAVE",
"name": "Enclave"
},
"pricing": {
"sale_price": 47995,
"msrp": 55000,
"display_price": 47995
},
"url": "https://www.autotrader.com/cars-for-sale/vehicle/754822999"
}
],
"source_url": "https://www.autotrader.com/cars-for-sale/vehicle/754822172"
}
}Request schema
No body schema
Response schema
#/definitions/autotrader.VehicleResponse
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| body_styles | array | No | ||||
| body_styles[].code | string | No | SEDAN | |||
| body_styles[].name | string | No | Sedan | |||
| color | autotrader.Color | No | ||||
| color.exterior_color | string | No | Ocean Blue Metallic | |||
| color.exterior_color_simple | string | No | BLUE | |||
| color.interior_color | string | No | Sandstone With Ebony | |||
| color.interior_color_simple | string | No | BEIGE | |||
| days_on_site | integer | No | 252 | |||
| dealer | autotrader.Dealer | No | ||||
| dealer.address1 | string | No | 3209 N I 35 | |||
| dealer.city | string | No | San Marcos | |||
| dealer.id | integer | No | 64141623 | |||
| dealer.is_private_seller | boolean | No | ||||
| dealer.is_virtual | boolean | No | ||||
| dealer.latitude | number | No | 29.936132 | |||
| dealer.longitude | number | No | -97.886856 | |||
| dealer.name | string | No | Chuck Nash Chevrolet Buick GMC | |||
| dealer.phone | string | No | 7373444772 | |||
| dealer.rating | number | No | 4.7 | |||
| dealer.rating_count | integer | No | 4332 | |||
| dealer.state | string | No | TX | |||
| dealer.url | string | No | https://www.autotrader.com/car-dealers/san-marcos-tx/64141623/chuck-nash-chevrolet-buick-gmc | |||
| dealer.website | string | No | ||||
| dealer.zip | string | No | 78666 | |||
| description | string | No | ||||
| drive_type | autotrader.DriveType | No | ||||
| drive_type.description | string | No | All wheel drive | |||
| drive_type.name | string | No | AWD4WD | |||
| engine | autotrader.Engine | No | ||||
| engine.code | string | No | 4CLDR | |||
| engine.name | string | No | 4-Cylinder Turbo | |||
| fuel_type | autotrader.FuelType | No | ||||
| fuel_type.code | string | No | G | |||
| fuel_type.group | string | No | Gas | |||
| fuel_type.name | string | No | Gasoline | |||
| id | integer | No | 754822172 | |||
| images | array | No | ||||
| images[].alt | string | No | ||||
| images[].height | integer | No | 768 | |||
| images[].url | string | No | https://images.autotrader.com/hn/c/fea7bff2bfac481fbca3f5fa4d09a2d5.jpg | |||
| images[].width | integer | No | 1024 | |||
| is_hot | boolean | No | ||||
| is_newly_listed | boolean | No | ||||
| is_reduced_price | boolean | No | ||||
| listing_type | string | No | NEW | |||
| make | autotrader.Make | No | ||||
| make.code | string | No | TOYOTA | |||
| make.name | string | No | Toyota | |||
| mileage | autotrader.Mileage | No | ||||
| mileage.label | string | No | Mileage | |||
| mileage.value | string | No | 1,111 | |||
| model | autotrader.Model | No | ||||
| model.code | string | No | CAMRY | |||
| model.name | string | No | Camry | |||
| mpg_city | integer | No | 20 | |||
| mpg_highway | integer | No | 25 | |||
| owner_id | integer | No | 64141623 | |||
| packages | array | No | Power Package,LPO Floor Liner Package | |||
| pricing | autotrader.Pricing | No | ||||
| pricing.dealer_discounted_price | number | No | 46985 | |||
| pricing.display_price | number | No | 45235 | |||
| pricing.msrp | number | No | 53055 | |||
| pricing.no_price_label | string | No | Contact Dealer For Price | |||
| pricing.sale_price | number | No | 45235 | |||
| similar_listings | array | No | ||||
| similar_listings[].body_styles | array | No | ||||
| similar_listings[].body_styles[].code | string | No | SEDAN | |||
| similar_listings[].body_styles[].name | string | No | Sedan | |||
| similar_listings[].color | autotrader.Color | No | ||||
| similar_listings[].color.exterior_color | string | No | Ocean Blue Metallic | |||
| similar_listings[].color.exterior_color_simple | string | No | BLUE | |||
| similar_listings[].color.interior_color | string | No | Sandstone With Ebony | |||
| similar_listings[].color.interior_color_simple | string | No | BEIGE | |||
| similar_listings[].days_on_site | integer | No | 252 | |||
| similar_listings[].drive_type | autotrader.DriveType | No | ||||
| similar_listings[].drive_type.description | string | No | All wheel drive | |||
| similar_listings[].drive_type.name | string | No | AWD4WD | |||
| similar_listings[].engine | autotrader.Engine | No | ||||
| similar_listings[].engine.code | string | No | 4CLDR | |||
| similar_listings[].engine.name | string | No | 4-Cylinder Turbo | |||
| similar_listings[].fuel_type | autotrader.FuelType | No | ||||
| similar_listings[].fuel_type.code | string | No | G | |||
| similar_listings[].fuel_type.group | string | No | Gas | |||
| similar_listings[].fuel_type.name | string | No | Gasoline | |||
| similar_listings[].id | integer | No | 754822172 | |||
| similar_listings[].images | array | No | ||||
| similar_listings[].images[].alt | string | No | ||||
| similar_listings[].images[].height | integer | No | 768 | |||
| similar_listings[].images[].url | string | No | https://images.autotrader.com/hn/c/fea7bff2bfac481fbca3f5fa4d09a2d5.jpg | |||
| similar_listings[].images[].width | integer | No | 1024 | |||
| similar_listings[].is_hot | boolean | No | ||||
| similar_listings[].is_newly_listed | boolean | No | ||||
| similar_listings[].is_reduced_price | boolean | No | ||||
| similar_listings[].listing_type | string | No | NEW | |||
| similar_listings[].make | autotrader.Make | No | ||||
| similar_listings[].make.code | string | No | TOYOTA | |||
| similar_listings[].make.name | string | No | Toyota | |||
| similar_listings[].mileage | autotrader.Mileage | No | ||||
| similar_listings[].mileage.label | string | No | Mileage | |||
| similar_listings[].mileage.value | string | No | 1,111 | |||
| similar_listings[].model | autotrader.Model | No | ||||
| similar_listings[].model.code | string | No | CAMRY | |||
| similar_listings[].model.name | string | No | Camry | |||
| similar_listings[].mpg_city | integer | No | 20 | |||
| similar_listings[].mpg_highway | integer | No | 25 | |||
| similar_listings[].owner_id | integer | No | 64141623 | |||
| similar_listings[].packages | array | No | Power Package,LPO Floor Liner Package | |||
| similar_listings[].pricing | autotrader.Pricing | No | ||||
| similar_listings[].pricing.dealer_discounted_price | number | No | 46985 | |||
| similar_listings[].pricing.display_price | number | No | 45235 | |||
| similar_listings[].pricing.msrp | number | No | 53055 | |||
| similar_listings[].pricing.no_price_label | string | No | Contact Dealer For Price | |||
| similar_listings[].pricing.sale_price | number | No | 45235 | |||
| similar_listings[].stock_id | string | No | TJ113378 | |||
| similar_listings[].title | string | No | New 2026 Buick Enclave Preferred w/ Power Package | |||
| similar_listings[].title_long | string | No | New 2026 Buick Enclave Preferred w/ Power Package San Marcos TX 78666 | |||
| similar_listings[].transmission | autotrader.Transmission | No | Transmission record, 4 fields: code, description, group, name. Described under Autotrader dealer profile API. | |||
| similar_listings[].trim | autotrader.Trim | No | ||||
| similar_listings[].trim.code | string | No | CAMRY|LE | |||
| similar_listings[].trim.name | string | No | LE | |||
| similar_listings[].url | string | No | https://www.autotrader.com/cars-for-sale/vehicle/754822172 | |||
| similar_listings[].vehicle_history_flags | array | No | NO_SALVAGE_TITLE,NO_ACCIDENTS_REPORTED | |||
| similar_listings[].vin | string | No | 5GAEVAKS4TJ113378 | |||
| similar_listings[].year | integer | No | 2026 | |||
| source_url | string | No | ||||
| stock_id | string | No | TJ113378 | |||
| title | string | No | New 2026 Buick Enclave Preferred w/ Power Package | |||
| title_long | string | No | New 2026 Buick Enclave Preferred w/ Power Package San Marcos TX 78666 | |||
| transmission | autotrader.Transmission | No | ||||
| transmission.code | string | No | AUT | |||
| transmission.description | string | No | 8-Speed Automatic | |||
| transmission.group | string | No | Automatic | |||
| transmission.name | string | No | Automatic | |||
| trim | autotrader.Trim | No | ||||
| trim.code | string | No | CAMRY|LE | |||
| trim.name | string | No | LE | |||
| url | string | No | https://www.autotrader.com/cars-for-sale/vehicle/754822172 | |||
| vehicle_history_flags | array | No | NO_SALVAGE_TITLE,NO_ACCIDENTS_REPORTED | |||
| vin | string | No | 5GAEVAKS4TJ113378 | |||
| year | integer | No | 2026 |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/autotrader/vehicle/754822172" \
-H "x-api-key: $CRAWLORA_API_KEY"