---
title: "Search Autotrader vehicle listings"
method: GET
path: "/autotrader/search"
tags: ["Autotrader"]
---

# Search Autotrader vehicle listings

`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`

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

## Query parameters

- `query` string
- `zip` string
- `radius` integer
- `make` string
- `model` string
- `trim` string
- `condition` 'new' | 'used' | 'certified' | '3p_cert'
- `body_style` 'convertible' | 'coupe' | 'hatchback' | 'sedan' | 'suv' | 'truck' | 'van' | 'wagon'
- `seller_type` 'dealer' | 'private'
- `min_year` integer
- `max_year` integer
- `min_price` integer
- `max_price` integer
- `max_mileage` integer
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- AutotraderSearchResponseDoc
  - `code` integer
  - `data` AutotraderSearchResponse
    - `page` integer
    - `page_size` integer
    - `source_url` string
    - `stats` AutotraderSearchStats
      - `derived_price` AutotraderStatRange
        - `average` number
        - `max` number
        - `min` number
      - `end_year` integer
      - `max_price` number
      - `min_price` number
      - `start_year` integer
      - `year` AutotraderStatRange
        - `average` number
        - `max` number
        - `min` number
    - `total_count` integer
    - `vehicles` AutotraderVehicle[]
      - `body_styles` AutotraderBodyStyle[]
        - `code` string
        - `name` string
      - `color` AutotraderColor
        - `exterior_color` string
        - `exterior_color_simple` string
        - `interior_color` string
        - `interior_color_simple` string
      - `days_on_site` integer
      - `drive_type` AutotraderDriveType
        - `description` string
        - `name` string
      - `engine` AutotraderEngine
        - `code` string
        - `name` string
      - `fuel_type` AutotraderFuelType
        - `code` string
        - `group` string
        - `name` string
      - `id` integer
      - `images` AutotraderImage[]
        - `alt` string
        - `height` integer
        - `url` string
        - `width` integer
      - `is_hot` boolean
      - `is_newly_listed` boolean
      - `is_reduced_price` boolean
      - `listing_type` string
      - `make` AutotraderMake
        - `code` string
        - `name` string
      - `mileage` AutotraderMileage
        - `label` string
        - `value` string
      - `model` AutotraderModel
        - `code` string
        - `name` string
      - `mpg_city` integer
      - `mpg_highway` integer
      - `owner_id` integer
      - `packages` string[]
      - `pricing` AutotraderPricing
        - `dealer_discounted_price` number
        - `display_price` number
        - `msrp` number
        - `no_price_label` string
        - `sale_price` number
      - `stock_id` string
      - `title` string
      - `title_long` string
      - `transmission` AutotraderTransmission
        - `code` string
        - `description` string
        - `group` string
        - `name` string
      - `trim` AutotraderTrim
        - `code` string
        - `name` string
      - `url` string
      - `vehicle_history_flags` string[]
      - `vin` string
      - `year` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)