# Automoto — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 explore car listings across Ukraine's largest automotive marketplace, compare vehicle statistics and prices, discover dealerships and seller contacts, and read news and reviews to make informed buying decisions. Access detailed vehicle specifications, market trends, and seller information all in one place.

**Category:** Automotive | **Website:** [automoto.ua/](https://automoto.ua/) | **Docs:** [parse.bot/marketplace/d9b05286-a2d8-46f1-b948-5fc42bf0bfd6/automoto-ua-api](https://parse.bot/marketplace/d9b05286-a2d8-46f1-b948-5fc42bf0bfd6/automoto-ua-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/automoto/`
**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 dealerships

Retrieve car dealerships directory from automoto.ua. Returns dealership names, profile links, logos, and represented brands.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/automoto/get-dealerships \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get listing detail

Retrieve full details of a specific car listing including specs, images, and pricing. Either url or url_slug must be provided. Returns structured vehicle data parsed from the listing page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | No | Full URL of the listing page (e.g. 'https://automoto.ua/uk/BMW-5-Series-2016-Odessa-72075660.html'). |
| `url_slug` | string | No | URL slug path relative to the site (e.g. 'BMW-5-Series-2016-Odessa-72075660.html'). Used when url is not provided. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/automoto/get-listing-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>","url_slug":"<string>"}'
```

### Get listing statistics

Get site-wide listing statistics including total listings count, new listings per day, and total review count. Returns aggregate counters that update daily.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/automoto/get-listing-statistics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get makes list

Retrieve all available car makes/brands with listing counts. Returns the complete list of makes from the platform's search widget. Each make includes a slug usable as the make_id parameter in get_models_by_make.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/automoto/get-makes-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get models by make

Retrieve all models for a given car make with listing counts. Returns model names and slugs that can be used for filtering searches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make_id` | string | Yes | Make slug from get_makes_list (e.g. 'BMW', 'Toyota', 'Acura'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/automoto/get-models-by-make \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"make_id":"<string>"}'
```

### Get news

Retrieve latest automotive news articles from automoto.ua. Returns articles with title, publication date, thumbnail image, and link.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/automoto/get-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get reviews

Retrieve car owner reviews from automoto.ua. Returns review titles (typically make, model, year), publication dates, ratings, and links to full review pages.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/automoto/get-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get seller contacts

Retrieve seller contact information redirect link for a listing. Returns a URL that redirects to the partner site where full seller contact details are available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | Numeric listing ID (e.g. '72075660') from search_listings or get_listing_detail. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/automoto/get-seller-contacts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"<string>"}'
```

### Search listings

Search used car listings with optional make filter. Returns paginated results with listing summaries including price, specs, and location. Each page returns up to ~48 listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | No | Make slug to filter by (e.g. 'bmw', 'toyota'). Omitting returns all listings. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/automoto/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>","page":"<integer>"}'
```

## Next steps

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