---
title: "Search Cars.com vehicle listings"
method: GET
path: "/carsdotcom/search"
tags: ["Cars.com"]
---

# Search Cars.com vehicle listings

`GET /carsdotcom/search`

## Request

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

Searches Cars.com for new and used car listings, returning vehicle summaries (make, model, trim, year, mileage, exterior color, drivetrain, fuel type, pricing, seller, images) plus the total matching count.

## Query parameters

- `zip` string
- `radius` integer
- `stock_type` 'new' | 'used' | 'cpo' | 'all'
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- CarsdotcomSearchResponseDoc
  - `code` integer
  - `data` CarsdotcomSearchResponse
    - `page` integer
    - `page_size` integer
    - `source_url` string
    - `total_count` integer
    - `vehicles` CarsdotcomVehicle[]
      - `body_style` string
      - `drivetrain` string
      - `exterior_color` string
      - `fuel_type` string
      - `images` string[]
      - `is_cpo` boolean
      - `listing_id` string
      - `make` string
      - `mileage` integer
      - `model` string
      - `msrp` number
      - `price` number
      - `seller` CarsdotcomSeller
        - `dealer_name` string
        - `zip` string
      - `stock_type` string
      - `trim` string
      - `url` 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/028417aa35bb?raw)