# AutoScout24 Scraper (`unfenced-group/autoscout24-scraper`) Actor
Scrape car listings from AutoScout24 across 8 European markets. Phone numbers, WLTP data, equipment lists, GPS coordinates. No proxy required.
- **URL**: https://apify.com/unfenced-group/autoscout24-scraper.md
- **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.79 / 1,000 results
This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## AutoScout24 Scraper
Extract structured car listings from AutoScout24 across 8 European markets — Germany, Netherlands, France, Italy, Spain, Austria, Belgium and Luxembourg. Filter by make, model, price, year, mileage, fuel type, body style and more. No API key required.
---
### Why this scraper?
#### 🌍 Eight markets in one run
Search across DE, NL, FR, IT, ES, AT, BE and LU simultaneously — or target a single country. Each listing includes the seller's country so you can segment downstream.
#### 🔎 Granular server-side filters
Make, model, price range, year range, mileage range, engine power (kW), fuel type, transmission, body style and condition are all applied server-side before pagination — no wasted requests.
#### 📋 Full detail enrichment
Enable `fetchDetailsEnabled` to unlock body type, colour, doors, seats, drive train, cylinders, upholstery, accident history, previous owners, CO₂ class, fuel consumption, electric range, equipment list (40+ items), VIN and GPS coordinates.
#### 🔁 Cross-run deduplication
A 90-day KVS cache tracks every listing ID. Re-runs flag reposts with `isRepost: true` and `originalScrapedAt`, so you only process genuinely new inventory.
#### 📄 Three description formats
Each listing's seller description is returned as raw HTML, plain text and Markdown — pick whichever format your downstream pipeline needs.
#### ⚡ Scalable — up to 4,000 results per search
AutoScout24's search index caps at 40 pages × 100 listings. This scraper saturates that limit in under 10 minutes on a single run.
---
### Input parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| `make` | string | _(any)_ | Car manufacturer slug, e.g. `volkswagen`, `bmw`, `mercedes-benz` |
| `model` | string | _(any)_ | Model slug, e.g. `golf`, `3-series`. Requires `make` to be set |
| `countries` | array | `["DE","NL","FR","IT","ES","AT","BE"]` | Markets to search. Supported: DE, NL, FR, IT, ES, AT, BE, LU |
| `condition` | select | `all` | `all`, `new`, or `used` |
| `bodyType` | select | _(any)_ | `suv`, `sedan`, `hatchback`, `sw`, `coupe`, `cabriolet`, `van`, `other` |
| `fuelType` | select | _(any)_ | `petrol`, `diesel`, `electric`, `hybrid`, `lpg`, `cng`, `hydrogen` |
| `transmission` | select | _(any)_ | `manual` or `automatic` |
| `priceFrom` | integer | `0` | Minimum price in EUR (0 = no limit) |
| `priceTo` | integer | `0` | Maximum price in EUR (0 = no limit) |
| `yearFrom` | integer | `0` | First registration year from, e.g. `2018` (0 = no limit) |
| `yearTo` | integer | `0` | First registration year to, e.g. `2024` (0 = no limit) |
| `mileageFrom` | integer | `0` | Minimum mileage in km (0 = no limit) |
| `mileageTo` | integer | `0` | Maximum mileage in km (0 = no limit) |
| `powerFrom` | integer | `0` | Minimum engine power in kW (0 = no limit) |
| `powerTo` | integer | `0` | Maximum engine power in kW (0 = no limit) |
| `sortBy` | select | `standard` | `standard`, `price`, `age` (newest first), `km` (lowest mileage first) |
| `sortOrder` | select | `0` | `0` = ascending, `1` = descending |
| `maxResults` | integer | `200` | Maximum listings to collect (cap: 4,000) |
| `fetchDetailsEnabled` | boolean | `false` | Visit each listing page for full specs, equipment list, VIN and GPS |
| `enableDedup` | boolean | `true` | Track known listings across runs with a 90-day KVS cache |
| `startUrls` | array | `[]` | Paste AutoScout24 search or listing URLs directly — overrides all filter fields above |
---
### Output schema
#### Always present
| Field | Type | Description |
|---|---|---|
| `id` | string | AutoScout24 listing UUID |
| `crossReferenceId` | string | Secondary cross-reference ID (null if absent) |
| `url` | string | Full listing URL |
| `make` | string | Manufacturer name, e.g. `Volkswagen` |
| `model` | string | Model name, e.g. `Golf` |
| `modelGroup` | string | Model group, e.g. `Golf` |
| `variant` | string | Variant label, e.g. `Standard Model` (null if absent) |
| `modelVersionInput` | string | Seller's free-text version description |
| `condition` | string | `new` or `used` |
| `priceEur` | integer | Listed price in EUR (null if price-on-request) |
| `priceFormatted` | string | Formatted price string, e.g. `€ 18,500` |
| `mileageKm` | integer | Odometer reading in km |
| `mileageFormatted` | string | Formatted mileage, e.g. `39,647 km` |
| `firstRegistrationDate` | string | First registration date as ISO string, e.g. `2020-07-01` |
| `firstRegistrationFormatted` | string | Formatted registration date, e.g. `07/2020` |
| `transmission` | string | Transmission type, e.g. `Automatic`, `Manual` |
| `fuelType` | string | Fuel type, e.g. `Gasoline`, `Diesel`, `Electric` |
| `powerKw` | integer | Engine power in kW |
| `powerHp` | integer | Engine power in hp |
| `engineDisplacementCCM` | integer | Engine displacement in cc (null for electric) |
| `bodyType` | string | Body style — always null without `fetchDetailsEnabled` |
| `bodyColor` | string | Exterior colour — always null without `fetchDetailsEnabled` |
| `numberOfSeats` | integer | Seat count — always null without `fetchDetailsEnabled` |
| `numberOfDoors` | integer | Door count — always null without `fetchDetailsEnabled` |
| `wltpCo2` | string | WLTP CO₂ value string from listing card (null if absent) |
| `isTrending` | boolean | AutoScout24 trending flag |
| `adTier` | string | Listing ad tier, e.g. `T50` |
| `sellerType` | string | `Dealer` or `Private` |
| `sellerName` | string | Dealer or private seller name |
| `sellerCity` | string | Seller city |
| `sellerCountry` | string | Seller country code, e.g. `NL` |
| `sellerZip` | string | Seller postal code |
| `sellerStreet` | string | Seller street address |
| `sellerPhones` | array | Phone numbers: `[{ type, number, dialable }]` |
| `sellerInfoUrl` | string | Link to seller info page on AutoScout24 |
| `dealerHomepage` | string | Dealer's own website URL (null if absent) |
| `images` | array | Full-resolution image URLs (`/1280x960.webp`) |
| `imageCount` | integer | Number of images |
| `latitude` | number | Listing GPS latitude (from seller location) |
| `longitude` | number | Listing GPS longitude |
| `isRepost` | boolean | `true` if this listing was seen in a previous run |
| `originalScrapedAt` | string | ISO timestamp of first encounter (null if new) |
| `source` | string | Always `autoscout24` |
| `scrapedAt` | string | ISO timestamp of this scrape |
| `contentHash` | string | MD5 hash of id + price + mileage — detect price changes across runs |
#### With `fetchDetailsEnabled: true`
| Field | Type | Description |
|---|---|---|
| `descriptionHtml` | string | Seller description as raw HTML |
| `descriptionText` | string | Seller description as plain text |
| `descriptionMarkdown` | string | Seller description as Markdown |
| `equipment` | array | Equipment items: `[{ id, category, categoryName }]` — 40+ entries typical |
| `bodyType` | string | Body style, e.g. `Compact`, `SUV/Off-Road/Pick-Up` |
| `bodyColor` | string | Exterior colour, e.g. `Blue`, `Black` |
| `numberOfSeats` | integer | Number of seats |
| `numberOfDoors` | integer | Number of doors |
| `driveTrain` | string | Drive type, e.g. `Front Wheel Drive`, `4WD` (null if absent) |
| `cylinders` | integer | Number of engine cylinders (null for electric) |
| `upholstery` | string | Interior upholstery material, e.g. `Full leather`, `Velour` |
| `upholsteryColor` | string | Interior colour (null if absent) |
| `noOfPreviousOwners` | integer | Number of previous owners (null if not disclosed) |
| `hadAccident` | boolean | Accident history flag (null if not disclosed) |
| `nonSmoking` | boolean | Non-smoking vehicle flag (null if not disclosed) |
| `licensePlate` | string | Licence plate or offer reference (null if not disclosed) |
| `vin` | string | Vehicle Identification Number (null if not disclosed) |
| `nextInspection` | string | Next MOT/inspection date (null if absent) |
| `hasFullServiceHistory` | boolean | Full service history flag |
| `co2ClassEuro` | string | Euro emission class, e.g. `Euro 6` |
| `fuelConsumptionCombined` | string | Combined fuel consumption, e.g. `7.20 l/100 km (comb.)` |
| `electricRangeKm` | integer | Electric range in km (null for non-EVs) |
| `wltpCo2` | string | WLTP CO₂ from detail page (overrides listing-card value) |
| `whatsappNumber` | string | WhatsApp contact number (null if absent) |
| `createdAt` | string | ISO timestamp when the listing was first published on AutoScout24 |
#### Example output
```json
{
"id": "bed8b675-64a0-4d28-be25-122c951662fc",
"crossReferenceId": null,
"url": "https://www.autoscout24.com/offers/volkswagen-golf-1-5-etsi-style-panorama-gasoline-blue-cat_ma74mo2084-bed8b675-64a0-4d28-be25-122c951662fc",
"make": "Volkswagen",
"model": "Golf",
"modelGroup": "Golf",
"variant": "Standard Model",
"modelVersionInput": "1.5 eTSI 130pk Style Panorama",
"condition": "used",
"priceEur": 28950,
"priceFormatted": "€ 28,950",
"mileageKm": 39647,
"mileageFormatted": "39,647 km",
"firstRegistrationDate": "2020-07-01",
"firstRegistrationFormatted": "07/2020",
"transmission": "Automatic",
"fuelType": "Gasoline",
"powerKw": 96,
"powerHp": 131,
"engineDisplacementCCM": 1498,
"bodyType": "Compact",
"bodyColor": "Blue",
"numberOfSeats": 5,
"numberOfDoors": 5,
"driveTrain": "Front Wheel Drive",
"cylinders": 4,
"upholstery": "Velour",
"upholsteryColor": "Black",
"noOfPreviousOwners": null,
"hadAccident": null,
"nonSmoking": null,
"wltpCo2": null,
"isTrending": false,
"adTier": "T50",
"sellerType": "Dealer",
"sellerName": "AutoDeal BV",
"sellerCity": "Amsterdam",
"sellerCountry": "NL",
"sellerZip": "1012 AB",
"sellerStreet": "Damrak 1",
"sellerPhones": [{ "type": "Phone", "number": "+31 20 123 4567", "dialable": "+31201234567" }],
"sellerInfoUrl": "https://www.autoscout24.com/dealerinfo/autodeal-bv?atype=C",
"dealerHomepage": "https://www.autodeal.nl",
"images": [
"https://prod.pictures.autoscout24.net/listing-images/bed8b675-64a0-4d28-be25-122c951662fc_abc123.jpg/1280x960.webp"
],
"imageCount": 12,
"descriptionHtml": "Dealer-maintained, one owner from new. Full service history.
",
"descriptionText": "Dealer-maintained, one owner from new. Full service history.",
"descriptionMarkdown": "Dealer-maintained, one owner from new. Full service history.",
"equipment": [
{ "id": "Adaptive cruise control", "category": "comfortAndConvenience", "categoryName": "Comfort & Convenience" },
{ "id": "Lane keeping assist", "category": "safetyAndSecurity", "categoryName": "Safety & Security" }
],
"licensePlate": null,
"vin": null,
"latitude": 52.3676,
"longitude": 4.9041,
"nextInspection": null,
"hasFullServiceHistory": true,
"co2ClassEuro": "Euro 6",
"fuelConsumptionCombined": "5.80 l/100 km (comb.)",
"electricRangeKm": null,
"whatsappNumber": null,
"createdAt": "2026-06-01T10:22:00.000Z",
"isRepost": false,
"originalScrapedAt": null,
"source": "autoscout24",
"scrapedAt": "2026-06-09T13:45:28.000Z",
"contentHash": "4c59aa56842dd2b5"
}
````
***
### Examples
**Search used VW Golf in the Netherlands under €20,000:**
```json
{
"make": "volkswagen",
"model": "golf",
"countries": ["NL"],
"condition": "used",
"priceTo": 20000,
"maxResults": 100
}
```
**Find electric SUVs across Germany and Austria with full details:**
```json
{
"bodyType": "suv",
"fuelType": "electric",
"countries": ["DE", "AT"],
"maxResults": 200,
"fetchDetailsEnabled": true
}
```
**Automatic diesels, 2018–2022, under 100,000 km:**
```json
{
"fuelType": "diesel",
"transmission": "automatic",
"yearFrom": 2018,
"yearTo": 2022,
"mileageTo": 100000,
"countries": ["DE", "NL", "BE"],
"maxResults": 500
}
```
**Scrape from a saved AutoScout24 search URL:**
```json
{
"startUrls": [
{ "url": "https://www.autoscout24.com/lst/bmw/3-series?sort=age&desc=1&ustate=U&cy=NL" }
],
"maxResults": 200
}
```
**Daily new-listings feed (schedule this run daily):**
```json
{
"make": "bmw",
"countries": ["NL", "DE", "BE"],
"sortBy": "age",
"sortOrder": "1",
"maxResults": 100,
"enableDedup": true
}
```
***
### 💰 Pricing
**$0.79 per 1,000 results** — you only pay for successfully retrieved listings. Failed retries are never charged.
| Results | Cost |
|---------|------|
| 100 | ~$0.08 |
| 1,000 | ~$0.79 |
| 10,000 | ~$7.90 |
| 100,000 | ~$79.00 |
> Flat-rate data providers typically charge $49–$199/month regardless of how many records you actually use.
Use the **Max results** cap in the input to control your spend exactly.
***
### Performance
| Run size | `fetchDetailsEnabled` | Approx. time |
|---|---|---|
| 100 listings | No | ~30 seconds |
| 500 listings | No | ~2 minutes |
| 1,000 listings | No | ~4 minutes |
| 100 listings | Yes | ~4 minutes |
| 500 listings | Yes | ~18 minutes |
| 4,000 listings | No | ~10 minutes |
***
### Known limitations
- AutoScout24 caps search results at 40 pages × 100 listings = **4,000 per search query**. Use `make`/`model` or `countries` filters to split large markets into smaller queries if you need more.
- `bodyType`, `bodyColor`, `numberOfSeats`, `numberOfDoors` and all equipment fields require `fetchDetailsEnabled: true` — they are not available from the search index.
- VIN and licence plate are disclosed by the seller; many listings omit them.
- AutoScout24 does not expose a public detail-page JSON endpoint — detail enrichment fetches the full HTML page.
***
### Technical details
- **Source:** autoscout24.com — Europe's largest cross-border car marketplace
- **Memory:** 512 MB
- **Dedup storage:** KeyValueStore `autoscout24-scraper-dedup`, 90-day TTL
- **Retry:** Automatic retry on network errors, exponential backoff, 3 attempts per request
***
### Need a custom scraper?
**[Unfenced Group](https://www.unfencedgroup.nl)** builds Apify actors for any website — for free.
If the site you need isn't in our portfolio yet, just ask. We scope, build, and publish it at no cost to you. You only pay for results — we absorb the compute and proxy costs ourselves. Same pay-per-result pricing, same quality, same standards as every actor in this portfolio.
**Get in touch:** [www.unfencedgroup.nl](https://www.unfencedgroup.nl)
# Actor input Schema
## `make` (type: `string`):
Car manufacturer slug (e.g. volkswagen, bmw, mercedes-benz). Leave empty for all makes.
## `model` (type: `string`):
Car model slug (e.g. golf, 3-series). Requires make to be set.
## `countries` (type: `array`):
Markets to search. Supported: DE, NL, FR, IT, ES, AT, BE, LU.
## `condition` (type: `string`):
Vehicle condition filter.
## `bodyType` (type: `string`):
Body style filter.
## `fuelType` (type: `string`):
Filter by fuel type.
## `transmission` (type: `string`):
Filter by transmission type.
## `priceFrom` (type: `integer`):
Minimum price in EUR. 0 = no limit.
## `priceTo` (type: `integer`):
Maximum price in EUR. 0 = no limit.
## `yearFrom` (type: `integer`):
First registration year from (e.g. 2018). 0 = no limit.
## `yearTo` (type: `integer`):
First registration year to (e.g. 2024). 0 = no limit.
## `mileageFrom` (type: `integer`):
Minimum mileage in km. 0 = no limit.
## `mileageTo` (type: `integer`):
Maximum mileage in km. 0 = no limit.
## `powerFrom` (type: `integer`):
Minimum engine power in kW. 0 = no limit.
## `powerTo` (type: `integer`):
Maximum engine power in kW. 0 = no limit.
## `sortBy` (type: `string`):
Sort order for results.
## `sortOrder` (type: `string`):
Sort direction (ascending or descending). Only relevant when sortBy is set.
## `fetchDetailsEnabled` (type: `boolean`):
Fetch each listing page for full specs, description, equipment list, VIN, and GPS coordinates.
## `enableDedup` (type: `boolean`):
Track known listings across runs using a 90-day KVS cache.
## `startUrls` (type: `array`):
Paste AutoScout24 search or listing URLs directly. Overrides all filter parameters above.
## `maxItems` (type: `integer`):
Maximum listings to collect per run.
## Actor input object example
```json
{
"make": "",
"model": "",
"countries": [
"DE",
"NL",
"FR",
"IT",
"ES",
"AT",
"BE"
],
"condition": "all",
"bodyType": "",
"fuelType": "",
"transmission": "",
"priceFrom": 0,
"priceTo": 0,
"yearFrom": 0,
"yearTo": 0,
"mileageFrom": 0,
"mileageTo": 0,
"powerFrom": 0,
"powerTo": 0,
"sortBy": "standard",
"sortOrder": "0",
"fetchDetailsEnabled": false,
"enableDedup": true,
"startUrls": [],
"maxItems": 200
}
```
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 200
};
// Run the Actor and wait for it to finish
const run = await client.actor("unfenced-group/autoscout24-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "maxItems": 200 }
# Run the Actor and wait for it to finish
run = client.actor("unfenced-group/autoscout24-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 200
}' |
apify call unfenced-group/autoscout24-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=unfenced-group/autoscout24-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "AutoScout24 Scraper",
"description": "Scrape car listings from AutoScout24 across 8 European markets. Phone numbers, WLTP data, equipment lists, GPS coordinates. No proxy required.",
"version": "0.0",
"x-build-id": "JFotfYlYZR1FxeYfQ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/unfenced-group~autoscout24-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-unfenced-group-autoscout24-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/unfenced-group~autoscout24-scraper/runs": {
"post": {
"operationId": "runs-sync-unfenced-group-autoscout24-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/unfenced-group~autoscout24-scraper/run-sync": {
"post": {
"operationId": "run-sync-unfenced-group-autoscout24-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"make": {
"title": "Car brand (make)",
"type": "string",
"description": "Car manufacturer slug (e.g. volkswagen, bmw, mercedes-benz). Leave empty for all makes.",
"default": ""
},
"model": {
"title": "Car model",
"type": "string",
"description": "Car model slug (e.g. golf, 3-series). Requires make to be set.",
"default": ""
},
"countries": {
"title": "Countries",
"type": "array",
"description": "Markets to search. Supported: DE, NL, FR, IT, ES, AT, BE, LU.",
"default": [
"DE",
"NL",
"FR",
"IT",
"ES",
"AT",
"BE"
],
"items": {
"type": "string"
}
},
"condition": {
"title": "Vehicle condition",
"enum": [
"all",
"new",
"used"
],
"type": "string",
"description": "Vehicle condition filter.",
"default": "all"
},
"bodyType": {
"title": "Body type",
"enum": [
"",
"hatchback",
"convertible",
"coupe",
"suv",
"sw",
"sedan",
"other",
"van",
"transporter"
],
"type": "string",
"description": "Body style filter.",
"default": ""
},
"fuelType": {
"title": "Fuel type",
"enum": [
"",
"petrol",
"diesel",
"electric",
"hybrid",
"lpg",
"cng",
"hydrogen"
],
"type": "string",
"description": "Filter by fuel type.",
"default": ""
},
"transmission": {
"title": "Transmission type",
"enum": [
"",
"manual",
"automatic"
],
"type": "string",
"description": "Filter by transmission type.",
"default": ""
},
"priceFrom": {
"title": "Min price (EUR)",
"minimum": 0,
"type": "integer",
"description": "Minimum price in EUR. 0 = no limit.",
"default": 0
},
"priceTo": {
"title": "Max price (EUR)",
"minimum": 0,
"type": "integer",
"description": "Maximum price in EUR. 0 = no limit.",
"default": 0
},
"yearFrom": {
"title": "Year from",
"minimum": 0,
"type": "integer",
"description": "First registration year from (e.g. 2018). 0 = no limit.",
"default": 0
},
"yearTo": {
"title": "Year to",
"minimum": 0,
"type": "integer",
"description": "First registration year to (e.g. 2024). 0 = no limit.",
"default": 0
},
"mileageFrom": {
"title": "Min mileage (km)",
"minimum": 0,
"type": "integer",
"description": "Minimum mileage in km. 0 = no limit.",
"default": 0
},
"mileageTo": {
"title": "Max mileage (km)",
"minimum": 0,
"type": "integer",
"description": "Maximum mileage in km. 0 = no limit.",
"default": 0
},
"powerFrom": {
"title": "Min power (kW)",
"minimum": 0,
"type": "integer",
"description": "Minimum engine power in kW. 0 = no limit.",
"default": 0
},
"powerTo": {
"title": "Max power (kW)",
"minimum": 0,
"type": "integer",
"description": "Maximum engine power in kW. 0 = no limit.",
"default": 0
},
"sortBy": {
"title": "Sort by",
"enum": [
"standard",
"price",
"age",
"km"
],
"type": "string",
"description": "Sort order for results.",
"default": "standard"
},
"sortOrder": {
"title": "Sort direction",
"enum": [
"0",
"1"
],
"type": "string",
"description": "Sort direction (ascending or descending). Only relevant when sortBy is set.",
"default": "0"
},
"fetchDetailsEnabled": {
"title": "Fetch details",
"type": "boolean",
"description": "Fetch each listing page for full specs, description, equipment list, VIN, and GPS coordinates.",
"default": false
},
"enableDedup": {
"title": "Enable deduplication",
"type": "boolean",
"description": "Track known listings across runs using a 90-day KVS cache.",
"default": true
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Paste AutoScout24 search or listing URLs directly. Overrides all filter parameters above.",
"default": [],
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"maxItems": {
"title": "Max results",
"minimum": 1,
"maximum": 4000,
"type": "integer",
"description": "Maximum listings to collect per run.",
"default": 200
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```