# AutoTrader — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search Autotrader.com vehicle listings and access detailed information like pricing, specifications, and VIN data with flexible filtering options. Browse all available vehicle makes and models to refine your search across thousands of listings.

**Category:** Automotive | **Website:** [autotrader.com/](https://autotrader.com/) | **Docs:** [parse.bot/marketplace/d6aca67d-aed2-446e-b2f1-bbf25b4e07cd/autotrader-com-api](https://parse.bot/marketplace/d6aca67d-aed2-446e-b2f1-bbf25b4e07cd/autotrader-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-autotrader-com-api-d6aca67d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_makes

Retrieve a complete list of all vehicle makes available on Autotrader. Returns make codes (value) and display names (label) usable in search_listings and get_models_for_make.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autotrader-com-api-d6aca67d/get_all_makes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_models_for_make

Retrieve all available models for a specific vehicle make. Returns model codes (value) and display names (label) usable in the search_listings model parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | Yes | Vehicle make code (e.g., TOYOTA, FORD). Obtainable from get_all_makes. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autotrader-com-api-d6aca67d/get_models_for_make \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>"}'
```

### get_vehicle_listing_detail

Retrieve full details for a single vehicle listing by its numeric ID. Returns comprehensive vehicle data including specifications, pricing, images, owner/dealer info, and VIN. The listing ID is obtainable from search_listings results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | The unique numeric ID of the vehicle listing (from search_listings results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autotrader-com-api-d6aca67d/get_vehicle_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"<string>"}'
```

### search_listings

Search for vehicle listings with comprehensive filters. Returns listings with pricing, specifications, images, and seller info, plus available filter options and total count. Pagination is offset-based via the offset parameter. Each listing carries the same shape as get_vehicle_listing_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `body_style` | string | No | Filter by vehicle body style. |
| `dealer_id` | string | No | Filter by specific dealer/owner ID. |
| `end_year` | integer | No | Filter by maximum model year. |
| `fuel_type` | string | No | Filter by fuel type group. |
| `limit` | integer | No | Number of results per page (max records returned). |
| `listing_type` | string | No | Filter by listing condition type. |
| `make` | string | No | Vehicle make code (e.g., TOYOTA, FORD). Obtainable from get_all_makes. |
| `max_price` | integer | No | Maximum price filter in dollars. |
| `min_price` | integer | No | Minimum price filter in dollars. |
| `model` | string | No | Vehicle model code (e.g., CAMRY, RAV4). Obtainable from get_models_for_make for a given make. |
| `offset` | integer | No | Pagination offset (zero-based first record index). |
| `radius` | integer | No | Search radius in miles from the ZIP code. Common values: 10, 25, 50, 75, 100, 200, 500. |
| `seller_type` | string | No | Filter by seller type. |
| `sort_by` | string | No | Sort order for results. |
| `start_year` | integer | No | Filter by minimum model year. |
| `zip` | string | No | 5-digit US ZIP code for location-based search. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autotrader-com-api-d6aca67d/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body_style":"<string>","dealer_id":"<string>","end_year":"<integer>","fuel_type":"<string>","limit":"<integer>","listing_type":"<string>","make":"<string>","max_price":"<integer>","min_price":"<integer>","model":"<string>","offset":"<integer>","radius":"<integer>","seller_type":"<string>","sort_by":"<string>","start_year":"<integer>","zip":"<string>"}'
```