# Autoscout24 — 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 millions of car listings on AutoScout24 and filter results by make, model, price, mileage, and other vehicle specifications. Explore vehicle taxonomy and aggregated data to discover market trends and compare automotive options across Europe's largest car marketplace.

**Category:** Automotive | **Website:** [autoscout24.com/](https://autoscout24.com/) | **Docs:** [parse.bot/marketplace/e22ce824-487b-4c4c-b4b0-bba1efbe9786/autoscout24-com-api](https://parse.bot/marketplace/e22ce824-487b-4c4c-b4b0-bba1efbe9786/autoscout24-com-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-autoscout24-com-api-e22ce824/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_aggregations

Get unique car makes or models using the AutoScout24 taxonomy API. Use mode='makes' to list all available makes, or mode='models' with a make_id to list models for a specific make. The make_id is obtained from a prior get_aggregations call with mode='makes' (items[*].id).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make_id` | string | No | Numeric make ID (required when mode='models'). Obtain from get_aggregations with mode='makes' in items[*].id. |
| `mode` | string | No | Aggregation mode: makes or models. Defaults to 'models' if make_id is provided, otherwise 'makes'. |
| `vehicle_type` | string | No | Vehicle type |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autoscout24-com-api-e22ce824/get_aggregations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make_id":"<string>","mode":"<string>","vehicle_type":"<string>"}'
```

### search_listings

Search for car listings on AutoScout24 with filters for make, model, price range, year, fuel type, transmission, and country. Returns paginated results with listing details including price, mileage, seller contact, and location. Pagination is manual via page/max_pages params; each page returns up to page_size results. The total_results in metadata reflects the full result set on the server.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | ISO-2 country code or comma-separated codes (e.g., DE or DE,IT,FR). Supported: AT, BE, DE, ES, FR, IT, LU, NL |
| `exclude_damaged` | boolean | No | Exclude damaged listings |
| `fuel_type` | string | No | Fuel type code |
| `include_raw` | boolean | No | Include raw JSON data from the site in each listing |
| `make` | string | No | Car make (e.g., Volkswagen, BMW, Audi, Mercedes-Benz) |
| `max_pages` | integer | No | Maximum number of pages to scan |
| `model` | string | No | Car model (e.g., Golf, 3-series, A4) |
| `page` | integer | No | Start page number |
| `page_size` | integer | No | Number of results per page (max 20) |
| `price_from` | string | No | Minimum price in EUR |
| `price_to` | string | No | Maximum price in EUR |
| `sort_by` | string | No | Sort order for results |
| `transmission` | string | No | Transmission type code |
| `year_from` | string | No | Minimum year of first registration (e.g., 2018) |
| `year_to` | string | No | Maximum year of first registration (e.g., 2025) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autoscout24-com-api-e22ce824/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","exclude_damaged":"<boolean>","fuel_type":"<string>","include_raw":"<boolean>","make":"<string>","max_pages":"<integer>","model":"<string>","page":"<integer>","page_size":"<integer>","price_from":"<string>","price_to":"<string>","sort_by":"<string>","transmission":"<string>","year_from":"<string>","year_to":"<string>"}'
```