# AutoScout24 Scraper: Past the 4,000 Limit (`luzivanlt/autoscout24-listings-scraper`) Actor

Every car of an AutoScout24 search in 8 countries, past the 4,000 the site shows, checked against its count. $1 per 1,000 cars. Price, mileage, specs, dealer and phone; car pages optional.

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

## Pricing

from $0.70 / 1,000 cars

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## AutoScout24 Scraper: Past the 4,000 Limit

Get every car of an AutoScout24 search, not just the 4,000 the site shows
you: from any results link in Germany, Austria, Belgium, Spain, France,
Italy, Luxembourg or the Netherlands, or from a make, model and filters. The
run's last message checks the cars saved against AutoScout24's own count for
each search. No AutoScout24 account, login or cookies needed.

Tested daily. Latest check: BMW X3s listed in Germany, 5,366 of the 5,370
cars the site counted, in under 8 minutes.

### What does this Actor do?

You give it links to AutoScout24 results pages, or a make, a model and
filters. For each search it saves one row per car, until it has every car
AutoScout24 counts for that search or reaches your limit.

AutoScout24's own site stops at 200 pages of 20 cars (4,000) for any search.
This Actor keeps going: a bigger search is read price band by price band (and
by mileage where one price alone holds more), so a search far past
4,000 (up to 100,000 cars) comes back in one run, and its final message says, per search, whether it got
all of AutoScout24's count.

Each row comes with:

- the listing id, the car's link and its title
- make, model, model group, variant, engine name and the seller's version
  text, the highlights the card shows, new or used (and demo, classic,
  pre-registered)
- the price in euros and as shown, AutoScout24's price rating (good price,
  fair price…), the VAT note, the list price when new and an earlier price
  where shown
- mileage, first registration, fuel, gearbox, power in kW and hp, engine
  size, fuel consumption and CO₂ where shown, electric or hybrid
- where the car is: country, ZIP code, city and a dealer's street
- the seller: private or dealer, the dealer's name and contact person, every
  phone number (office, mobile, WhatsApp), the dealer's page, legal notice and
  logo, and its star rating and number of ratings
- every picture in large size, boosted and trending flags, the interest level
  AutoScout24 shows, the dealer's own reference, and AutoScout24's ids for
  the make, model, generation, variant, engine and trim
- the search it came from and AutoScout24's count for the search

With **Include car pages** on, each row also gets the car's own page: the
description, the full equipment list (by group), body type, colour and the
maker's colour name, paint, upholstery, seats, doors, cylinders, gears, drive,
weight, previous owners, accident and damage, service history, non-smoking,
next inspection and last service, emission class and sticker, consumption and
CO₂, electric range, the market's median price and price rating bands, net
price and VAT rate, the map point, when it was listed, how many people saved
it, warranty, a history report link, and the dealer's average rating,
ratings by category, opening hours, website and years on AutoScout24.

With **Include dealer pages** on, a dealer's cars also get the dealer's own
page: about us, the legal notice, address, phone and fax numbers, website,
contact people, the brands and services it offers, opening hours, branches,
its rating by category and its newest 10 reviews (with the dealer's replies).

### Why use it?

- **Every car, not 4,000.** A search with more cars than the site shows is
  read to its end; the run tells you for each search how many of the count it
  saved.
- **Eight countries**, from any results link with your filters, or from a
  make, model, country, price, year, mileage, fuel, gearbox, body and seller
  type.
- **Phone numbers on every row** that has a seller's number (all of them in
  our tests), without opening car pages.
- **Car pages when you want them**, with history, equipment and the market
  price range, and **dealer pages** with the dealer's profile and newest
  reviews.
- **$1 per 1,000 cars**, car pages included, and nothing per search.

### How to use it

1. Paste AutoScout24 results links under **Search links**, or fill in a
   **Make** (and **Model**, **Countries** and filters).
2. Set **Max cars per search** (1,000 by default). To get a whole search, set
   it above the number AutoScout24 shows for it.
3. Turn on **Include car pages** if you need the full listings, and
   **Include dealer pages** for the dealers' profiles and reviews.
4. Start the run, then download the cars as JSON, CSV or Excel.

Run it with no input to see a sample: up to 100 BMW X3s listed in Germany,
charged as usual.

### Input

| Field                | What it is                                                                      |
| -------------------- | ------------------------------------------------------------------------------- |
| `startUrls`          | AutoScout24 results links (de, at, be, es, fr, it, lu, nl, com) with filters    |
| `make`, `model`      | A make and model as AutoScout24 writes them in a link (`bmw`, `x3`)             |
| `countries`          | `DE`, `AT`, `BE`, `ES`, `FR`, `IT`, `LU`, `NL` (all eight when empty)           |
| `minPrice`           | Lowest price in euros, for the make and filters                                 |
| `maxPrice`           | Highest price in euros, for the make and filters                                |
| `minYear`            | First registered from this year                                                 |
| `maxYear`            | First registered until this year                                                |
| `maxMileage`         | Highest mileage in km                                                           |
| `fuelType`           | `all` (default), `petrol`, `diesel`, `electric`, hybrids, `lpg`, `cng` and more |
| `gearbox`            | `all` (default), `automatic`, `manual` or `semi-automatic`                      |
| `bodyType`           | `all` (default), `compact`, `suv`, `station-wagon`, `sedan` and more            |
| `sellerType`         | `all` (default), `dealer` or `private`                                          |
| `maxCarsPerSearch`   | 1 to 100,000, default 1,000                                                     |
| `includeDetails`     | `true` to read each car's own page too (default `false`)                        |
| `includeDealerPages` | `true` to read each dealer's page too (default `false`)                         |

Example:

```json
{
  "startUrls": ["https://www.autoscout24.de/lst/bmw/x3?atype=C&cy=D"],
  "make": "audi",
  "model": "a4",
  "countries": ["DE", "AT"],
  "maxPrice": 30000,
  "minYear": 2019,
  "fuelType": "diesel",
  "maxCarsPerSearch": 10000,
  "includeDetails": false
}
```

A link to a single car, to a dealer's page, to motorbikes or to another site
is refused before the run starts, with the link named. The make and filters
form one more search, read on autoscout24.com in English; a link keeps its
own site's language.

### Output

One row per car. Fields the site does not show for a car are `null` or an
empty list.

| Field                                                                                                                                                                                                                                      | What it is                                                     |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------- |
| `listing_id`, `url`, `title`                                                                                                                                                                                                               | The car                                                        |
| `make`, `model`, `model_group`, `variant`, `motor_type`, `model_version`, `highlights`, `vehicle_type`, `offer_type`, `is_new`                                                                                                             | What car it is                                                 |
| `price`, `price_text`, `currency`, `price_rating`, `price_label`, `vat_label`, `is_conditional_price`, `suggested_retail_price`, `old_price`, `is_super_deal`                                                                              | The price in euros, AutoScout24's rating, the list price, cuts |
| `mileage_km`, `mileage_text`, `first_registration`, `first_registration_text`, `fuel`, `fuel_code`, `gearbox`, `power_kw`, `power_hp`, `engine_cc`                                                                                         | The car's main facts                                           |
| `fuel_consumption_text`, `co2_text`, `wltp`, `electric_type`, `is_damaged`, `available_now`, `available_from`, `special_conditions`                                                                                                        | Consumption, emissions, hybrid or electric, damage, delivery   |
| `country_code`, `zip`, `city`, `street`                                                                                                                                                                                                    | Where it is                                                    |
| `seller_id`, `seller_type`, `seller_name`, `seller_contact`, `seller_phone`, `seller_phones`, `seller_page_url`, `seller_imprint_url`, `seller_logo`, `seller_language`                                                                    | The seller and every phone number                              |
| `seller_rating`, `seller_rating_count`                                                                                                                                                                                                     | A dealer's star rating and number of ratings                   |
| `image_url`, `images`, `image_count`                                                                                                                                                                                                       | Pictures, large size                                           |
| `ad_tier`, `result_type`, `is_boosted`, `is_trending`, `is_online_sale`, `interest_level`, `cross_reference_id`                                                                                                                            | The listing's placement and the dealer's reference             |
| `make_id`, `model_id`, `generation_id`, `variant_id`, `motor_type_id`, `trim_id`                                                                                                                                                           | AutoScout24's ids for the car's make, model and trim           |
| `search_url`, `search_total`                                                                                                                                                                                                               | The search the row came from and AutoScout24's count for it    |
| `details_read`                                                                                                                                                                                                                             | With car pages: whether the car's page was read                |
| `description`, `equipment`, `equipment_by_group`                                                                                                                                                                                           | With car pages: the description and the full equipment         |
| `body_type`, `body_color`, `manufacturer_color`, `paint_type`, `upholstery`, `upholstery_color`, `seats`, `doors`, `cylinders`, `gears`, `drive_train`, `weight_kg`, `dimensions`                                                          | With car pages: body, colour, interior and drive               |
| `emission_class`, `emission_sticker`, `co2_class`, `fuel_category`, `fuel_consumption_l_100km`, `fuel_consumption_urban`, `fuel_consumption_extra_urban`, `co2_g_km`                                                                       | With car pages: emissions and consumption                      |
| `electric_range_km`, `battery_charging_time`, `battery_ownership`, `additional_fuels`, `has_particle_filter`                                                                                                                               | With car pages: electric range, battery, other fuels           |
| `previous_owners`, `had_accident`, `damage_conditions`, `full_service_history`, `non_smoking`, `new_inspection`, `next_inspection`, `last_service`, `last_belt_service`                                                                    | With car pages: the car's history                              |
| `is_rental`, `production_year`, `model_year`, `model_generation`, `original_market`, `hsn_tsn`, `license_plate`, `legal_categories`, `has_registration`, `new_driver_suitable`                                                             | With car pages, where shown: more about the car                |
| `price_negotiable`, `vat_deductible`, `price_on_request`, `net_price`, `vat_rate`, `market_median_price`, `price_rating_ranges`, `dealer_price`                                                                                            | With car pages: price terms and the market price range         |
| `latitude`, `longitude`                                                                                                                                                                                                                    | With car pages: the map point                                  |
| `seller_rating_average`, `seller_recommend_percent`, `seller_ratings_by_category`, `seller_reviews_url`, `seller_customer_since`, `seller_homepage`, `seller_opening_hours`, `seller_stock_url`, `seller_logo_large`, `seller_best_priced` | With car pages: the dealer's profile                           |
| `created_at`, `status`, `warranty`, `favorites`, `youtube_url`, `has_360_view`, `history_report_url`                                                                                                                                       | With car pages: listed at, saved by, warranty, media           |
| `dealer_page_read`, `dealer_customer_id`, `dealer_name`, `dealer_name_add_on`, `dealer_street`, `dealer_zip`, `dealer_city`, `dealer_country`                                                                                              | With dealer pages: the dealer and its address                  |
| `dealer_phones`, `dealer_fax_numbers`, `dealer_homepage`, `dealer_about`, `dealer_imprint`, `dealer_contact_persons`                                                                                                                       | With dealer pages: contact, about us, legal notice, people     |
| `dealer_types`, `dealer_brands`, `dealer_services`, `dealer_opening_hours`, `dealer_hero_image`, `dealer_branches`                                                                                                                         | With dealer pages: what it sells and offers, hours, branches   |
| `dealer_rating_average`, `dealer_rating_count`, `dealer_review_count`, `dealer_recommend_percent`, `dealer_grades`, `dealer_reviews`                                                                                                       | With dealer pages: ratings and the newest 10 reviews           |

Sellers' names and phone numbers are personal data: check that your use is
allowed where you are (in the EU, the GDPR applies).

### How much does it cost?

No surcharges and no paid options; an item that fails is not charged.

This Actor is priced per car saved:

- **$1 per 1,000 cars** ($0.001 a car), with or without car and dealer pages. Each car is
  charged once per run.
- No start fee, and nothing per search.

So 1,000 cars cost $1. If you set a maximum cost for a run, the Actor stops
when it reaches it and keeps every car saved so far.

### How long does a run take?

About a minute and a half per 1,000 cars (5,366 in under 8 minutes in a
test). With car and dealer pages, about 2 minutes per 50 cars (50 in 2
minutes in a test). For more than about 60,000 cars, or about 2,000 with car
and dealer pages, raise the run's timeout under **Run options** before you
start.

### Good to know

- **AutoScout24's count.** The final message compares the cars saved with
  the site's count for each search. The count moves while a big search is
  read, as cars come and go.
- **A car in two of your searches** is saved once, under the first search
  that reached it, so the second one's count check can read short.
- **Order.** A search under 4,000 cars comes back in the order of its link
  (AutoScout24's best results first by default); a larger one comes back price
  band by price band.
- **Language.** Text fields (fuel, gearbox, colours, equipment) come in the
  language of the link's site: German for autoscout24.de, Italian for .it,
  English for .com and for the make and filters.
- **Car pages.** A car taken down between the results page and its own page
  keeps the row from the results page, marked `details_read: false`, as
  does a car page the site keeps refusing. A dealer
  often leaves the description empty.
- **Dealer pages.** A dealer's cars on one results page share one visit to
  its page. A dealer page that cannot be read keeps the cars, marked
  `dealer_page_read: false`. Reviews are the newest 10 the page shows, not
  the dealer's whole history. These pages show no e-mail address.
- **Cars only**: no motorbikes, vans or caravans sections, and not
  AutoScout24.ch, which is a separate site.

### More Actors from us

- [Airbnb Scraper: Every Stay, Past the 15-Page Limit](https://apify.com/luzivanlt/airbnb-listings-scraper): Every stay of an Airbnb search, past the 15 pages Airbnb shows, checked against its count.
- [Alibaba Products Scraper: Price Tiers & Suppliers](https://apify.com/luzivanlt/alibaba-products-scraper): Alibaba.com products by keyword or link, with price tiers in US dollars on every row.
- [AliExpress Product Scraper: Search Results & Prices](https://apify.com/luzivanlt/aliexpress-products-scraper): Every product of an AliExpress search to its last page, with exact sold counts and ratings.
- [Amazon Product Scraper: Search Results & Prices](https://apify.com/luzivanlt/amazon-products-scraper): Every product on Amazon's search pages to the last page, sponsored marked, with monthly sales.
- [App Store Reviews Scraper: All Reviews, Not 500](https://apify.com/luzivanlt/app-store-reviews-scraper): Every written App Store review of an app, not just the newest 500.
- [Woolworths Coles ALDI Scraper: AU Grocery Prices](https://apify.com/luzivanlt/au-supermarkets-scraper): Woolworths, Coles and ALDI products for any search in one run, every results page to the end.

### Use it from an AI agent or the API

One call starts a run and returns its items (Apify waits up to 300 seconds; for a
longer run, start it with `POST /v2/acts/…/runs` and read its dataset):

```text
POST https://api.apify.com/v2/acts/luzivanlt~autoscout24-listings-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>
```

With the sample input as its JSON body:

```json
{
  "startUrls": ["https://www.autoscout24.de/lst/bmw/x3?atype=C&cy=D"],
  "fuelType": "all",
  "gearbox": "all",
  "bodyType": "all",
  "sellerType": "all",
  "maxCarsPerSearch": 100,
  "includeDetails": false,
  "includeDealerPages": false
}
```

Its inputs, in the order of the input form:

| Input                                       | What it takes                                                                                                                                                                                                                                                                                                                                            | Default |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `startUrls` (Search links)                  | AutoScout24 results links, copied from your browser after you set the make, model, country, price, year, mileage and any other filters you want, on autoscout24.de, .at, .be, .es, .fr, .it, .lu, .nl or .com.                                                                                                                                           | —       |
| `make` (Make)                               | Instead of a link: the make to search, as AutoScout24 writes it in a link (bmw, mercedes-benz, volkswagen, land-rover).                                                                                                                                                                                                                                  | —       |
| `model` (Model)                             | The model of the make above, as AutoScout24.com writes it in its links (a4, x3, golf, 3-series).                                                                                                                                                                                                                                                         | —       |
| `countries` (Countries)                     | The countries whose cars to read, for the make and filters above: Germany, Austria, Belgium, Spain, France, Italy, Luxembourg and the Netherlands.                                                                                                                                                                                                       | —       |
| `minPrice` (Lowest price (€))               | Only cars priced at or above this many euros, for the make and filters above.                                                                                                                                                                                                                                                                            | —       |
| `maxPrice` (Highest price (€))              | Only cars priced at or below this many euros, for the make and filters above.                                                                                                                                                                                                                                                                            | —       |
| `minYear` (First registered from (year))    | Only cars first registered in this year or later, for the make and filters above.                                                                                                                                                                                                                                                                        | —       |
| `maxYear` (First registered until (year))   | Only cars first registered in this year or earlier, for the make and filters above.                                                                                                                                                                                                                                                                      | —       |
| `maxMileage` (Highest mileage (km))         | Only cars with at most this many kilometres on the clock, for the make and filters above.                                                                                                                                                                                                                                                                | —       |
| `fuelType` (Fuel)                           | One fuel, for the make and filters above: petrol, diesel, electric, the two hybrids, LPG, CNG, hydrogen, ethanol or other.                                                                                                                                                                                                                               | `"all"` |
| `gearbox` (Gearbox)                         | Automatic, manual or semi-automatic gearbox, for the make and filters above; any gearbox by default.                                                                                                                                                                                                                                                     | `"all"` |
| `bodyType` (Body type)                      | One body type, for the make and filters above: compact, convertible, coupé, SUV, station wagon, sedan, van, transporter or other.                                                                                                                                                                                                                        | `"all"` |
| `sellerType` (Seller)                       | Dealers only, private sellers only, or both (the default), for the make and filters above.                                                                                                                                                                                                                                                               | `"all"` |
| `maxCarsPerSearch` (Max cars per search)    | Stop each search after this many cars, from 1 to 100,000 (1,000 by default).                                                                                                                                                                                                                                                                             | `1000`  |
| `includeDetails` (Include car pages)        | Also open each car's own page for its description, full equipment list, body type, colour, seats and doors, previous owners, accident and service history, next inspection, emission class and sticker, consumption and CO₂, the market price range, map point, every picture in large size, and the dealer's rating details, opening hours and website. | `false` |
| `includeDealerPages` (Include dealer pages) | Also open each dealer's own page and add its profile to the dealer's cars: about us, legal notice, address, phone and fax, website, contact people, the brands and services it offers, opening hours, branches, its rating by category and its newest 10 reviews.                                                                                        | `false` |

Apify's MCP server, `https://mcp.apify.com`, lists it as `luzivanlt/autoscout24-listings-scraper`. To give an
AI agent this Actor as a tool, add the server to the agent's MCP config:

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=luzivanlt/autoscout24-listings-scraper"
    }
  }
}
```

The client signs in with OAuth, or add `"headers": { "Authorization": "Bearer <APIFY_TOKEN>" }`.

Charged per car delivered; the sample input above costs at most $0.10.

### FAQ

**Can I get more than 4,000 cars from one search?** Yes, up to 100,000 a
search: set **Max cars per search** above the site's count; the final
message tells you how many of the count were saved (5,366 of 5,370 in a
test).

**Can I use my own filters?** Yes. Set them on AutoScout24, copy the link
from your browser and paste it under **Search links**.

**Do I get dealers' phone numbers?** Yes, on every row, from the results
page: the numbers the listing shows (office, mobile, WhatsApp).

### Is it legal to scrape AutoScout24?

This Actor reads only what AutoScout24 shows any visitor without an account.
Rows can hold sellers' names and phone numbers: whether you may store and use
them depends on your purpose and on the data protection law where you are. Read
AutoScout24's terms, and ask a lawyer when in doubt.

# Changelog

This Actor's version history is a separate document: https://apify.com/luzivanlt/autoscout24-listings-scraper/changelog.md

# Actor input Schema

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

AutoScout24 results links, copied from your browser after you set the make, model, country, price, year, mileage and any other filters you want, on autoscout24.de, .at, .be, .es, .fr, .it, .lu, .nl or .com. Each link keeps all of its filters and its sort order, and is read from its first page. A link to one car or to a dealer's page is refused. Example: https://www.autoscout24.de/lst/bmw/x3?atype=C\&cy=D

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

Instead of a link: the make to search, as AutoScout24 writes it in a link (bmw, mercedes-benz, volkswagen, land-rover). The filters below apply to this search, read on autoscout24.com in English. Leave empty when you only paste links. Example: audi

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

The model of the make above, as AutoScout24.com writes it in its links (a4, x3, golf, 3-series). Needs a make. When you are not sure of the spelling, set the search up on autoscout24.com and paste its link under Search links instead. Example: a4

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

The countries whose cars to read, for the make and filters above: Germany, Austria, Belgium, Spain, France, Italy, Luxembourg and the Netherlands. All eight together when you leave it empty. Links keep their own countries. Example: DE

## `minPrice` (type: `integer`):

Only cars priced at or above this many euros, for the make and filters above. Leave empty for no lower limit. Search links keep the price filter set in the link itself, if any. Example: 10000

## `maxPrice` (type: `integer`):

Only cars priced at or below this many euros, for the make and filters above. Leave empty for no upper limit. Search links keep the price filter set in the link itself, if any. Example: 30000

## `minYear` (type: `integer`):

Only cars first registered in this year or later, for the make and filters above. Leave empty for no limit. Search links keep the registration filter set in the link itself, if any. Example: 2019

## `maxYear` (type: `integer`):

Only cars first registered in this year or earlier, for the make and filters above. Leave empty for no limit. Search links keep the registration filter set in the link itself, if any. Example: 2023

## `maxMileage` (type: `integer`):

Only cars with at most this many kilometres on the clock, for the make and filters above. Leave empty for any mileage. Search links keep the mileage filter set in the link itself, if any. Example: 100000

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

One fuel, for the make and filters above: petrol, diesel, electric, the two hybrids, LPG, CNG, hydrogen, ethanol or other. All fuels by default. Search links keep their own fuel filter. Example: diesel

## `gearbox` (type: `string`):

Automatic, manual or semi-automatic gearbox, for the make and filters above; any gearbox by default. Search links keep the gearbox filter set in the link itself, if any. Example: automatic

## `bodyType` (type: `string`):

One body type, for the make and filters above: compact, convertible, coupé, SUV, station wagon, sedan, van, transporter or other. Any by default. Search links keep their own body filter. Example: suv

## `sellerType` (type: `string`):

Dealers only, private sellers only, or both (the default), for the make and filters above. Search links keep the seller filter set in the link itself, if any. Example: private

## `maxCarsPerSearch` (type: `integer`):

Stop each search after this many cars, from 1 to 100,000 (1,000 by default). AutoScout24's own site shows at most 4,000 cars for one search; this Actor goes past that to the cars AutoScout24 counts, so set this above the search's count to get them all. You pay per car saved, so this also caps what each search costs. Example: 10000

## `includeDetails` (type: `boolean`):

Also open each car's own page for its description, full equipment list, body type, colour, seats and doors, previous owners, accident and service history, next inspection, emission class and sticker, consumption and CO₂, the market price range, map point, every picture in large size, and the dealer's rating details, opening hours and website. One more page per car, so a run takes longer. Off by default. Example: true

## `includeDealerPages` (type: `boolean`):

Also open each dealer's own page and add its profile to the dealer's cars: about us, legal notice, address, phone and fax, website, contact people, the brands and services it offers, opening hours, branches, its rating by category and its newest 10 reviews. One more page per dealer for each results page, so a run takes longer. Private sellers have no dealer page. Off by default. Example: true

## Actor input object example

```json
{
  "startUrls": [
    "https://www.autoscout24.de/lst/bmw/x3?atype=C&cy=D"
  ],
  "fuelType": "all",
  "gearbox": "all",
  "bodyType": "all",
  "sellerType": "all",
  "maxCarsPerSearch": 100,
  "includeDetails": false,
  "includeDealerPages": false
}
```

# Actor output Schema

## `cars` (type: `string`):

Every car the run saved, one row each.

## `allFields` (type: `string`):

The same rows with every field.

## `runReport` (type: `string`):

What happened to each input: items saved, nothing found, refused by the site, stopped at your limit, or the error.

# 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": [
        "https://www.autoscout24.de/lst/bmw/x3?atype=C&cy=D"
    ],
    "maxCarsPerSearch": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("luzivanlt/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": ["https://www.autoscout24.de/lst/bmw/x3?atype=C&cy=D"],
    "maxCarsPerSearch": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("luzivanlt/autoscout24-listings-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": [
    "https://www.autoscout24.de/lst/bmw/x3?atype=C&cy=D"
  ],
  "maxCarsPerSearch": 100
}' |
apify call luzivanlt/autoscout24-listings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,luzivanlt/autoscout24-listings-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/cUDffScAQ4t481eeZ/builds/7OGlS3ZnFvf0z4dLb/openapi.json
