Endpoint Playground

Try the Autotrader vehicle listing search API

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

Request: GET /autotrader/search
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 91.8%, median 2.33 s
Monitored request: GET /autotrader/search?make=TOYOTA&model=CAMRY&radius=50&zip=78701

Autotrader vehicle listing search API documentation Autotrader platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/autotrader/search?condition=new&body_style=convertible&seller_type=dealer' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	No		Free-text keyword search
zip	string	No		5-digit US ZIP code to search around
radius	integer	No		Search radius in miles around zip
make	string	No		Autotrader make code, e.g. TOYOTA, HONDA, BMW
model	string	No		Autotrader model code, e.g. CAMRY. Requires make
trim	string	No		Autotrader trim code. Requires make and model
condition	string	No	new	Listing condition. Allowed values: new, used, certified, 3p_cert
body_style	string	No	convertible	Body style. Allowed values: convertible, coupe, hatchback, sedan, suv, truck, van, wagon
seller_type	string	No	dealer	Seller type. Allowed values: dealer, private
min_year	integer	No		Minimum model year
max_year	integer	No		Maximum model year
min_price	integer	No		Minimum price in US dollars
max_price	integer	No		Maximum price in US dollars
max_mileage	integer	No		Maximum odometer mileage
page	integer	No		1-indexed result page, defaults to 1. Autotrader returns 24 results per page

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total_count": 3392288,
    "page": 1,
    "page_size": 24,
    "vehicles": [
      {
        "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"
        },
        "body_styles": [
          {
            "code": "SUV",
            "name": "Sport Utility"
          }
        ],
        "mileage": {
          "label": "Mileage",
          "value": "1,111"
        },
        "color": {
          "exterior_color": "Ocean Blue Metallic",
          "exterior_color_simple": "BLUE"
        },
        "transmission": {
          "code": "AUT",
          "name": "Automatic",
          "description": "8-Speed Automatic"
        },
        "fuel_type": {
          "code": "G",
          "name": "Gasoline",
          "group": "Gas"
        },
        "listing_type": "NEW",
        "days_on_site": 252,
        "pricing": {
          "sale_price": 45235,
          "msrp": 53055,
          "display_price": 45235
        },
        "url": "https://www.autotrader.com/cars-for-sale/vehicle/754822172"
      }
    ],
    "stats": {
      "derived_price": {
        "max": 289995,
        "average": 34521.5,
        "min": 1500
      },
      "year": {
        "max": 2026,
        "average": 2018.3,
        "min": 1960
      },
      "start_year": 1960,
      "end_year": 2026,
      "min_price": 1500,
      "max_price": 289995
    },
    "source_url": "https://www.autotrader.com/cars-for-sale/all-cars"
  }
}

More Autotrader endpoints

Get Autotrader dealer profile Get Autotrader vehicle listing detail

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestautotrader.searchResponseDocAutotrader

GET /autotrader/search

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.

Response behavior

- `total_count` reflects Autotrader's full matching-result count for the applied filters, not just `len(vehicles)`. - An invalid `condition`, `body_style`, or `seller_type` value returns `400` before any upstream request is made. - A search with no matching listings returns `200` with `"vehicles": []` and `total_count: 0`, not an error. - `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. - `stats` reports price and model-year aggregates (min/average/max) across the FULL matching result set for the applied filters, not just the returned page — useful for market-research callers who want the shape of the whole matching inventory. It is omitted when Autotrader's page does not carry this aggregate for the request.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total_count": 3392288,
    "page": 1,
    "page_size": 24,
    "vehicles": [
      {
        "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"
        },
        "body_styles": [
          {
            "code": "SUV",
            "name": "Sport Utility"
          }
        ],
        "mileage": {
          "label": "Mileage",
          "value": "1,111"
        },
        "color": {
          "exterior_color": "Ocean Blue Metallic",
          "exterior_color_simple": "BLUE"
        },
        "transmission": {
          "code": "AUT",
          "name": "Automatic",
          "description": "8-Speed Automatic"
        },
        "fuel_type": {
          "code": "G",
          "name": "Gasoline",
          "group": "Gas"
        },
        "listing_type": "NEW",
        "days_on_site": 252,
        "pricing": {
          "sale_price": 45235,
          "msrp": 53055,
          "display_price": 45235
        },
        "url": "https://www.autotrader.com/cars-for-sale/vehicle/754822172"
      }
    ],
    "stats": {
      "derived_price": {
        "max": 289995,
        "average": 34521.5,
        "min": 1500
      },
      "year": {
        "max": 2026,
        "average": 2018.3,
        "min": 1960
      },
      "start_year": 1960,
      "end_year": 2026,
      "min_price": 1500,
      "max_price": 289995
    },
    "source_url": "https://www.autotrader.com/cars-for-sale/all-cars"
  }
}

Try the Autotrader vehicle listing search API

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

Request: GET /autotrader/search
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 91.8%, median 2.33 s
Monitored request: GET /autotrader/search?make=TOYOTA&model=CAMRY&radius=50&zip=78701

Autotrader vehicle listing search API documentation Autotrader platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/autotrader/search?condition=new&body_style=convertible&seller_type=dealer' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
query	string	No		Free-text keyword search
zip	string	No		5-digit US ZIP code to search around
radius	integer	No		Search radius in miles around zip
make	string	No		Autotrader make code, e.g. TOYOTA, HONDA, BMW
model	string	No		Autotrader model code, e.g. CAMRY. Requires make
trim	string	No		Autotrader trim code. Requires make and model
condition	string	No	new	Listing condition. Allowed values: new, used, certified, 3p_cert
body_style	string	No	convertible	Body style. Allowed values: convertible, coupe, hatchback, sedan, suv, truck, van, wagon
seller_type	string	No	dealer	Seller type. Allowed values: dealer, private
min_year	integer	No		Minimum model year
max_year	integer	No		Maximum model year
min_price	integer	No		Minimum price in US dollars
max_price	integer	No		Maximum price in US dollars
max_mileage	integer	No		Maximum odometer mileage
page	integer	No		1-indexed result page, defaults to 1. Autotrader returns 24 results per page

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total_count": 3392288,
    "page": 1,
    "page_size": 24,
    "vehicles": [
      {
        "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"
        },
        "body_styles": [
          {
            "code": "SUV",
            "name": "Sport Utility"
          }
        ],
        "mileage": {
          "label": "Mileage",
          "value": "1,111"
        },
        "color": {
          "exterior_color": "Ocean Blue Metallic",
          "exterior_color_simple": "BLUE"
        },
        "transmission": {
          "code": "AUT",
          "name": "Automatic",
          "description": "8-Speed Automatic"
        },
        "fuel_type": {
          "code": "G",
          "name": "Gasoline",
          "group": "Gas"
        },
        "listing_type": "NEW",
        "days_on_site": 252,
        "pricing": {
          "sale_price": 45235,
          "msrp": 53055,
          "display_price": 45235
        },
        "url": "https://www.autotrader.com/cars-for-sale/vehicle/754822172"
      }
    ],
    "stats": {
      "derived_price": {
        "max": 289995,
        "average": 34521.5,
        "min": 1500
      },
      "year": {
        "max": 2026,
        "average": 2018.3,
        "min": 1960
      },
      "start_year": 1960,
      "end_year": 2026,
      "min_price": 1500,
      "max_price": 289995
    },
    "source_url": "https://www.autotrader.com/cars-for-sale/all-cars"
  }
}

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.

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "total_count": 3392288, "page": 1, "page_size": 24, "vehicles": [ { "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" }, "body_styles": [ { "code": "SUV", "name": "Sport Utility" } ], "mileage": { "label": "Mileage", "value": "1,111" }, "color": { "exterior_color": "Ocean Blue Metallic", "exterior_color_simple": "BLUE" }, "transmission": { "code": "AUT", "name": "Automatic", "description": "8-Speed Automatic" }, "fuel_type": { "code": "G", "name": "Gasoline", "group": "Gas" }, "listing_type": "NEW", "days_on_site": 252, "pricing": { "sale_price": 45235, "msrp": 53055, "display_price": 45235 }, "url": "https://www.autotrader.com/cars-for-sale/vehicle/754822172" } ], "stats": { "derived_price": { "max": 289995, "average": 34521.5, "min": 1500 }, "year": { "max": 2026, "average": 2018.3, "min": 1960 }, "start_year": 1960, "end_year": 2026, "min_price": 1500, "max_price": 289995 }, "source_url": "https://www.autotrader.com/cars-for-sale/all-cars" } }