# Edmunds — 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 new and used car inventory on Edmunds by make, model, year, condition, and location. Retrieve detailed specs, pricing, history, and dealer info by VIN, and browse all available car makes.

**Category:** Automotive | **Website:** [edmunds.com/](https://edmunds.com/) | **Docs:** [parse.bot/marketplace/6d4b8554-8e2c-451c-8323-047069e787b9/edmunds-com-api](https://parse.bot/marketplace/6d4b8554-8e2c-451c-8323-047069e787b9/edmunds-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-edmunds-com-api-6d4b8554/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_makes

Retrieves the full list of car makes available in Edmunds used car inventory. Each make includes a display name and a URL-friendly slug (niceName). The list includes both current and discontinued brands (69 total). No pagination or filtering — returns all makes in a single response.

**Estimated cost:** Metered

_No parameters required._

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

### get_vehicle_details

Get detailed information for a specific vehicle listing by its VIN. Returns pricing, specs, vehicle history, and dealer information. Searches across used, new, and CPO inventory. Returns input_not_found if the VIN is not currently listed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vin` | string | Yes | 17-character Vehicle Identification Number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-edmunds-com-api-6d4b8554/get_vehicle_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vin":"<string>"}'
```

### search_inventory

Search for used or new car inventory on Edmunds based on make, model, year, condition, and location. Returns up to 21 listings per request. Each listing includes VIN, pricing, mileage, vehicle specs, dealer info, deal rating, and vehicle history. Results are sorted by Edmunds boost algorithm by default.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `condition` | string | No | Vehicle condition: used or new. |
| `make` | string | No | Car make niceName slug (e.g. honda, toyota, bmw). Use values from get_makes endpoint. |
| `model` | string | No | Car model niceName slug (e.g. civic, camry, 3-series). |
| `year` | string | No | Model year (e.g. 2020, 2021). |
| `zip` | string | No | 5-digit US ZIP code for location-based search. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-edmunds-com-api-6d4b8554/search_inventory \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"condition":"<string>","make":"<string>","model":"<string>","year":"<string>","zip":"<string>"}'
```