# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/eng-auto24/`
**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 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/credits/eng-auto24/get-vehicle-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/eng-auto24/search-vehicles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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>"}'
```

## 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.