# Avtoelon — 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 car listings across Uzbekistan with detailed information on Chevrolet and other brands, filtering by region and model to find the best deals. Access comprehensive reference data on available car brands, models, and locations, plus discover hot deals currently trending on the marketplace.

**Category:** Automotive | **Website:** [avtoelon.uz/](https://avtoelon.uz/) | **Docs:** [parse.bot/marketplace/b8fb0afe-7a93-4c6c-9428-c34f19aaa9b2/avtoelon-uz-api](https://parse.bot/marketplace/b8fb0afe-7a93-4c6c-9428-c34f19aaa9b2/avtoelon-uz-api)

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/avtoelon/`
**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 hot deals

Get featured 'hot deal' car advertisements from the homepage. Returns promoted listings currently displayed on avtoelon.uz, including title, price, year, location, and thumbnail.

**Estimated cost:** Metered

_No parameters required._

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

### List brands

Get all available car brands from the avtoelon.uz search form. Returns brand ID, alias (URL slug), and display name for each brand. Use brand aliases as input to search_car_listings and brand IDs as input to list_models_by_brand.

**Estimated cost:** Metered

_No parameters required._

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

### List models by brand

Get car models for a specific brand by its numeric ID. Returns model ID, name, alias, production year range, and popularity score. Use brand IDs from list_brands endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand_id` | string | Yes | The numeric ID of the brand (e.g. '19' for Chevrolet, '11' for BMW). Obtained from the list_brands endpoint. |

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

### List regions

Get all searchable regions/oblasts in Uzbekistan with their IDs and aliases. Use region aliases as input to search_car_listings.

**Estimated cost:** Metered

_No parameters required._

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

### Search car listings

Search for car listings by brand and optional filters. Returns promoted/featured car advertisements visible on the brand page, including title, price, year, location, and thumbnail. Paginates via page number. Filters include brand, model, region, year range, and price range.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | No | Car brand alias (e.g., 'chevrolet', 'bmw', 'byd'). Use alias values from list_brands endpoint. |
| `model` | string | No | Car model alias (e.g., 'cobalt', 'gentra'). Use alias values from list_models_by_brand endpoint. |
| `page` | integer | No | Page number for pagination. |
| `price_currency` | integer | No | Currency for price filter: 1 for Sum, 2 for USD. |
| `price_max` | integer | No | Maximum price. |
| `price_min` | integer | No | Minimum price. |
| `region` | string | No | Region alias (e.g., 'tashkentskaya-oblast', 'samarkandskaya-oblast'). Use alias values from list_regions endpoint. |
| `year_from` | integer | No | Minimum year of manufacture. |
| `year_to` | integer | No | Maximum year of manufacture. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/avtoelon/search-car-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>","model":"<string>","page":"<integer>","price_currency":"<integer>","price_max":"<integer>","price_min":"<integer>","region":"<string>","year_from":"<integer>","year_to":"<integer>"}'
```

## Next steps

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