Standvirtual Portugal Car Marketplace Scraper

Extract detailed car listings from Standvirtual, Portugal's leading vehicle marketplace, covering cars, commercial vehicles and motorcycles. Every record includes pricing, mileage, engine specs, seller identity (private or dealer), location, photos and equipment — ready for market analysis, pricing research, or lead generation.

What it does

The actor walks Standvirtual's category listings and pulls the full record for every advert, including fields the search results page doesn't show — VIN reference, generation/trim, colour, doors/seats, transmission, body type, first registration date, seller identity and dealer URL, photo count, and the full equipment checklist.

Output fields

Field	Type	Description
advert_id	String	Standvirtual advert ID
url	String	Direct link to the advert
title	String	Advert title
short_description	String	Short listing description, if provided
price_amount	Number	Price
price_currency	String	Currency (EUR)
price_gross_net	String	"com IVA" (VAT included) or "sem IVA" (VAT excluded), when disclosed
price_evaluation	String	Standvirtual's price-vs-market rating, when present
make	String	Vehicle make
model	String	Vehicle model
version	String	Trim/version
generation	String	Generation/sub-model designation
year	Number	First registration year
mileage_km	Number	Mileage in kilometres
fuel_type	String	Fuel type
engine_capacity_cm3	Number	Engine displacement (cc)
engine_power_cv	Number	Engine power (cv)
gearbox	String	Manual / Automatic
transmission	String	Drivetrain (e.g. front/rear-wheel drive)
body_type	String	Body style
doors	Number	Number of doors
seats	Number	Number of seats
colour	String	Exterior colour
vin	String	VIN reference token, when the seller publishes it
first_registration_date	String	First registration date (YYYY-MM or YYYY)
country_of_origin	String	National / imported flag, when disclosed
accident_free	Boolean	Accident-free flag, when disclosed
damaged	Boolean	Damage flag, when disclosed
service_record	Boolean	Service history flag, when disclosed
seller_type	String	particular (private) or stand (dealer)
seller_name	String	Seller or dealership name
seller_id	String	Standvirtual seller ID
dealer_url	String	Dealer's storefront URL, for dealer listings
location_city	String	Listing city
location_district	String	Listing district (distrito)
category	String	carros, comerciais, or motos
photo_count	Number	Number of photos on the advert
thumbnail_url	String	Thumbnail image URL
published_at	String	Original publish timestamp
is_promoted	Boolean	Whether the advert is a promoted/featured listing
features	Array	Flat list of equipment/feature labels

Input

Parameter	Type	Default	Description
maxItems	Integer	5	Required. Maximum number of records to return
categories	Array	All three	Vehicle categories to crawl: carros (cars), comerciais (commercial vehicles), motos (motorcycles). Leave empty to crawl all three.

Example input

{
  "maxItems": 200,
  "categories": ["carros"]
}

To crawl the full catalogue (cars, commercial vehicles, and motorcycles):

{
  "maxItems": 500
}

Resuming a large crawl

Every run emits a resumeCursor in its Output. If a large crawl stops before it finishes — because it hit maxItems, your spend cap (maxTotalChargeUsd), or was aborted — start a new run with the same input plus that resumeCursor to continue from where it left off. The crawl resumes from the queued work the previous run didn't reach.

• You are not re-charged for records the earlier run already delivered.
• Resume within your account's run-retention window — on the free tier, roughly your 10 most recent runs. Once the source run is pruned, its resumeCursor is no longer valid.
• resumeCursor is opaque — supply it unmodified.

Notes

• Language: Listing titles, descriptions, and equipment labels are in Portuguese.
• Prices are in EUR.
• Some detail fields (VAT flag, accident/damage/service-history flags, country of origin) only appear when the seller chooses to disclose them — expect nulls on adverts that omit them.
• features returns a flat array; parse it directly, no JSON decoding required.