# Autotrader (South Africa) — 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 access comprehensive vehicle listings from South Africa's AutoTrader with pricing, specifications, location details, and seller information. Get everything you need to compare cars and make informed purchasing decisions, though direct seller phone numbers aren't available due to security protections.

**Category:** Automotive | **Website:** [autotrader.co.za/](https://autotrader.co.za/) | **Docs:** [parse.bot/marketplace/be5f494b-853c-40aa-8072-c9cee9664386/autotrader-co-za-api](https://parse.bot/marketplace/be5f494b-853c-40aa-8072-c9cee9664386/autotrader-co-za-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-co-za-api-be5f494b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### details

Get detailed information for a specific vehicle listing by its full URL. Returns pricing, specifications, location, and seller information. The listing must exist on autotrader.co.za; deleted or expired listings return input_not_found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The full URL of the vehicle listing on autotrader.co.za (e.g. 'https://www.autotrader.co.za/car-for-sale/bmw/5-series/520d/28225122'). |

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

### search

Search for vehicle listings by make and optionally model. Returns a list of detailed listing information including price, specifications, location, and seller details. Each listing requires a separate page fetch, so larger limits take longer. Paginates by page number; results are ordered by the site's default relevance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of listings to return from the current page. |
| `make` | string | Yes | The vehicle make or make/model path (e.g. 'bmw', 'mitsubishi/pajero', 'toyota/hilux'). |
| `page` | integer | No | The page number of search results to fetch. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autotrader-co-za-api-be5f494b/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","make":"<string>","page":"<integer>"}'
```