# AutoScout24 Italy — 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 for used and new cars across AutoScout24 Italy's inventory, view detailed listing information, and browse dealer profiles. Filter vehicles by make and model to find exactly what you're looking for in the Italian automotive market.

**Category:** Automotive | **Website:** [autoscout24.it/](https://autoscout24.it/) | **Docs:** [parse.bot/marketplace/c5a0e8e5-0db9-483d-a5b5-bf47566e93a0/autoscout24-it-api](https://parse.bot/marketplace/c5a0e8e5-0db9-483d-a5b5-bf47566e93a0/autoscout24-it-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-it-api-c5a0e8e5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_dealer_profile

Get detailed dealer profile including business name, contact info, customer ratings and reviews, opening hours, services, and about info. The slug is the bare dealer identifier without path prefix, typically found in listing detail seller links.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Bare dealer slug (e.g., 'rossi-auto-srl', 'bianchi-motors-milano-mi'). If provided with a '/concessionari/' prefix, the prefix is automatically stripped. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autoscout24-it-api-c5a0e8e5/get_dealer_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_listing_detail

Get full details for a specific vehicle listing including pricing, vehicle specs, equipment, seller info, ratings, and images. The slug is obtained from search_listings results. Stale or expired slugs return an input_not_found error.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The listing slug from search_listings results (e.g., '/annunci/fiat-500-1-2-benzina-rosso-abc12345-...'). Must be a currently active listing. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autoscout24-it-api-c5a0e8e5/get_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_makes_list

Get a list of all car makes (brands) available on the platform. Returns make labels and their numeric IDs for use as the make parameter in search_listings and make_id in get_models_by_make.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autoscout24-it-api-c5a0e8e5/get_makes_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_models_by_make

Get available models for a specific car make. At least one of make_id or make_name must be provided. Returns model names and IDs for use as the model parameter in search_listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make_id` | string | No | Numeric make ID as string (e.g., '28' for Fiat, '9' for Audi). Obtained from get_makes_list endpoint. |
| `make_name` | string | No | Full name of the make (e.g., 'Fiat', 'Audi'). Case-sensitive, must match the label from get_makes_list. |

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

### search_listings

Search for car listings with various filters including make, model, price, year, fuel type, and transmission. Returns paginated results up to 200 pages. Filters are ANDed; some combinations may return empty results. Each listing summary includes basic vehicle info, price, location, and dealer name. Use the slug field to fetch full details via get_listing_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `body_type` | string | No | Vehicle body type code (e.g., 'Berlina', 'SUV/Fuoristrada'). |
| `condition` | string | No | Vehicle condition filter. |
| `fuel_type` | string | No | Fuel type code (e.g., 'Benzina', 'Diesel', 'Elettrica', 'Elettrica/Benzina'). |
| `make` | string | No | Make ID as a numeric string (e.g., '9' for Audi, '28' for Fiat). Obtain IDs from get_makes_list endpoint. |
| `model` | string | No | Model ID as a numeric string (e.g., '1746' for Panda). Obtain IDs from get_models_by_make endpoint. |
| `page` | integer | No | Page number, maximum 200. |
| `price_from` | integer | No | Minimum price in EUR. |
| `price_to` | integer | No | Maximum price in EUR. |
| `sort` | string | No | Sort order for results. |
| `transmission` | string | No | Transmission type. |
| `vehicle_type` | string | No | Vehicle type. |
| `year_from` | integer | No | Minimum registration year (e.g., 2020). |
| `year_to` | integer | No | Maximum registration year (e.g., 2026). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-autoscout24-it-api-c5a0e8e5/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body_type":"<string>","condition":"<string>","fuel_type":"<string>","make":"<string>","model":"<string>","page":"<integer>","price_from":"<integer>","price_to":"<integer>","sort":"<string>","transmission":"<string>","vehicle_type":"<string>","year_from":"<integer>","year_to":"<integer>"}'
```