# Exoticcartrader — 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 and browse exotic, collector, and classic car listings with detailed vehicle information including specs, VIN numbers, photos, and lot details. Discover featured vehicles by make or category, read expert reviews, and stay updated with industry blog posts all in one place.

**Category:** Automotive | **Website:** [exoticcartrader.com/](https://exoticcartrader.com/) | **Docs:** [parse.bot/marketplace/81470b31-8f30-4c29-a9dc-62893c08cf47/exoticcartrader-com-api](https://parse.bot/marketplace/81470b31-8f30-4c29-a9dc-62893c08cf47/exoticcartrader-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-exoticcartrader-com-api-81470b31/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_available_categories

Retrieve the list of available vehicle categories for filtering. Returns all categories from the site's inventory dropdown filter, sorted alphabetically.

**Estimated cost:** Metered

_No parameters required._

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

### get_available_makes

Retrieve the list of available car makes for filtering listings. Returns all makes from the site's inventory dropdown filter, sorted alphabetically.

**Estimated cost:** Metered

_No parameters required._

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

### get_blog_posts

Retrieve recent blog posts and buyer guides from the blog page. Returns post titles, URLs, and optionally descriptions and categories.

**Estimated cost:** Metered

_No parameters required._

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

### get_featured_listings

Retrieve featured car listings from the homepage slider. Each featured listing includes a title derived from the slug, a category, full URL, and slug.

**Estimated cost:** Metered

_No parameters required._

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

### get_listing_by_lot_number

Retrieve full details for a specific car listing by its lot number. Looks up the listing URL from the site's listings sitemap, then returns the same detail format as get_listing_details. Works for both live and sold listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lot_number` | string | Yes | Car lot number (e.g. '260454990', '260353373'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-exoticcartrader-com-api-81470b31/get_listing_by_lot_number \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lot_number":"<string>"}'
```

### get_listing_details

Retrieve full details for a specific car listing including specs, VIN, price, highlights, and description. Uses the listing slug (from search results) to fetch the detail page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Listing slug from search results (e.g. '2015-ferrari-458-spider-260454990'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-exoticcartrader-com-api-81470b31/get_listing_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_listing_photos

Retrieve all high-resolution photo URLs for a listing by its lot number. Queries the media CDN across multiple year folders to locate the photo assets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lot_number` | string | Yes | Car lot number (e.g. '260454990'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-exoticcartrader-com-api-81470b31/get_listing_photos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lot_number":"<string>"}'
```

### get_listings_by_category

Retrieve car listings filtered by vehicle category. Fetches the first page of inventory and filters client-side by matching the category against listing category tags (case-insensitive). Use values from get_available_categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Vehicle category filter (e.g. 'Classic Car', 'Exotic Car', 'Muscle Car', 'Sports Car', 'Luxury Car'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-exoticcartrader-com-api-81470b31/get_listings_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### get_listings_by_make

Retrieve car listings filtered by make. Fetches the first page of inventory and filters client-side by matching the make name against listing titles (case-insensitive). May return empty if no listings for the given make are on the current page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | Yes | Car make name (e.g. 'Ferrari', 'Porsche', 'Lamborghini', 'Chevrolet'). |

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

### get_reviews

Retrieve customer reviews and testimonials from the reviews page. Each review includes reviewer name, text, rating (out of 5), and a tag indicating the type of transaction.

**Estimated cost:** Metered

_No parameters required._

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

### search_listings

Search for car listings on Exotic Car Trader. Returns the first page of results from the inventory, optionally filtered by a text query matching title or slug. Results are limited to listings visible on a single page (up to ~24). Pagination advances via the page parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword to filter by (matches against title and slug, e.g. 'Ferrari', 'Mustang'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-exoticcartrader-com-api-81470b31/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```