# Eng Auto24 — 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 thousands of vehicles from Latvia's largest auto marketplace, filtering by make, type, year, price, fuel type, and transmission to find exactly what you're looking for. Access comprehensive vehicle details including specifications, equipment lists, images, and pricing information for any listing.

**Category:** Automotive | **Website:** [eng.auto24.lv/](https://eng.auto24.lv/) | **Docs:** [parse.bot/marketplace/99d1b768-c7c0-4035-b97b-f95fd66cfcc8/eng-auto24-lv-api](https://parse.bot/marketplace/99d1b768-c7c0-4035-b97b-f95fd66cfcc8/eng-auto24-lv-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-eng-auto24-lv-api-99d1b768/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_vehicle_details

Get full details for a specific vehicle listing by its ID. Returns comprehensive specifications including type, bodytype, engine, fuel, mileage, transmission, drive, color, price, equipment list, images, and description when available. The vehicle_id is obtained from search_vehicles results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vehicle_id` | string | Yes | Numeric vehicle listing ID from search_vehicles results (e.g. 4342663). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-eng-auto24-lv-api-99d1b768/get_vehicle_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vehicle_id":"<string>"}'
```

### search_vehicles

Search and list vehicles for sale on auto24.lv with optional filters and pagination. Returns 50 vehicles per page sorted by the chosen order. Promoted ads may appear at the top regardless of sort order. The total count and page count reflect the filtered result set.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fuel` | string | No | Fuel type code. Values observed: 1=petrol, 2=diesel, 3=LPG, 5=electric, 6=hybrid. Passed to the upstream filter. |
| `make` | string | No | Numeric make ID to filter by brand. Examples: 4 (BMW), 2 (Audi), 7 (Ford), 14 (Fiat), 34 (Hyundai). Obtain IDs from the site's make dropdown or from returned vehicle data. |
| `page` | integer | No | Page number (1-indexed). Each page returns up to 50 vehicles. |
| `price_from` | string | No | Minimum price in EUR (e.g. 5000). |
| `price_to` | string | No | Maximum price in EUR (e.g. 20000). |
| `sort` | string | No | Sort order for results. Omitting defaults to newest first. |
| `transmission` | string | No | Transmission type code. Values observed: 1=manual, 2=automatic. Passed to the upstream filter. |
| `vehicle_type` | string | No | Vehicle type code. 100=all types, 101=passenger car, 102=SUV, 103=commercial vehicle, 104=bus, 107=truck, 108=trailer, 109=mototechnics, 110=water vehicle, 113=caravan and autocaravan, 120=racing vehicle, 111=special technics. Omitting defaults to all types (100). |
| `year_from` | string | No | Minimum year filter (e.g. 2015). |
| `year_to` | string | No | Maximum year filter (e.g. 2023). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-eng-auto24-lv-api-99d1b768/search_vehicles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fuel":"<string>","make":"<string>","page":"<integer>","price_from":"<string>","price_to":"<string>","sort":"<string>","transmission":"<string>","vehicle_type":"<string>","year_from":"<string>","year_to":"<string>"}'
```