# StandVirtual Scraper - Portuguese Car Listings (`studio-amba/standvirtual-scraper`) Actor Scrape car listings from StandVirtual.com, Portugal's #1 car marketplace. Extract prices in EUR, specs, mileage, fuel type, seller info, and photos. No login or cookies required. - **URL**: https://apify.com/studio-amba/standvirtual-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## StandVirtual Scraper Scrape car listings from [StandVirtual.com](https://www.standvirtual.com), Portugal's largest and most popular dedicated car marketplace with over 40,000 active listings at any time. Part of the OLX Auto group. ### Why use this scraper? - **Market research** -- Analyze the Portuguese used car market: prices, demand patterns, and inventory levels across makes and models. - **Price monitoring** -- Track price changes for specific vehicles over time to spot deals or understand depreciation curves in Portugal. - **Dealer intelligence** -- Identify active dealers (stands), their inventory size, pricing strategies, and geographic coverage across Portuguese districts. - **Competitive analysis** -- Compare pricing between private sellers (Particular) and professional dealers (Profissional) across Portugal. - **Import/export analysis** -- Understand price gaps between Portugal and other EU markets for arbitrage opportunities. Portuguese car prices in EUR make cross-border comparison straightforward. - **Fleet management** -- Source vehicles for fleet purchases by monitoring bulk availability and price drops. - **Data journalism** -- Build datasets on Portuguese automotive market trends, popular models, fuel type transitions, and regional price differences. - **Academic research** -- Study consumer behavior, pricing dynamics, and market efficiency in Portugal's car market. ### How to scrape StandVirtual data 1. **Create an Apify account** -- Sign up at [apify.com](https://apify.com) (free tier available). 2. **Open the StandVirtual Scraper** -- Navigate to this actor's page in the Apify Store. 3. **Configure your search** -- Enter a search query (e.g., "volkswagen golf"), or use the Make and Model fields for precise filtering. Set year range, price range, and fuel type as needed. 4. **Set result limits** -- Choose how many listings you want (default: 100). More results take longer but give a more complete picture. 5. **Run the actor** -- Click "Start" and wait for the run to complete. Most searches finish within 1-5 minutes. 6. **Download your data** -- Export results as JSON, CSV, or Excel from the Dataset tab. Integrate via API for automated workflows. ### Input parameters | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | `searchQuery` | string | Free text search (e.g., "volkswagen golf", "renault clio", "bmw 320d") | `volkswagen` | | `make` | string | Car manufacturer (e.g., volkswagen, bmw, renault, peugeot, mercedes-benz) | -- | | `model` | string | Car model (e.g., golf, clio, 320, a4, corsa). Use with Make. | -- | | `yearFrom` | integer | Minimum year of first registration | -- | | `yearTo` | integer | Maximum year of first registration | -- | | `priceFrom` | integer | Minimum price in EUR | -- | | `priceTo` | integer | Maximum price in EUR | -- | | `fuelType` | string | Fuel type: gasolina, diesel, electric, hibrido, gpl | All | | `maxResults` | integer | Maximum listings to return (1-2000) | 100 | | `proxyConfiguration` | object | Proxy settings (PT residential recommended) | Apify Residential PT | ### Output example Each listing produces a JSON object like this: ```json { "listingTitle": "Volkswagen Golf 1.6 TDi Confortline", "make": "Volkswagen", "model": "Golf 1.6 TDi Confortline", "year": 2019, "price": 18500, "currency": "EUR", "mileage": 98000, "fuelType": "Diesel", "transmission": "Manual", "engineSize": "1598 cm3", "power": "115 cv", "location": "Lisboa", "sellerType": "Profissional", "imageUrl": "https://ireland.apollo.olxcdn.com/...", "url": "https://www.standvirtual.com/carros/anuncio/volkswagen-golf-...", "scrapedAt": "2026-06-09T14:30:00.000Z" } ```` ### Data fields | Field | Type | Description | |-------|------|-------------| | `listingTitle` | string | Full title as shown on the listing | | `make` | string | Car manufacturer | | `model` | string | Car model name and variant | | `year` | integer | Year of first registration | | `price` | number | Price in EUR | | `currency` | string | Always "EUR" | | `mileage` | integer | Odometer reading in kilometers | | `fuelType` | string | Gasolina, Diesel, Eletrico, Hibrido, or GPL | | `transmission` | string | Automatica (automatic) or Manual | | `engineSize` | string | Engine displacement (e.g., "1968 cm3") | | `power` | string | Engine power (e.g., "150 cv" or "110 kW") | | `location` | string | Seller location in Portugal (district or city) | | `sellerType` | string | "Particular" (private) or "Profissional" (dealer) | | `imageUrl` | string | Main listing photo URL | | `url` | string | Direct link to the listing on StandVirtual.com | | `scrapedAt` | string | ISO 8601 timestamp of when the data was collected | ### Cost estimate The scraper uses Playwright to render pages. Typical costs on the Apify platform: - **50 listings** -- ~$0.10-0.15 (under 1 minute) - **200 listings** -- ~$0.30-0.50 (2-4 minutes) - **1000 listings** -- ~$1.00-2.00 (10-20 minutes) Costs depend on proxy usage and the number of pages loaded. Portuguese residential proxies are recommended for reliable access. ### Tips and advanced options - **Empty input works** -- Running the actor with no input will search for "volkswagen" by default and return up to 100 listings. - **Make + Model is more precise** -- Using the Make and Model fields produces more targeted results than a free text search query. - **Combine filters** -- Use year range + fuel type + price range together for highly specific searches. - **EUR pricing** -- StandVirtual lists all car prices in EUR, making it straightforward to compare with other EU car marketplaces. - **Popular makes in Portugal** -- Renault, Peugeot, Volkswagen, BMW, Mercedes-Benz, Audi, Opel, Citroen, Seat, and Toyota are the most listed brands. - **Proxy selection** -- Portuguese residential proxies (PT) give the best results. The default configuration is pre-set for this. - **Large datasets** -- For scraping the full market (10,000+ listings), run multiple searches by make to stay within rate limits and the 500-page pagination limit. - **API integration** -- Use the Apify API to schedule regular runs and feed data into your database, Google Sheets, or BI tools. ### FAQ **Is web scraping StandVirtual.com legal?** This actor scrapes publicly available data that anyone can see without logging in. It respects robots.txt and does not bypass authentication. Ensure your use case complies with applicable laws and the site's terms of service. **Do I need a StandVirtual account?** No. This scraper accesses only public listing data. No login, cookies, or account credentials are required. **How does the scraper handle anti-bot protection?** The actor uses Playwright with anti-detection measures including realistic browser fingerprinting, Portuguese Accept-Language headers, and residential proxies. It navigates the site like a real user. **Can I scrape specific car brands?** Yes. Use the Make input field (e.g., "renault", "bmw", "peugeot") optionally combined with Model for precise filtering. **What if I get zero results?** Check that your search terms match cars available on StandVirtual.com. Ensure proxy configuration is set to PT residential proxies. Try broader search terms or use common Portuguese market makes like Renault, Volkswagen, or Peugeot. **How often is the data updated?** StandVirtual listings change constantly as new cars are listed and sold ones are removed. Run the scraper as often as needed -- daily runs are common for price monitoring. **Can I export to CSV or Excel?** Yes. After the run completes, go to the Dataset tab and click Export. Choose JSON, CSV, Excel, XML, or other formats. ### About StandVirtual.com StandVirtual.com is Portugal's largest dedicated online car marketplace, part of the OLX Auto group (which also operates Autovit.ro in Romania and similar platforms across Europe). With millions of monthly visits, it is the go-to platform for both private sellers and professional car dealers (stands) across Portugal. The site lists tens of thousands of vehicles at any given time, from budget daily drivers to luxury and performance cars. The platform offers detailed filtering by make, model, year, mileage, fuel type, price range, location, and many other parameters. Listings include photos, detailed technical specifications, seller contact information, and pricing in EUR. StandVirtual is the primary price reference for the Portuguese car market and a key resource for anyone involved in buying, selling, or analyzing vehicles in Portugal. Portugal's car market has strong demand for diesel vehicles, French brands (Renault, Peugeot, Citroen), and is seeing growing interest in electric and hybrid vehicles. The country's position as a gateway between Europe and the Atlantic makes it an interesting market for vehicle import/export analysis. # Actor input Schema ## `searchQuery` (type: `string`): Free text search for cars (e.g., 'volkswagen golf', 'bmw 320', 'renault clio'). Used when Make is not specified. ## `make` (type: `string`): Car manufacturer (e.g., volkswagen, bmw, audi, renault, mercedes-benz, peugeot, toyota). Overrides search query for precise filtering. ## `model` (type: `string`): Car model (e.g., golf, 320, clio, a4, corsa). Must be used together with Make. ## `yearFrom` (type: `integer`): Minimum year of first registration (e.g., 2015). ## `yearTo` (type: `integer`): Maximum year of first registration (e.g., 2024). ## `priceFrom` (type: `integer`): Minimum price in EUR. ## `priceTo` (type: `integer`): Maximum price in EUR. ## `fuelType` (type: `string`): Filter by fuel type. ## `maxResults` (type: `integer`): Maximum number of car listings to scrape. ## `proxyConfiguration` (type: `object`): Proxy settings. Portuguese residential proxies recommended for best results. ## Actor input object example ```json { "searchQuery": "volkswagen", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PT" } } ``` # 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 = { "searchQuery": "volkswagen", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PT" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/standvirtual-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 = { "searchQuery": "volkswagen", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "PT", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/standvirtual-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 '{ "searchQuery": "volkswagen", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "PT" } }' | apify call studio-amba/standvirtual-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/standvirtual-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "StandVirtual Scraper - Portuguese Car Listings", "description": "Scrape car listings from StandVirtual.com, Portugal's #1 car marketplace. Extract prices in EUR, specs, mileage, fuel type, seller info, and photos. No login or cookies required.", "version": "0.1", "x-build-id": "R0yqYOLjwj1pTqnsk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~standvirtual-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-standvirtual-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/studio-amba~standvirtual-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-standvirtual-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/studio-amba~standvirtual-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-standvirtual-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Free text search for cars (e.g., 'volkswagen golf', 'bmw 320', 'renault clio'). Used when Make is not specified." }, "make": { "title": "Make", "type": "string", "description": "Car manufacturer (e.g., volkswagen, bmw, audi, renault, mercedes-benz, peugeot, toyota). Overrides search query for precise filtering." }, "model": { "title": "Model", "type": "string", "description": "Car model (e.g., golf, 320, clio, a4, corsa). Must be used together with Make." }, "yearFrom": { "title": "Year From", "minimum": 1950, "maximum": 2035, "type": "integer", "description": "Minimum year of first registration (e.g., 2015)." }, "yearTo": { "title": "Year To", "minimum": 1950, "maximum": 2035, "type": "integer", "description": "Maximum year of first registration (e.g., 2024)." }, "priceFrom": { "title": "Price From (EUR)", "minimum": 0, "type": "integer", "description": "Minimum price in EUR." }, "priceTo": { "title": "Price To (EUR)", "minimum": 0, "type": "integer", "description": "Maximum price in EUR." }, "fuelType": { "title": "Fuel Type", "enum": [ "", "gasolina", "diesel", "electric", "hibrido", "gpl" ], "type": "string", "description": "Filter by fuel type." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of car listings to scrape.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Portuguese residential proxies recommended for best results." } } }, "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 } } } } } } } } } } ```