# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/autotrader/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/autotrader/get-all-makes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/autotrader/get-models-for-make \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/autotrader/get-vehicle-listing-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/autotrader/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.