Autotrader

Search Autotrader vehicle listings

Searches Autotrader for new and used car listings, returning vehicle summaries (make, model, trim, year, mileage, pricing, images) plus the total matching count.

get/autotrader/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/autotrader/search
  • Auth: API key in header x-api-key

Query parameters

querystring

Free-text keyword search

zipstring

5-digit US ZIP code to search around

radiusinteger

Search radius in miles around zip

makestring

Autotrader make code, e.g. TOYOTA, HONDA, BMW

modelstring

Autotrader model code, e.g. CAMRY. Requires make

trimstring

Autotrader trim code. Requires make and model

condition'new' | 'used' | 'certified' | '3p_cert'

Listing condition. Allowed values: new, used, certified, 3p_cert

body_style'convertible' | 'coupe' | 'hatchback' | 'sedan' | 'suv' | 'truck' | 'van' | 'wagon'

Body style. Allowed values: convertible, coupe, hatchback, sedan, suv, truck, van, wagon

seller_type'dealer' | 'private'

Seller type. Allowed values: dealer, private

min_yearinteger

Minimum model year

max_yearinteger

Maximum model year

min_priceinteger

Minimum price in US dollars

max_priceinteger

Maximum price in US dollars

max_mileageinteger

Maximum odometer mileage

pageinteger

1-indexed result page, defaults to 1. Autotrader returns 24 results per page

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "page": 1,
    "page_size": 24,
    "stats": {
      "derived_price": {
        "average": 34521.5,
        "max": 89995,
        "min": 1500
      },
      "end_year": 2026,
      "max_price": 89995,
      "min_price": 1500,
      "start_year": 1960,
      "year": {
        "average": 34521.5,
        "max": 89995,
        "min": 1500
      }
    },
    "total_count": 3392288,
    "vehicles": [
      {
        "body_styles": [
          {
            "code": "SEDAN",
            "name": "Sedan"
          }
        ],
        "color": {
          "exterior_color": "Ocean Blue Metallic",
          "exterior_color_simple": "BLUE",
          "interior_color": "Sandstone With Ebony",
          "interior_color_simple": "BEIGE"
        },
        "days_on_site": 252,
        "drive_type": {
          "description": "All wheel drive",
          "name": "AWD4WD"
        },
        "engine": {
          "code": "4CLDR",
          "name": "4-Cylinder Turbo"
        },
        "fuel_type": {
          "code": "G",
          "group": "Gas",
          "name": "Gasoline"
        },
        "id": 754822172,
        "images": [
          {
            "height": 768,
            "url": "https://images.autotrader.com/hn/c/fea7bff2bfac481fbca3f5fa4d09a2d5.jpg",
            "width": 1024
          }
        ],
        "listing_type": "NEW",
        "make": {
          "code": "TOYOTA",
          "name": "Toyota"
        },
        "mileage": {
          "label": "Mileage",
          "value": "1,111"
        },
        "model": {
          "code": "CAMRY",
          "name": "Camry"
        },
        "mpg_city": 20,
        "mpg_highway": 25,
        "owner_id": 64141623,
        "packages": [
          "Power Package",
          "LPO Floor Liner Package"
        ],
        "pricing": {
          "dealer_discounted_price": 46985,
          "display_price": 45235,
          "msrp": 53055,
          "no_price_label": "Contact Dealer For Price",
          "sale_price": 45235
        },
        "stock_id": "TJ113378",
        "title": "New 2026 Buick Enclave Preferred w/ Power Package",
        "title_long": "New 2026 Buick Enclave Preferred w/ Power Package San Marcos TX 78666",
        "transmission": {
          "code": "AUT",
          "description": "8-Speed Automatic",
          "group": "Automatic",
          "name": "Automatic"
        },
        "trim": {
          "code": "CAMRY|LE",
          "name": "LE"
        },
        "url": "https://www.autotrader.com/cars-for-sale/vehicle/754822172",
        "vehicle_history_flags": [
          "NO_SALVAGE_TITLE",
          "NO_ACCIDENTS_REPORTED"
        ],
        "vin": "5GAEVAKS4TJ113378",
        "year": 2026
      }
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.