autotrader.ca APIautotrader.ca ↗
Access AutoTrader.ca vehicle listings and detailed specs via API. Search by make, location, and price. Retrieve seller info, images, and full specifications.
curl -X GET 'https://api.parse.bot/scraper/e23e86fa-16cc-4777-bba6-3b98d9af5a2c/search_listings?make=Honda&sort=3&limit=5&offset=0&location=Toronto%2C+ON' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for vehicle listings on AutoTrader.ca with filters for make, location, and pagination. Returns structured listing data extracted from the site's search results page.
| Param | Type | Description |
|---|---|---|
| make | string | Filter by vehicle make (e.g. Honda, Toyota, Ford, Mercedes-Benz). Omitting returns all makes. |
| sort | integer | Sort order: 3 = Price High to Low, 4 = Price Low to High |
| limit | integer | Number of results per page |
| offset | integer | Result offset for pagination |
| location | string | Location for the search in City, Province format (e.g. Toronto, ON) |
{
"type": "object",
"fields": {
"listings": "array of vehicle listing objects with id, make, model, year, price, mileage, condition, city, province, transmission, fuel, url, and seller_name",
"total_found": "integer total number of matching results"
},
"sample": {
"data": {
"listings": [
{
"id": "69770029",
"url": "https://www.autotrader.ca/offers/honda-civic-lx-hb-gasoline-grey-81eb07ee-8602-4051-a5ec-749afae8ea9c",
"city": "REGINA",
"fuel": "Gasoline",
"make": "Honda",
"year": 2020,
"model": "Civic",
"price": "$ 22,995",
"mileage": "77,312 km",
"province": "SK",
"condition": "Used",
"seller_name": "Capital Ford Lincoln SK",
"transmission": "Automatic"
}
],
"total_found": 21990
},
"status": "success"
}
}About the autotrader.ca API
The AutoTrader.ca API provides access to Canadian vehicle listings through 2 endpoints, returning over 15 structured fields per listing. Use search_listings to query inventory across makes and locations with price sorting and pagination, then call get_listing_details with any listing URL to retrieve full specifications, seller contact information, images, and pricing data for a specific vehicle.
Search Listings
The search_listings endpoint queries AutoTrader.ca inventory and returns an array of listing objects alongside a total_found integer. Each listing includes id, make, model, year, price, mileage, condition, city, province, transmission, fuel, and a url for further lookup. The make parameter filters by manufacturer (e.g. Honda, Mercedes-Benz). The location parameter accepts a City, Province string such as Toronto, ON. Use the sort parameter to order results by price (3 = high to low, 4 = low to high), and control pagination with limit and offset.
Listing Details
The get_listing_details endpoint accepts a full AutoTrader.ca listing URL — obtainable from any search_listings result's url field — and returns the complete record for that vehicle. Response fields include make, model, year, variant (trim level), price (formatted string), price_raw (integer), images (array of URLs), description (HTML string), seller (object with name, type, phone, and city), and a specifications object covering mileage, body_type, transmission, drive_train, cylinders, displacement, body_color, number_of_doors, and number_of_seats.
Coverage and Pagination
Listings reflect the Canadian AutoTrader.ca marketplace. Location filtering is tied to the City, Province format and does not accept postal codes or coordinates. Pagination is handled through offset and limit against the total_found count, making it straightforward to iterate through large result sets for a given make or region.
- Build a cross-Canada price comparison tool filtering by make and province using
search_listingsresults - Monitor average asking prices for a specific make/model over time using
price_rawfrom search results - Aggregate seller inventory by querying
seller.nameandseller.typefields fromget_listing_details - Populate a vehicle research app with full specs including
drive_train,cylinders, anddisplacement - Generate alerts when new listings appear for a target make/location combination using
total_foundandoffsetpagination - Compare mileage-to-price ratios across listings using
mileageandprice_rawfields from search results
| 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.ca offer an official developer API?+
What does `get_listing_details` return beyond what `search_listings` provides?+
get_listing_details returns fields not present in search results: images (an array of photo URLs), seller contact details including phone, variant (trim level), description (the full HTML listing description), and granular specifications such as drive_train, cylinders, displacement, body_color, number_of_doors, and number_of_seats.Can I filter search results by price range, body type, or year?+
search_listings supports filtering by make and location, with sorting by price. Filters for price range, body type, year, or mileage are not exposed as parameters. You can fork this API on Parse and revise it to add those filter parameters.Does the API cover dealer inventory separately from private seller listings?+
seller.type field returned by get_listing_details indicates whether a listing is from a dealer or a private seller, but search_listings does not currently accept a seller type as a filter parameter. You can fork this API on Parse and revise it to add a seller-type filter to the search endpoint.How fresh is the listing data, and can I detect when a listing is sold or removed?+
get_listing_details no longer exists on the site, it will not return data. You can fork this API on Parse and revise it to add a status-check or history endpoint.