# AutoScout24 Scraper - Vehicle Listings (`benthepythondev/autoscout24-scraper`) Actor

Scrape AutoScout24 vehicle listings: title, brand, model, price, mileage, fuel type, transmission, dealer, location, images and listing URL.

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

## Pricing

from $3.00 / 1,000 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 - Vehicle Listings & Dealer Data

Scrape **AutoScout24** search results into clean vehicle-listing data. The actor extracts title, brand, model, price, currency, mileage, fuel type, transmission, condition, dealer name, dealer location, images and listing URL from public search pages.

### What does this actor do?

AutoScout24 is one of Europe's largest vehicle marketplaces. It covers used cars, dealer listings and private vehicle offers across multiple European markets. This actor converts AutoScout24 search pages into structured data that can be exported to JSON, CSV, Excel, Google Sheets or your own database.

The scraper reads the schema.org ItemList data embedded in the page HTML. That means it does not need a browser, login, account cookies or a proxy for the default search. Runs are fast, stable and friendly to scheduled monitoring.

### Input

Use `searchUrls` to paste one or more AutoScout24 result URLs. The easiest workflow is to open AutoScout24, apply filters such as country, make, model, price, mileage, fuel type or registration year, then paste the resulting URL into the actor.

Use `maxResults` to keep test runs small or cap production runs per URL.

#### Good search URL examples

Create a search on AutoScout24 for a specific make and model, vehicles in one country, dealer-only inventory, cars under a target price, low-mileage used cars, or filters such as fuel type, transmission and registration year. Paste the filtered URL into the actor. Each result keeps the original `search_url`, so one run can include several searches while still making the output easy to group later.

### Output fields

Each vehicle listing can include:

- `title` - listing title
- `url` - direct vehicle page URL
- `brand` and `model`
- `configuration` - trim/configuration text
- `price` and `currency`
- `mileage` and `mileage_unit`
- `fuel_type`
- `transmission`
- `condition`
- `engine_displacement`
- `seller_name`
- `seller_url`
- `seller_city`
- `seller_country`
- `image` and `images`
- `search_url`

### Use cases

Use this actor for vehicle market research, competitor monitoring, dealer lead generation, price comparison, used-car inventory tracking, data enrichment, demand analysis or alerting on new listings.

Dealers can monitor competing inventory. Marketplaces can benchmark supply by brand and model. Analysts can export filtered snapshots for pricing studies. Lead-generation teams can build dealer lists from seller names and dealer profile URLs.

#### Dealer lead generation

The actor extracts seller names, dealer profile URLs and seller locations when AutoScout24 exposes them in the search result data. You can use those fields to build a list of dealers active in a segment, then enrich them with website/contact data in a second step.

#### Price monitoring

Use focused URLs for a model, trim or price band and run them on a schedule. The output is suitable for comparing listing prices, mileage and vehicle configurations over time.

#### Inventory research

For marketplaces, lenders, exporters and analysts, the actor can produce snapshots of public inventory by brand, model, fuel type, country or dealer segment. Export the dataset to CSV or connect it to a BI workflow.

#### Export and enrichment workflows

The dataset can be downloaded directly from Apify or consumed through the API. Common next steps are deduplicating by listing URL, grouping by dealer, joining with external exchange-rate data, enriching dealer websites with contact details, or alerting when a filtered search returns a new vehicle below a target price.

### Reliability notes

The actor is intentionally focused on public search-result data. It does not log in or scrape private account pages. AutoScout24 search pages usually expose a limited number of listings per page; use multiple filtered URLs to segment large collection jobs.

The engine reads structured schema.org data embedded in the page HTML. That is more stable than scraping visual CSS classes and keeps the actor lightweight. If a listing does not expose a field in the structured data, the actor leaves that field empty rather than inventing a value.

Because no browser is required, the actor is fast enough for scheduled monitoring and daily auto-tests. The default search is intentionally conservative so a new task produces data quickly without burning unnecessary compute.

### Pricing

This actor uses pay-per-result pricing. You are charged per vehicle listing pushed to the dataset, plus a tiny actor-start event. Failed runs or pages with no results do not create result charges.

### FAQ

#### Does this actor require an AutoScout24 account?

No. It reads public search-result pages and does not use a login.

#### Can I scrape a specific make or model?

Yes. Apply filters on AutoScout24, copy the result URL and paste it into `searchUrls`.

#### Does it include dealer data?

When AutoScout24 exposes seller information in the structured result data, the actor returns seller name, dealer URL, seller city and country.

#### Does it scrape detail pages?

This version focuses on search result pages for speed and reliability. It returns the direct listing URL so detail enrichment can be added later if needed.

#### Can I schedule it?

Yes. Create a saved task with your filtered URLs and run it hourly, daily or weekly depending on how closely you want to monitor the market.

### You might also like

- Mobile.de Scraper - German vehicle marketplace data
- Craigslist Real Estate Scraper - classified listings
- Website Contact Extractor - extract emails and phones from dealer websites
- Google Maps Business Scraper - local dealer and business leads

### Keywords

AutoScout24 scraper, AutoScout24 API, used cars scraper, vehicle listings data, car price scraper, dealer lead generation, European car marketplace, automotive market data, vehicle inventory scraper, car dealer data.

# Actor input Schema

## `searchUrls` (type: `array`):

AutoScout24 search result URLs to scrape. Apply filters on AutoScout24, then paste the URL here.
## `maxResults` (type: `integer`):

Maximum vehicle listings to return per search URL.

## Actor input object example

```json
{
  "searchUrls": [
    "https://www.autoscout24.com/lst?atype=C&cy=D&desc=0&sort=standard"
  ],
  "maxResults": 10
}
````

# 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 = {
    "searchUrls": [
        "https://www.autoscout24.com/lst?atype=C&cy=D&desc=0&sort=standard"
    ],
    "maxResults": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("benthepythondev/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 = {
    "searchUrls": ["https://www.autoscout24.com/lst?atype=C&cy=D&desc=0&sort=standard"],
    "maxResults": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("benthepythondev/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 '{
  "searchUrls": [
    "https://www.autoscout24.com/lst?atype=C&cy=D&desc=0&sort=standard"
  ],
  "maxResults": 10
}' |
apify call benthepythondev/autoscout24-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "AutoScout24 Scraper - Vehicle Listings",
        "description": "Scrape AutoScout24 vehicle listings: title, brand, model, price, mileage, fuel type, transmission, dealer, location, images and listing URL.",
        "version": "1.0",
        "x-build-id": "hhAFt6EacO6j2oe8d"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/benthepythondev~autoscout24-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-benthepythondev-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/benthepythondev~autoscout24-scraper/runs": {
            "post": {
                "operationId": "runs-sync-benthepythondev-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/benthepythondev~autoscout24-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-benthepythondev-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": {
                    "searchUrls": {
                        "title": "Search URLs",
                        "type": "array",
                        "description": "AutoScout24 search result URLs to scrape. Apply filters on AutoScout24, then paste the URL here.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxResults": {
                        "title": "Max results",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Maximum vehicle listings to return per search URL.",
                        "default": 20
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
