# Automoto — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-automoto-ua-api-d9b05286/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-automoto-ua-api-d9b05286/get_dealerships \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-automoto-ua-api-d9b05286/get_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-automoto-ua-api-d9b05286/get_listing_statistics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-automoto-ua-api-d9b05286/get_makes_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-automoto-ua-api-d9b05286/get_models_by_make \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-automoto-ua-api-d9b05286/get_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-automoto-ua-api-d9b05286/get_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-automoto-ua-api-d9b05286/get_seller_contacts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-automoto-ua-api-d9b05286/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>","page":"<integer>"}'
```