# Vroom.be Belgian Car Listings Scraper (`rainminer/vroom-be-scraper`) Actor Scrape public used car listings from Vroom.be in Belgium. Export make, model, price, year, mileage, fuel, transmission, and listing URLs to JSON or CSV for automotive market research, dealer monitoring, and lead generation — no login required. - **URL**: https://apify.com/rainminer/vroom-be-scraper.md - **Developed by:** [rainminer](https://apify.com/rainminer) (community) - **Categories:** Travel, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.49 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#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 ## Vroom.be Scraper Scrape **used and new car listings from [vroom.be](https://www.vroom.be/)** — Belgium's popular online car marketplace. Extract price, make, model, year, mileage, fuel type, dealer info, images, and much more. Export results as **JSON, CSV, or Excel** via the Apify platform with zero coding required. ### What does Vroom.be Scraper do? Vroom.be Scraper lets you extract structured car data from [vroom.be](https://www.vroom.be/) at scale. Provide one or more search URLs — such as a brand page like `https://www.vroom.be/nl/aanbod/bmw` or the full used-car listing at `https://www.vroom.be/nl/aanbod/tweedehands-autos` — and the Actor pages through all results, collecting detailed information about every listing up to your configured limit. No browser automation is needed. The Actor queries the vroom.be portal API directly, making it fast and cost-efficient. ### What data can Vroom.be Scraper extract? | Field | Description | | ------------------------------------------- | --------------------------------------- | | `id` | Unique listing identifier | | `title` | Full listing title | | `brand` / `model` | Make and model name | | `version` | Trim / version label | | `year` | Registration year | | `price` | Price in EUR (numeric) | | `priceFormatted` | Price as formatted string | | `mileage` | Odometer reading in km | | `fuel` | Fuel type (petrol, diesel, electric, …) | | `transmission` | Manual or automatic | | `bodyType` | Sedan, SUV, hatchback, … | | `horsepower` | Engine power in HP | | `co2` | CO₂ emission (g/km) | | `doors` | Number of doors | | `warrantyMonths` | Dealer warranty (months) | | `dealerName` / `dealerCity` / `dealerPhone` | Seller contact info | | `images` | Array of full-resolution image URLs | | `vin` | Vehicle Identification Number | | `listingUrl` | Direct link to the vroom.be listing | | `searchUrl` | The start URL that produced this result | ### Why scrape vroom.be? - **Market research** — track price trends for specific brands or models across Belgium - **Price comparison** — build dashboards that monitor listings and alert on price drops - **Inventory monitoring** — detect new cars from specific dealers or segments - **Data analysis** — analyse depreciation, popular body types, or regional pricing differences - **Lead generation** — identify newly listed vehicles before the competition ### How to scrape vroom.be 1. **Open** the [Vroom.be Scraper](https://apify.com/your-username/vroom-be-scraper) page on Apify Store and click **Try for free**. 2. **Set Start URLs** — paste one or more vroom.be search URLs: - All used cars: `https://www.vroom.be/nl/aanbod/tweedehands-autos` - Brand-filtered: `https://www.vroom.be/nl/aanbod/bmw` - French language: `https://www.vroom.be/fr/offres` 3. **Set Maximum Items** — for a quick test, keep this at 5–20. For a full run set it to 1 000+. 4. **Run** the Actor and wait for it to finish. 5. **Download** results from the **Dataset** tab in JSON, CSV, or Excel format. ### Input | Field | Type | Description | | -------------------- | ------------- | ------------------------------------------------ | | `startUrls` | Array of URLs | vroom.be search pages (brand or generic listing) | | `maxItems` | Integer | Maximum results per start URL (default: 5) | | `proxyConfiguration` | Object | Proxy settings (default: no proxy) | ### Output example ```json { "id": "123456", "title": "BMW 320d Touring", "version": "Sport Line", "brand": "BMW", "model": "3 Series", "year": 2021, "price": 29950, "priceFormatted": "€ 29.950", "currency": "EUR", "mileage": 45000, "mileageFormatted": "45.000 km", "fuel": "Diesel", "transmission": "Automatic", "bodyType": "Break", "doors": 5, "horsepower": 190, "co2": 118, "warrantyMonths": 12, "isNew": false, "dealerName": "Autobedrijf Example", "dealerCity": "Antwerpen", "dealerPhone": "+32 3 123 45 67", "images": [ "https://cdn.vroomsupport.be/abc123", "https://cdn.vroomsupport.be/def456" ], "vin": "WBA1234567890ABCDE", "listingUrl": "https://www.vroom.be/nl/tweedehands-autos/bmw-320d-touring-45000km-2021-123456", "searchUrl": "https://www.vroom.be/nl/aanbod/tweedehands-autos" } ``` ### How much does it cost to scrape vroom.be? Vroom.be Scraper uses the **Apify consumption pricing model** (Compute Units). A typical run that collects **100 listings** costs well under $0.01 of compute time, making large-scale runs very affordable. New Apify accounts come with a **free monthly allowance** of Compute Units, so you can test the scraper at no cost. ### Is it legal to scrape vroom.be? Our scraper only collects **publicly available data** — the same information any visitor sees when browsing vroom.be without an account. It does not require login credentials or bypass any authentication. Web scraping publicly available data is generally considered legal in most jurisdictions. You should always comply with the website's Terms of Service and applicable data protection regulations (GDPR in Belgium/EU). If you plan to process personal data (dealer phone numbers, etc.), ensure you have a legitimate legal basis. ### FAQ **Can I scrape by brand?** Yes. Use a brand-specific search URL such as `https://www.vroom.be/nl/aanbod/volkswagen`. The Actor automatically extracts the brand slug and filters the API results accordingly. **Can I scrape French-language listings?** Yes. The `/fr/offres` path is fully supported, e.g. `https://www.vroom.be/fr/offres`. **Why is the scraper fast?** The Actor uses `CheerioCrawler` with `skipNavigation` — it never loads a browser. All listing data is fetched directly from the vroom.be portal API, so no JavaScript rendering is needed. **What if a field is missing?** All fields in the output are nullable. If vroom.be does not return a value for a particular field (e.g. `co2` or `warrantyMonths`), the field will be `null` in the dataset. **Can I schedule this scraper?** Yes. Use Apify's built-in scheduling feature to run the scraper automatically on a daily or weekly basis and monitor price changes over time. ### Support Open an issue on this Actor's **Issues** tab on Apify Store or contact the maintainer through the Apify platform. Feedback and pull requests are welcome. ### Image Credit Image credit: [vroom.be](https://www.vroom.be/) # Actor input Schema ## `startUrls` (type: `array`): vroom.be search URLs (e.g. https://www.vroom.be/nl/aanbod/tweedehands-autos or https://www.vroom.be/nl/aanbod/bmw) or individual car listing URLs. ## `maxItems` (type: `integer`): Maximum number of car listings to return per start URL. ## `proxyConfiguration` (type: `object`): Proxy settings. The scraper works without a proxy in most regions. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.vroom.be/nl/aanbod/tweedehands-autos" } ], "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.vroom.be/nl/aanbod/tweedehands-autos" } ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("rainminer/vroom-be-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.vroom.be/nl/aanbod/tweedehands-autos" }], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("rainminer/vroom-be-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.vroom.be/nl/aanbod/tweedehands-autos" } ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call rainminer/vroom-be-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=rainminer/vroom-be-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/acts/0ugYOWzdrxf5rYuf4/builds/u6NlRgwLRO5XxS4wv/openapi.json