autotrader.com APIautotrader.com ↗
Search Autotrader vehicle listings by make, model, ZIP, price, and more. Access specs, VIN, pricing, dealer info, and KBB fair purchase data via 4 endpoints.
curl -X GET 'https://api.parse.bot/scraper/39cfc061-a8fd-42e7-af55-7a6b8c8bc7a3/search_listings?zip=90001&make=TOYOTA&limit=3&model=Camry&zip_code=90210&listing_type=used' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for vehicle listings with comprehensive filters. Returns paginated results with listing details, available filter options, and total count.
| Param | Type | Description |
|---|---|---|
| zip | string | ZIP code for location-based search (5-digit US ZIP). |
| make | string | Vehicle make code (e.g., TOYOTA, FORD, BMW). Use get_all_makes to retrieve valid codes. |
| limit | integer | Number of results per page. |
| model | string | Vehicle model code (e.g., CAMRY, F150PICKUP). Use get_models_for_make to retrieve valid codes for a given make. |
| offset | integer | Pagination offset (first record index). |
| radius | integer | Search radius in miles from the ZIP code. |
| sort_by | string | Sort order: relevance, priceASC, priceDESC, mileageASC, yearDESC. |
| end_year | integer | Filter by maximum model year. |
| dealer_id | string | Filter by specific dealer/owner ID. |
| fuel_type | string | Fuel type group code: DSL (Diesel), ELE (Electric), GSL (Gasoline), HYB (Hybrid), PIH (Plug-in Hybrid). |
| max_price | integer | Maximum price filter. |
| min_price | integer | Minimum price filter. |
| body_style | string | Body style code: CONVERT, COUPE, HATCH, SEDAN, SUVCROSS, TRUCKS, VANS, WAGON. |
| start_year | integer | Filter by minimum model year. |
| seller_type | string | Seller type: d (Dealer), p (Private Seller). |
| listing_type | string | Listing type: NEW, USED, CERTIFIED. |
{
"type": "object",
"fields": {
"filters": "object containing available filter options with counts for refining searches",
"listings": "array of vehicle listing objects with id, title, year, make, model, vin, pricingDetail, specifications, images, owner, mileage",
"total_count": "integer total number of matching results"
},
"sample": {
"data": {
"filters": {
"listingType": {
"options": [
{
"count": 91577,
"label": "New",
"value": "NEW"
}
]
}
},
"listings": [
{
"id": 780065560,
"vin": "WMWMF735X9TT96012",
"make": {
"code": "MINI",
"name": "MINI"
},
"year": 2009,
"model": {
"code": "COOPER",
"name": "Cooper"
},
"title": "Used 2009 MINI Cooper S",
"mileage": {
"label": "Mileage",
"value": "173,000"
},
"pricingDetail": {
"salePrice": 3499,
"dealIndicator": "Great"
}
}
],
"total_count": 149172
},
"status": "success"
}
}About the autotrader.com API
The Autotrader API exposes 4 endpoints for querying vehicle listings, retrieving full listing details, and resolving make and model reference codes. The search_listings endpoint supports filtering by ZIP code, radius, make, model, year range, and sort order, returning paginated results with pricing, mileage, images, and dealer information. Reference endpoints keep your make and model codes in sync with what Autotrader actually supports.
Search and Filter Listings
The search_listings endpoint is the primary query surface. Pass a zip and radius to scope results geographically, then narrow by make, model, end_year, and sort order (relevance, priceASC, priceDESC, mileageASC, yearDESC). Results include an array of listing objects — each with id, title, year, make, model, vin, mileage, pricingDetail, specifications, images, and owner — plus a total_count integer and a filters object showing available filter options with counts for further refinement. Use limit and offset for pagination.
Full Listing Detail
Once you have a listing id from search results, get_vehicle_listing_detail returns the complete record for that vehicle. The pricingDetail object includes salePrice, a deal indicator, and KBB fair purchase price data. The specifications object covers transmission, exterior color, fuel type, MPG, engine, drive type, and odometer mileage. The owner object contains dealer or private seller details and their location. The images object provides a primary index and a full sources array.
Make and Model Reference Data
get_all_makes returns the full list of vehicle makes available on Autotrader as label/value pairs, where value is the code expected by other endpoints (e.g., TOYOTA, BMW). get_models_for_make takes a make code and returns all corresponding models in the same label/value format, with value usable as the model parameter in search_listings. These endpoints keep client code aligned with Autotrader's current inventory taxonomy without hardcoding codes.
- Build a used car price tracker that monitors
salePriceand KBB fair purchase price across specific make/model/year combinations over time. - Aggregate dealer inventory by querying
search_listingswith a ZIP and radius, then grouping results by theownerlocation field. - Identify deals by comparing
salePriceagainst thedealIndicatorand KBB fair purchase price returned inpricingDetail. - Generate a vehicle lookup tool that uses
get_all_makesandget_models_for_maketo populate cascading dropdowns and then queriessearch_listings. - Compile a dataset of VINs and specifications for a given model by iterating paginated
search_listingsresults and expanding each viaget_vehicle_listing_detail. - Analyze regional price variation by running
search_listingswith the samemake/modelagainst multiple ZIP codes and comparing returned prices.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Autotrader offer an official developer API?+
What does the `filters` object in `search_listings` contain?+
filters object returns available filter options and their result counts for the current query. This lets you build dynamic filter UIs — showing users how many listings exist for each sub-category — without making additional requests.Does the API return private-party (non-dealer) listings?+
owner field on each listing includes seller details and distinguishes dealer from private-party sellers, so results can include both. The API does not expose a dedicated filter parameter to restrict results strictly to private-party or dealer-only listings at query time. You can fork the API on Parse and revise it to add that filtering parameter if needed.Is there a way to look up a vehicle by VIN rather than by listing ID?+
id via get_vehicle_listing_detail, and VIN is returned as a field on each listing. Direct VIN-based search is not a supported input parameter. You can fork the API on Parse and revise it to add a VIN search endpoint.Are there any geographic limitations on the search?+
zip parameter expects a 5-digit US ZIP code, and the radius parameter is in miles. The API covers US listings on Autotrader.com. Canadian or international Autotrader properties are not covered by these endpoints.