# AutoScout24 Scraper (`anyxsolutions/autoscout24-scraper`) Actor Scrapes car listings and offer pages from AutoScout24, returning prices, make and model, mileage, first registration, fuel, transmission, seller and location details. - **URL**: https://apify.com/anyxsolutions/autoscout24-scraper.md - **Developed by:** [Anyx Solutions](https://apify.com/anyxsolutions) (community) - **Categories:** - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 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. 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? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ![banner](generated) ## AutoScout24 Scraper **Car listings and offer details from Europe's largest car marketplace — no login, no API key.** Scrapes car listings and offer pages from AutoScout24, returning prices, make and model, mileage, first registration, fuel, transmission, seller and location details. Point it at any AutoScout24 search (by make, model, body type, price band or region) or at individual offer pages, on any country site (.com, .de, .it, .fr, .es, .nl, .be, .at, .ch), and get clean JSON, CSV or Excel back. Built for dealers, pricing analysts, market researchers and lead-generation teams. ### ⚡ Quick start ```json { "startUrls": [{ "url": "https://www.autoscout24.com/lst/c/compact" }], "maxItems": 5 } ``` ### 🧩 Input | Field | Type | Required | Default | Description | | -------------------- | ------- | -------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `startUrls` | array | yes | — | AutoScout24 URLs to scrape. Search result pages (`/lst/...`) and single offer pages (`/offers/...`) are both supported, on any country site. | | `maxItems` | integer | no | `5` | Maximum number of listings to return per start URL. Search pages are followed until this many cars have been collected. | | `proxyConfiguration` | object | no | `{ "useApifyProxy": false }` | Apify proxy settings. AutoScout24 serves full pages without a proxy, so proxies are disabled by default. | ### 📤 Output Every result is one dataset row. The `itemType` field tells the two shapes apart: `listing` for a card from a search page, `detail` for a full offer page. Both carry the site's own nested objects (`price`, `vehicle`, `location`, `seller`, ...) unchanged, so every attribute AutoScout24 shows is available. #### Fields | Field | Type | Description | | ---------------------------- | ------- | ------------------------------------------------------------------------------------------------------------ | | `itemType` | string | `listing` or `detail`. | | `listingUrl` | string | Absolute URL of the offer page. | | `id` | string | AutoScout24 listing ID (UUID). | | `identifier` | object | `legacyId` and `crossReferenceId` for the listing. | | `crossReferenceId` | string | Dealer's own reference number for the car (listings only). | | `images` | array | Image URLs. | | `ocsImagesA` | array | Additional image URLs for online-checkout listings (listings only). | | `isOfferNew` | boolean | Whether the offer was published recently (listings only). | | `price` | object | `priceFormatted`, `priceRaw`, `suggestedRetailPrice` and related price flags. | | `availableNow` | boolean | Whether the car is available immediately (listings only). | | `availability` | object | Availability and delivery details. | | `superDeal` | object | Super-deal badge details, when the listing carries one. | | `url` | string | Site-relative path of the offer page (listings only). | | `vehicle` | object | `make`, `model`, `modelVersionInput`, `transmission`, `fuel`, `mileageInKm`, `offerType` and more. | | `location` | object | `countryCode`, `zip`, `city`, `street` of the car. | | `ratings` | object | Dealer rating summary, when available. | | `seller` | object | `id`, `type`, `companyName`, `contactName`, phones and dealer links. | | `appliedAdTier` | string | Ad tier the listing was shown with. | | `adTier` | string | Ad tier purchased for the listing. | | `isOcs` | boolean | Whether the listing supports online checkout (listings only). | | `specialConditions` | array | Special conditions or promotions on the listing. | | `statistics` | object | View and search statistics for the listing. | | `searchResultType` | string | `Organic` or a sponsored placement type. | | `searchResultSection` | string | Section of the results page the card appeared in (listings only). | | `tracking` | object | `firstRegistration`, `mileage`, `price` and other tracking attributes (listings only). | | `coverImageAttractiveness` | number | Site-computed quality score of the cover image. | | `vehicleDetails` | array | Key facts as shown on the card: mileage, gearbox, first registration, fuel, power (listings only). | | `wltpValues` | array | WLTP consumption and emission values (listings only). | | `isListingBoost` | boolean | Whether the listing was boosted. AutoScout24 no longer publishes this flag, so it is `null` (listings only). | | `trackingParameters` | array | Tracking parameters attached to the card (listings only). | | `isDeliverable` | boolean | Whether the car can be delivered (details only). | | `description` | string | Seller's full description as HTML (details only). | | `headerImage` | string | Main image URL (details only). | | `youtubeLink` | string | YouTube video URL, when provided (details only). | | `twinnerUrl` | string | 360° tour URL, when provided (details only). | | `isCoverImagePlaceholder` | boolean | Whether the cover image is a placeholder (details only). | | `hasThreeSixtyContent` | boolean | Whether a 360° view exists (details only). | | `vehicleReport` | object | Vehicle history report details, when available (details only). | | `threeSixty` | object | 360° view details, when available (details only). | | `prices` | object | Public and dealer price variants (details only). | | `financingFlags` | object | Financing options offered (details only). | | `seals` | object | Quality seals attached to the car (details only). | | `whatsappNumber` | string | Seller's WhatsApp number (details only). | | `webPage` | string | Seller's website (details only). | | `status` | string | Listing status, e.g. `active` (details only). | | `leasingDetails` | object | Leasing offer details, when available (details only). | | `warranty` | object | Warranty details, when available (details only). | | `warrantyExists` | boolean | Whether a warranty is offered (details only). | | `ocsInfo` | object | Online-checkout details (details only). | | `financingAndInsurance` | object | Financing and insurance offers (details only). | | `trackingParams` | object | Tracking attributes of the offer page (details only). | | `hasPremiumListingTreatment` | boolean | Whether the listing has premium presentation (details only). | | `adTargetingString` | string | Ad-targeting attributes of the car (details only). | | `imgAltText` | string | Alt text of the main image (details only). | | `createdTimestampWithOffset` | string | When the listing was created, ISO 8601 (details only). | | `vehicleType` | string | Vehicle category, e.g. `C` for cars (details only). | | `searchTrackingParams` | array | Search tracking attributes (details only). | | `articleType` | string | Article type, e.g. `Car` (details only). | | `isNew` | boolean | Whether the car is new rather than used (details only). |
Example output ```json { "itemType": "listing", "listingUrl": "https://www.autoscout24.com/offers/ford-fiesta-champions-edition-klima-allwetterreifen-gasoline-silver-8847adc0-b2af-4069-867d-9a4fcd58acc4", "id": "8847adc0-b2af-4069-867d-9a4fcd58acc4", "crossReferenceId": "PI-2255", "price": { "priceFormatted": "€ 2,900", "priceRaw": 2900 }, "vehicle": { "make": "Ford", "model": "Fiesta", "transmission": "Manual", "fuel": "Gasoline", "mileageInKm": "98,000 km" }, "location": { "countryCode": "DE", "zip": "25421", "city": "Pinneberg", "street": "Elmshorner Str. 146" }, "seller": { "id": "46992491", "type": "Dealer", "companyName": "H&S Automobile Hamburg GmbH" }, "tracking": { "firstRegistration": "09-2012", "mileage": "98000" }, "searchResultType": "Organic" } ```
### 💡 Use cases - **Price monitoring** — track asking prices for a make and model across countries and spot under-priced cars the moment they are listed. - **Dealer intelligence** — build inventories of competing dealers, with contact details and stock turnover. - **Market research** — measure supply, mileage and age distributions per segment, fuel type or region. - **Lead generation** — collect dealer names, phones and websites across a category. ### ❓ FAQ - **Do I need a proxy?** No. AutoScout24 serves full pages without one, so proxies are off by default. You can still set one in `proxyConfiguration`. - **How many results can I get from one search?** AutoScout24 shows at most 20 pages per search, roughly 380 cars. Narrow the search (make, model, price band, region) and add several start URLs to go beyond that. - **Which country sites work?** All of them — .com, .de, .it, .fr, .es, .nl, .be, .at, .ch and the rest. Prices and texts come back in the language of the site you use. - **Why did a run return fewer items than expected?** The site may have changed its layout. Open an issue and we will update the Actor. ### 🔗 More scrapers by Anyx - [Kleinanzeigen Scraper](https://apify.com/anyxsolutions/kleinanzeigen) - [Google Play Store Scraper](https://apify.com/anyxsolutions/google-play-scraper) - [Indeed Scraper](https://apify.com/anyxsolutions/indeed-scraper) - [Glassdoor Scraper](https://apify.com/anyxsolutions/glassdoor-scraper) ### 🤝 Anyx Solutions We build custom scrapers and data-extraction pipelines. - Email: tantosthor@gmail.com ### 🖼 Image credit Image credit: [autoscout24.com](https://www.autoscout24.com/) # Actor input Schema ## `startUrls` (type: `array`): AutoScout24 URLs to scrape. Search result pages such as https://www.autoscout24.com/lst/c/compact and single offer pages such as https://www.autoscout24.com/offers/... are both supported, on any country site (.com, .de, .it, .fr, .es, .nl, .be, .at, .ch). ## `maxItems` (type: `integer`): Maximum number of listings to return per start URL. Search pages are followed until this many cars have been collected. ## `proxyConfiguration` (type: `object`): Apify proxy settings used for the run. AutoScout24 serves full pages without a proxy, so proxies are disabled by default. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.autoscout24.com/lst/c/compact" } ], "maxItems": 5, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.autoscout24.com/lst/c/compact" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("anyxsolutions/autoscout24-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.autoscout24.com/lst/c/compact" }] } # Run the Actor and wait for it to finish run = client.actor("anyxsolutions/autoscout24-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": [ { "url": "https://www.autoscout24.com/lst/c/compact" } ] }' | apify call anyxsolutions/autoscout24-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,anyxsolutions/autoscout24-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 ` 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/JEkJfiTlQrQgPB9yB/builds/5TPcLpj1ETrayZKAT/openapi.json