# Autoscout24 Listings Scraper (`piotrv1001/autoscout24-listings-scraper`) Actor

The AutoScout24 Listings Scraper extracts car listings from AutoScout24, capturing make, model, version, price, mileage, first registration, power, fuel, transmission, location, images and dealer phone contacts — ideal for price monitoring, market research and automotive lead generation.

- **URL**: https://apify.com/piotrv1001/autoscout24-listings-scraper.md
- **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community)
- **Categories:** Lead generation, E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.90 / 1,000 car listings

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 Listings Scraper

Extract car listings from **AutoScout24**, Europe's largest used- and new-car marketplace. The **AutoScout24 Listings Scraper** turns any AutoScout24 search into clean, structured data — **price, make, model, mileage, first registration, power, fuel, transmission, location, dealer phone numbers and images** — ready for market research, price monitoring, and lead generation.

Just build a search on [autoscout24.com](https://www.autoscout24.com) with the filters you want, paste the result URL, and run. Hosted on the Apify platform, it gives you **API access, scheduling, integrations, and exports to JSON, CSV, Excel and Google Sheets** out of the box.

### ✨ Features

- 🏷️ **Rich listing data** – make, model, version, price, mileage, first registration, power, fuel, transmission, location and images for every car.
- 📞 **Dealer & seller contacts** – seller type, company name, contact name and phone numbers (including WhatsApp) straight from the listing.
- 🔍 **Search-URL based** – bring any AutoScout24 search/category URL with your filters (make, model, price, year, mileage, country…) and the scraper paginates automatically.
- 🔬 **Optional deep mode** – flip on _Scrape full vehicle details_ to enrich every car with 30+ extra fields: body type, colour, doors/seats, drivetrain, CO₂ emissions, equipment, previous owners, warranty and the full description.
- 💸 **Pay only for what you scrape** – transparent pay-per-result pricing with a built-in `Max items` cap to control cost.
- ⚡ **Fast & reliable** – lightweight extraction that handles pagination and large result sets across European markets.

### 🛠️ How to use the AutoScout24 Listings Scraper

1. **Build your search** – Go to [autoscout24.com](https://www.autoscout24.com), apply any filters you like (make, model, price range, registration year, mileage, country, etc.), and copy the URL of the results page.
2. **Paste the URL** – Add one or more of these search URLs to the **Search URLs** input field.
3. **Set your limits** – Choose **Max items** (default 50) and, optionally, enable **Scrape full vehicle details** for the deep profile.
4. **Run the Actor** – Start it and watch the structured results fill the dataset in real time.
5. **Export** – Download the dataset as JSON, CSV, Excel or HTML, or pull it via the Apify API.

### 🔧 Input

| Field                | Type    | Description                                                                   |
| -------------------- | ------- | ----------------------------------------------------------------------------- |
| `startUrls`          | array   | AutoScout24 search result URLs to scrape. Prefilled with a sample BMW search. |
| `maxItems`           | integer | Maximum number of cars to scrape across all URLs. Default `50`.               |
| `scrapeDetails`      | boolean | Open each car's detail page for the full vehicle profile. Default `false`.    |
| `proxyConfiguration` | object  | Optional proxy settings. Off by default — the Actor works without a proxy.    |

#### Example input

```json
{
    "startUrls": [{ "url": "https://www.autoscout24.com/lst/bmw?atype=C" }],
    "maxItems": 50,
    "scrapeDetails": false
}
````

### 📊 Output

You can download the dataset in various formats such as **JSON, HTML, CSV, or Excel**. Each car is one record.

#### Sample output (listing level)

```json
{
    "id": "c771d215-0d0e-4b35-8c12-1d32e1eacdb9",
    "crossReferenceId": "457794029",
    "url": "https://www.autoscout24.com/offers/bmw-i3-rex-...-c771d215-0d0e-4b35-8c12-1d32e1eacdb9",
    "make": "BMW",
    "model": "i3",
    "modelGroup": "i3",
    "version": "REX / Katalysator defekt",
    "price": "€ 6,990",
    "offerType": "U",
    "mileage": "268,679 km",
    "firstRegistration": "12/2016",
    "power": "125 kW (170 hp)",
    "fuel": "Electric/Gasoline",
    "transmission": "Automatic",
    "location": {
        "countryCode": "DE",
        "zip": "83026",
        "city": "Rosenheim",
        "street": "Dr.-Steinbeißer-Str. 3"
    },
    "seller": {
        "type": "Dealer",
        "companyName": "DRS Automobile",
        "contactName": "I Matyas",
        "phones": [
            { "type": "Mobile", "number": "+49 (0)172 - 3583449" },
            { "type": "Whatsapp", "number": "+49 (0)172 - 3583449" }
        ]
    },
    "images": ["https://prod.pictures.autoscout24.net/listing-images/..."],
    "detailsScraped": false
}
```

#### Data fields

| Field                                    | Description                                          |
| ---------------------------------------- | ---------------------------------------------------- |
| `make`, `model`, `modelGroup`, `version` | Vehicle make, model and trim/version                 |
| `price`                                  | Listed price (formatted)                             |
| `offerType`                              | `U` (used) or `N` (new)                              |
| `mileage`                                | Odometer reading                                     |
| `firstRegistration`                      | First registration date                              |
| `power`                                  | Engine power (kW / hp)                               |
| `fuel`, `transmission`                   | Fuel type and gearbox                                |
| `location`                               | Country, ZIP, city, street                           |
| `seller`                                 | Seller type, company, contact name and phone numbers |
| `images`                                 | Listing image URLs                                   |
| `url`                                    | Direct link to the car's detail page                 |

With **Scrape full vehicle details** enabled, each record also includes body type, colour, doors, seats, drivetrain, displacement, CO₂ emissions, equipment, previous owners, warranty, full seller contact and the complete description.

### 💰 How much does it cost to scrape AutoScout24?

This Actor uses **pay-per-result** pricing:

- **$0.90 per 1,000 car listings** scraped at listing level.
- **$2.00 per 1,000 cars** when *Scrape full vehicle details* is enabled (the deep profile).

You only pay for the cars you actually scrape, and the **Max items** input keeps every run within budget. New Apify accounts include free monthly usage credits, so you can try it at no cost.

### 💡 Tips

- **Beat the result cap.** AutoScout24 returns up to ~4,000 cars per search. To enumerate a large make like BMW exhaustively, split your searches by model, price band or registration year and add each URL to `startUrls`.
- **Start small.** Keep `maxItems` low for a first test run, then scale up once you're happy with the output.
- **Skip details for speed.** Leave `scrapeDetails` off when listing-level data (price, mileage, registration, contacts) is enough — it's faster and cheaper.
- **Automate it.** Use Apify **Schedules** to monitor prices or new listings daily and pipe results to Google Sheets, a webhook, or your own API.

### ❓ FAQ

**Is scraping AutoScout24 legal?**
This Actor collects only publicly available data. As with any web scraping, you are responsible for how you use the data and for complying with applicable laws and AutoScout24's terms. Avoid collecting personal data you are not entitled to process.

**Which countries are covered?**
Any AutoScout24 marketplace you can reach via a search URL — Germany, Austria, Italy, Spain, France, Belgium, the Netherlands and more.

**Why are some detail fields empty?**
Field availability depends on what each seller filled in. Missing values are returned as `null`.

**Can I get a custom version?**
Yes — open an issue on the Actor's **Issues** tab with your requirements.

### 🆘 Support

Found a bug or need an extra field? Head to the **Issues** tab on the Actor's page and let us know. Feedback is welcome and helps improve the scraper.

Start extracting **European car market data** with the **AutoScout24 Listings Scraper** today! 🚗

# Actor input Schema

## `startUrls` (type: `array`):

AutoScout24 search result URLs to scrape. Build a search on autoscout24.com with the filters you want (make, model, price, year, mileage, location, etc.), then paste the result page URL here. The scraper paginates automatically.

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

Maximum number of car listings to scrape across all search URLs. Use this to control run time and cost.

## `scrapeDetails` (type: `boolean`):

If enabled, the scraper opens each car's detail page to extract the full vehicle profile (100+ fields: equipment, registration, condition, full seller contact, fuel/emissions, warranty, and more). Slower and more expensive, but far richer data. If disabled, you still get the core listing data from the search results.

## `proxyConfiguration` (type: `object`):

Optional proxy settings. AutoScout24 works fine without a proxy, so this is off by default. Enable it if you run at high volume or from a restricted network.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.autoscout24.com/lst/bmw?atype=C"
    }
  ],
  "maxItems": 50,
  "scrapeDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

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

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.autoscout24.com/lst/bmw?atype=C"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("piotrv1001/autoscout24-listings-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 = { "startUrls": [{ "url": "https://www.autoscout24.com/lst/bmw?atype=C" }] }

# Run the Actor and wait for it to finish
run = client.actor("piotrv1001/autoscout24-listings-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 '{
  "startUrls": [
    {
      "url": "https://www.autoscout24.com/lst/bmw?atype=C"
    }
  ]
}' |
apify call piotrv1001/autoscout24-listings-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Autoscout24 Listings Scraper",
        "description": "The AutoScout24 Listings Scraper extracts car listings from AutoScout24, capturing make, model, version, price, mileage, first registration, power, fuel, transmission, location, images and dealer phone contacts — ideal for price monitoring, market research and automotive lead generation.",
        "version": "0.0",
        "x-build-id": "BZKKWbZrkwzsCb2QU"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/piotrv1001~autoscout24-listings-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-piotrv1001-autoscout24-listings-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/piotrv1001~autoscout24-listings-scraper/runs": {
            "post": {
                "operationId": "runs-sync-piotrv1001-autoscout24-listings-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/piotrv1001~autoscout24-listings-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-piotrv1001-autoscout24-listings-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": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "Search URLs",
                        "type": "array",
                        "description": "AutoScout24 search result URLs to scrape. Build a search on autoscout24.com with the filters you want (make, model, price, year, mileage, location, etc.), then paste the result page URL here. The scraper paginates automatically.",
                        "default": [
                            {
                                "url": "https://www.autoscout24.com/lst/bmw?atype=C"
                            }
                        ],
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of car listings to scrape across all search URLs. Use this to control run time and cost.",
                        "default": 50
                    },
                    "scrapeDetails": {
                        "title": "Scrape full vehicle details",
                        "type": "boolean",
                        "description": "If enabled, the scraper opens each car's detail page to extract the full vehicle profile (100+ fields: equipment, registration, condition, full seller contact, fuel/emissions, warranty, and more). Slower and more expensive, but far richer data. If disabled, you still get the core listing data from the search results.",
                        "default": false
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Optional proxy settings. AutoScout24 works fine without a proxy, so this is off by default. Enable it if you run at high volume or from a restricted network.",
                        "default": {
                            "useApifyProxy": false
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```