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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-avtoelon-uz-api-b8fb0afe/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-avtoelon-uz-api-b8fb0afe/get_hot_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-avtoelon-uz-api-b8fb0afe/list_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-avtoelon-uz-api-b8fb0afe/list_models_by_brand \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-avtoelon-uz-api-b8fb0afe/list_regions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-avtoelon-uz-api-b8fb0afe/search_car_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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>"}'
```