# AutoScout24 Scraper - Car Listings and Details (`sourabhbgp/autoscout24-scraper`) Actor

Scrape AutoScout24, Europe's largest car marketplace: search used and new car listings across 8 countries by make, model, price, year, mileage, and fuel, and pull full car details with specs, equipment, price, seller, phone, and location. Export to JSON, CSV, or Excel.

- **URL**: https://apify.com/sourabhbgp/autoscout24-scraper.md
- **Developed by:** [Sourabh Kumar](https://apify.com/sourabhbgp) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 car results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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: search car listings & vehicle details, 8 countries

Search AutoScout24 for used and new cars by make, model, price, year, mileage, and fuel, then pull the full spec sheet for any listing. One actor covers Germany, Austria, Belgium, Spain, France, Italy, Luxembourg, and the Netherlands.

**$2 per 1,000 cars. Flat for both modes. No proxy or browser setup needed.**

Every result carries the dealer's phone number, the exact location, and AutoScout24's own price rating.

### Why this scraper?

- 💶 **$2 per 1,000 cars**, one flat rate for search and detail. No monthly minimum.
- 📞 **Dealer phone number on every listing**: dial-ready, in both search and detail results.
- 🌍 **Eight countries from one run**: mix and match German, French, Italian, Spanish markets and more.
- 🏷️ **AutoScout24's price rating included** (top, good, fair, or below-market) so you can spot deals fast.
- 🔧 **Full spec sheet in detail mode**: power, transmission, drivetrain, equipment list, emission class, accident history, service history.
- 📍 **Exact location with map coordinates**, plus dealer name, rating, and website.
- ⚡ **Fast and reliable**: no headless browser, handles blocks automatically.
- 🖼️ **Every photo** on the listing, full resolution.
- 🧾 **You only pay for real cars**: failed or deleted listings return an error row and are never charged.

### What data can you extract?

<table>
  <tr><td>🚗 Make &amp; model</td><td>💶 Price + rating</td><td>📅 First registration</td><td>🛣️ Mileage</td></tr>
  <tr><td>⚙️ Power (kW/hp)</td><td>⛽ Fuel type</td><td>🔀 Transmission</td><td>🚙 Body type</td></tr>
  <tr><td>📞 Seller phone</td><td>🏢 Dealer name + rating</td><td>📍 City, ZIP, street</td><td>🗺️ Map coordinates</td></tr>
  <tr><td>🔧 Equipment list</td><td>🌱 Emission class</td><td>🛡️ Accident-free flag</td><td>🖼️ All photos</td></tr>
</table>

### Scraping modes

#### 🔍 Search: find listings by make, model, and filters

Browse AutoScout24 results with any combination of make, model, country, price, year, mileage, fuel, and transmission. Returns the core details for every car, phone number included.

```json
{
  "mode": "search",
  "make": "bmw",
  "model": "x1",
  "countries": ["D", "A"],
  "adType": "used",
  "priceFrom": 10000,
  "priceTo": 25000,
  "yearFrom": 2018,
  "mileageTo": 100000,
  "fuelType": "D",
  "transmission": "A",
  "sort": "price",
  "maxItems": 200
}
````

Already have a search set up on AutoScout24? Paste its URL and skip the filters:

```json
{ "mode": "search", "searchUrl": "https://www.autoscout24.com/lst/audi/a4?cy=D&priceto=20000", "maxItems": 100 }
```

#### 📋 Detail: full spec sheet for specific listings

Give it listing URLs and get the complete record: description, full equipment list, emission class, accident and service history, map coordinates, and dealer contact.

```json
{
  "mode": "detail",
  "listingUrls": [
    "https://www.autoscout24.com/offers/bmw-520-d-diesel-grey-cat_ma13mo1648-a190b0b7-42e5-427c-9ca4-db2fdbde15c6"
  ]
}
```

### How to scrape AutoScout24: step by step

1. [Create a free Apify account](https://console.apify.com/sign-up). Takes 30 seconds, no card needed.
2. Open [AutoScout24 Scraper](https://console.apify.com/actors/PXb1qZf1uyvv3Tibl?addFromActorId=PXb1qZf1uyvv3Tibl) in the Apify Console.
3. Pick a mode and paste your make/model or listing URLs.
4. Click **Start**. Most searches finish in under a minute.
5. Export as JSON, CSV, or Excel, or pull the results via API.

### How much does AutoScout24 Scraper cost?

You pay **$2 per 1,000 cars**, the same in search and detail mode. The Apify Free plan includes $5 of monthly usage credit, enough for roughly **2,500 cars**. The $29/month Starter plan covers about **14,500 cars a month**. There is a small per-run start fee tied to memory (a fraction of a cent); compute is negligible because the actor is HTTP-only, no browser.

### Input

| Field | Type | Default | Notes |
|---|---|---|---|
| `mode` | string | `search` | `search` or `detail`. |
| `make` | string |: | Search: make slug, e.g. `bmw`, `volkswagen`, `mercedes-benz`. |
| `model` | string |: | Search: model slug within the make, e.g. `x1`, `golf`. |
| `countries` | array | all 8 | Search: any of `D`, `A`, `B`, `E`, `F`, `I`, `L`, `NL`. |
| `adType` | string | `both` | Search: `both`, `new`, or `used`. |
| `priceFrom` / `priceTo` | integer |: | Search: price range in EUR. |
| `yearFrom` / `yearTo` | integer |: | Search: first-registration year range. |
| `mileageTo` | integer |: | Search: maximum mileage in km. |
| `fuelType` | string | any | Search: gasoline, diesel, electric, hybrid, and more. |
| `transmission` | string | any | Search: automatic, manual, or semi-automatic. |
| `sort` | string | `standard` | Best match, price, newest, mileage, power, or year. |
| `searchUrl` | string |: | Search: paste a full AutoScout24 search URL instead of filters. |
| `maxItems` | integer | 100 | Search: how many cars to return. |
| `listingUrls` | array |: | Detail: AutoScout24 listing URLs. |

### Output

Search mode: one row per car:

```json
{
  "id": "1a085c10-c654-4e94-ab3f-8de504f90178",
  "url": "https://www.autoscout24.com/offers/bmw-m2-m2-gasoline-blue-cat_ma13mo21157-1a08...",
  "make": "BMW",
  "model": "M2",
  "offerType": "Used",
  "priceFormatted": "€ 34,000",
  "price": 34000,
  "currency": "EUR",
  "priceLabel": "toolow-price",
  "firstRegistration": "01/2023",
  "mileageKm": 31894,
  "powerKw": 338,
  "powerHp": 460,
  "fuel": "Gasoline",
  "transmission": "Automatic",
  "countryCode": "DE",
  "zip": "06679",
  "city": "Hohenmölsen",
  "street": "Im Gewerbegebiet 2",
  "sellerType": "Dealer",
  "sellerName": "Autohaus Reinhardt",
  "sellerPhone": "+493444125718",
  "ratingsCount": 6,
  "ratingsStars": 4.5,
  "imageCount": 30
}
```

Detail mode adds the full spec block:

```json
{
  "id": "a190b0b7-42e5-427c-9ca4-db2fdbde15c6",
  "make": "BMW",
  "model": "520",
  "bodyType": "Station Wagon",
  "price": 56990,
  "vatDeductible": false,
  "firstRegistration": "01/2025",
  "mileageKm": 20000,
  "powerHp": 197,
  "fuel": "Diesel",
  "transmission": "Automatic",
  "countryCode": "AT",
  "city": "Linz",
  "lat": 48.30401,
  "lng": 14.31873,
  "sellerName": "Höglinger Denzel GmbH",
  "sellerPhone": "+437327980313",
  "ratingsStars": 4.5,
  "seats": 5,
  "doors": 5,
  "color": "Grey",
  "upholstery": "Full leather",
  "gears": 8,
  "driveTrain": "Rear Wheel Drive",
  "displacementCcm": 1995,
  "emissionClass": "Euro 6e",
  "accidentFree": true,
  "fullServiceHistory": true,
  "warrantyExists": true,
  "equipment": ["Automatic climate control, 4 zones", "Cruise control", "Leather seats", "..."],
  "listedAt": "2025-08-21T10:05:12.680Z",
  "description": "Automatik, Sportpaket, Leichtmetallräder, Navigationssystem Professional, ..."
}
```

### Use cases

- 📊 **Market and price research**: track how prices move for a make and model across countries and time.
- 🧲 **Dealer lead generation**: build a list of dealers with name, phone, location, and rating.
- 🔍 **Deal hunting**: filter to below-market listings using AutoScout24's own price rating.
- 📈 **Inventory monitoring**: watch a competitor dealer's stock and pricing on a schedule.
- 🚙 **Residual value analysis**: compare mileage, year, and price to model depreciation curves.
- 🌍 **Cross-border arbitrage**: spot the same model priced lower in a neighboring market.
- 🔧 **Spec and equipment benchmarking**: compare trims, power, and features across a segment.

### Limitations

- **~4,000 cars per query.** AutoScout24 stops paginating at 200 pages. Narrow by make, model, country, or price band to reach the rest of a large result set.
- **Some spec fields are blank on newer cars.** AutoScout24 does not always publish CO2, weight, or fuel consumption for recent registrations; those fields come back empty when the source omits them.
- **Public listings only.** The actor reads what a logged-out visitor sees. No buyer accounts, saved searches, or messages.
- **Private-seller contact varies.** Dealer listings almost always include a phone number; private sellers may not.

### FAQ

#### How much does AutoScout24 Scraper cost?

AutoScout24 Scraper uses pay-per-result pricing. You pay **$2 for 1,000 cars**. The Apify Free plan gives you $5 in usage credits a month, enough for around 2,500 cars. If you run regularly, the $29/month Starter plan covers about 14,500 cars.

No subscription lock-in. Pause whenever.

#### Is it legal to scrape AutoScout24?

Scraping public data is generally allowed in the US and most of the EU, as long as you don't collect personal data covered by GDPR or CCPA without a lawful basis. This actor only touches publicly accessible pages, but how you use the output is on you.

Apify's full breakdown: [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/).

#### Can I integrate AutoScout24 Scraper with other tools?

Push results into **Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive**, and more. Apify treats every actor as a webhook source, so anything that consumes webhooks or pulls from an API works.

Full list: [Apify integrations](https://docs.apify.com/platform/integrations).

#### Can I use AutoScout24 Scraper with the Apify API?

Yes. Every run is available via the Apify REST API:

```bash
curl -X POST "https://api.apify.com/v2/acts/sourabhbgp~autoscout24-scraper/runs?token=APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode": "search", "make": "bmw", "maxItems": 50}'
```

Docs: [Apify API reference](https://docs.apify.com/api/v2).

#### Can I use AutoScout24 Scraper through an MCP Server?

Yes. Apify ships an MCP server that exposes every actor as a tool, so Claude Desktop, Cursor, and any other MCP-capable client can call AutoScout24 Scraper. Setup: [Apify MCP docs](https://docs.apify.com/platform/integrations/mcp).

### Your feedback

Bug, missing field, or odd behavior? Drop a note in the [Issues tab](https://console.apify.com/actors/PXb1qZf1uyvv3Tibl/issues). Reports go to a human and fixes usually ship the same week.

# Actor input Schema

## `mode` (type: `string`):

What to scrape. 'search' returns car listings for your make/model/filter query. 'detail' returns full car data for the listing URLs you provide.

## `searchUrl` (type: `string`):

Search mode. Paste a full AutoScout24 search URL (https://www.autoscout24.com/lst/...) to scrape exactly that result set. If set, it overrides the make/model/filter fields below.

## `make` (type: `string`):

Search mode. Car make slug, e.g. 'bmw', 'volkswagen', 'audi', 'mercedes-benz', 'renault', 'fiat'. Leave empty to search all makes.

## `model` (type: `string`):

Search mode. Model slug within the make, e.g. 'x1', 'golf', 'a4'. Requires a make. Leave empty for all models.

## `countries` (type: `array`):

Search mode. Which country markets to include. Leave empty for all 8.

## `adType` (type: `string`):

Search mode. New, used, or both.

## `priceFrom` (type: `integer`):

Search mode. Minimum price in EUR.

## `priceTo` (type: `integer`):

Search mode. Maximum price in EUR.

## `yearFrom` (type: `integer`):

Search mode. Earliest first-registration year, e.g. 2015.

## `yearTo` (type: `integer`):

Search mode. Latest first-registration year.

## `mileageTo` (type: `integer`):

Search mode. Maximum mileage in kilometers.

## `fuelType` (type: `string`):

Search mode. Restrict to a fuel type.

## `transmission` (type: `string`):

Search mode. Restrict to automatic or manual.

## `sort` (type: `string`):

Search mode. Result ordering.

## `maxItems` (type: `integer`):

Search mode only. Maximum number of listings to return. Results are paginated 20 per page. AutoScout24 caps a single query at ~4000 results (200 pages); narrow by make/model/country/price to go deeper.

## `listingUrls` (type: `array`):

Detail mode only. AutoScout24 listing URLs (https://www.autoscout24.com/offers/...).

## Actor input object example

```json
{
  "mode": "search",
  "make": "bmw",
  "countries": [],
  "adType": "both",
  "fuelType": "",
  "transmission": "",
  "sort": "standard",
  "maxItems": 20,
  "listingUrls": []
}
```

# Actor output Schema

## `results` (type: `string`):

View the scraped records in the dataset.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "make": "bmw",
    "maxItems": 20,
    "listingUrls": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("sourabhbgp/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "make": "bmw",
    "maxItems": 20,
    "listingUrls": [],
}

# Run the Actor and wait for it to finish
run = client.actor("sourabhbgp/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 '{
  "make": "bmw",
  "maxItems": 20,
  "listingUrls": []
}' |
apify call sourabhbgp/autoscout24-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=sourabhbgp/autoscout24-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "AutoScout24 Scraper - Car Listings and Details",
        "description": "Scrape AutoScout24, Europe's largest car marketplace: search used and new car listings across 8 countries by make, model, price, year, mileage, and fuel, and pull full car details with specs, equipment, price, seller, phone, and location. Export to JSON, CSV, or Excel.",
        "version": "0.0",
        "x-build-id": "9wNC1kCfqgUoBQmeb"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sourabhbgp~autoscout24-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sourabhbgp-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/sourabhbgp~autoscout24-scraper/runs": {
            "post": {
                "operationId": "runs-sync-sourabhbgp-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/sourabhbgp~autoscout24-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-sourabhbgp-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",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "search",
                            "detail"
                        ],
                        "type": "string",
                        "description": "What to scrape. 'search' returns car listings for your make/model/filter query. 'detail' returns full car data for the listing URLs you provide.",
                        "default": "search"
                    },
                    "searchUrl": {
                        "title": "Search URL (optional)",
                        "type": "string",
                        "description": "Search mode. Paste a full AutoScout24 search URL (https://www.autoscout24.com/lst/...) to scrape exactly that result set. If set, it overrides the make/model/filter fields below."
                    },
                    "make": {
                        "title": "Make",
                        "type": "string",
                        "description": "Search mode. Car make slug, e.g. 'bmw', 'volkswagen', 'audi', 'mercedes-benz', 'renault', 'fiat'. Leave empty to search all makes."
                    },
                    "model": {
                        "title": "Model (optional)",
                        "type": "string",
                        "description": "Search mode. Model slug within the make, e.g. 'x1', 'golf', 'a4'. Requires a make. Leave empty for all models."
                    },
                    "countries": {
                        "title": "Countries",
                        "type": "array",
                        "description": "Search mode. Which country markets to include. Leave empty for all 8.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "D",
                                "A",
                                "B",
                                "E",
                                "F",
                                "I",
                                "L",
                                "NL"
                            ],
                            "enumTitles": [
                                "Germany",
                                "Austria",
                                "Belgium",
                                "Spain",
                                "France",
                                "Italy",
                                "Luxembourg",
                                "Netherlands"
                            ]
                        },
                        "default": []
                    },
                    "adType": {
                        "title": "Condition",
                        "enum": [
                            "both",
                            "new",
                            "used"
                        ],
                        "type": "string",
                        "description": "Search mode. New, used, or both.",
                        "default": "both"
                    },
                    "priceFrom": {
                        "title": "Price from (EUR)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Search mode. Minimum price in EUR."
                    },
                    "priceTo": {
                        "title": "Price to (EUR)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Search mode. Maximum price in EUR."
                    },
                    "yearFrom": {
                        "title": "First registration year from",
                        "minimum": 1900,
                        "maximum": 2100,
                        "type": "integer",
                        "description": "Search mode. Earliest first-registration year, e.g. 2015."
                    },
                    "yearTo": {
                        "title": "First registration year to",
                        "minimum": 1900,
                        "maximum": 2100,
                        "type": "integer",
                        "description": "Search mode. Latest first-registration year."
                    },
                    "mileageTo": {
                        "title": "Max mileage (km)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Search mode. Maximum mileage in kilometers."
                    },
                    "fuelType": {
                        "title": "Fuel type",
                        "enum": [
                            "",
                            "B",
                            "D",
                            "2",
                            "3",
                            "E",
                            "H",
                            "L",
                            "M",
                            "O",
                            "C"
                        ],
                        "type": "string",
                        "description": "Search mode. Restrict to a fuel type.",
                        "default": ""
                    },
                    "transmission": {
                        "title": "Transmission",
                        "enum": [
                            "",
                            "A",
                            "M",
                            "S"
                        ],
                        "type": "string",
                        "description": "Search mode. Restrict to automatic or manual.",
                        "default": ""
                    },
                    "sort": {
                        "title": "Sort by",
                        "enum": [
                            "standard",
                            "price",
                            "age",
                            "mileage",
                            "power",
                            "year"
                        ],
                        "type": "string",
                        "description": "Search mode. Result ordering.",
                        "default": "standard"
                    },
                    "maxItems": {
                        "title": "Max listings (search mode)",
                        "minimum": 1,
                        "maximum": 20000,
                        "type": "integer",
                        "description": "Search mode only. Maximum number of listings to return. Results are paginated 20 per page. AutoScout24 caps a single query at ~4000 results (200 pages); narrow by make/model/country/price to go deeper.",
                        "default": 100
                    },
                    "listingUrls": {
                        "title": "Listing URLs (detail mode)",
                        "type": "array",
                        "description": "Detail mode only. AutoScout24 listing URLs (https://www.autoscout24.com/offers/...).",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
