🚗 Standvirtual Scraper

Want to find the perfect car or analyze the used car market in Portugal? This scraper makes it super easy!

Paste an input_url from your browser once you've already filtered on Standvirtual, or use structured filters (make, model, price, mileage, year, fuel, gearbox, body type) — structured filters work better for AI agents. When input_url is set it overrides the filters. Either way, you get up to 1000 car listings with technical specifications, pricing, and seller details as CSV or JSON.

💡 Perfect for...

• Car Buyers: Monitor the market for the best deals on your dream car.
• Dealerships: Keep an eye on competitors' pricing and inventory to stay competitive.
• Market Research: Analyze trends in the Portuguese used car market (average prices, most popular models, mileage vs. price depreciation).
• Data Analysts: Download clean, structured data for visualizations, dashboards, or predictive pricing models.
• 🤖 OpenClaw & AI Agents: Power your autonomous agents with real-time car listings. Perfect for OpenClaw workflows and bots tracking specific vehicles.
• 📚 RAG Systems: Feed detailed car specifications and pricing into Retrieval-Augmented Generation pipelines to answer complex queries about the automotive market.
• 🔗 AI Workflows: Integrate seamlessly with LangChain, AutoGPT, CrewAI, and other AI frameworks that need structured automotive data.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste a Standvirtual search URL (input_url) if you already filtered in the browser, or use structured filters (better for AI agents). input_url always wins when set.
• 🎯 Structured Filters: Search by make, model, price, mileage, year, fuel, gearbox, and body type — no URL crafting required.
• ⚙️ Deep Specifications: Extracts not just the price, but detailed specs like engine power, capacity, fuel type, gearbox, mileage, and registration year.
• ⏱️ Sorting Options: Control how you traverse the results—from the newest listings to the lowest price or lowest mileage.
• 👤 Seller Insights: Distinguish between professional dealerships and private sellers.

📦 What's inside the data?

For every single car listing, you will get:

• Core Details: id, title, url, image, created_at, short_description
• Location: location_city, location_region
• Technical Specs: make, model, fuel_type, gearbox, mileage, engine_capacity, engine_power, first_registration_year
• Pricing & Seller: price, seller_type
• Promotional Status: is_premium_top_ad, is_highlighted, is_promoted

🛠️ Sort options

Sort (filter_by) uses the same options as Standvirtual (default: Anúncios Recomendados / relevance_web):

• relevance_web – Anúncios Recomendados
• created_at:desc – Destacado
• created_at_first:desc – Mais Recentes
• Price / KM / Power asc & desc (same ids as on the site)

🚀 Quick start

Option A — Input URL

1. Open Standvirtual, apply filters in the browser, copy the results URL.
2. Paste it into input_url.
3. Set max_cars and click Start.

Option B — Structured filters (better for AI agents)

1. Leave input_url empty.
2. Pick make/model/fuel/body from the dropdowns (same lists as on Standvirtual).
3. Choose filter_by and max_cars (up to 1000).
4. Click Start and export CSV, Excel, or JSON when done.

---

Tech details for developers 🧑‍💻

Input Example (structured filters):

{
  "make": "bmw",
  "model": "bmw:serie-3",
  "price_max": 25000,
  "year_min": 2018,
  "energy": "diesel",
  "gearbox": "automatic",
  "body_type": "sedan",
  "filter_by": "filter_float_price:asc",
  "max_cars": 100
}

Input Example (URL override):

{
  "input_url": "https://www.standvirtual.com/carros/mercedes-benz",
  "filter_by": "created_at_first:desc",
  "max_cars": 500
}

Output Example:

{
  "id": "8097373143",
  "title": "Peugeot 2008 1.2 PureTech Active Pack",
  "url": "https://www.standvirtual.com/carros/anuncio/peugeot-2008-ver-1-2-puretech-active-pack-ID8PZKED.html",
  "image": "https://ireland.apollo.olxcdn.com/v1/files/bhgdo59ox8k3-STDVTLPT/image;s=320x240",
  "created_at": "2026-03-16T16:08:17Z",
  "short_description": "peugeot 2008",
  "location_city": "Setúbal",
  "location_region": "Setúbal",
  "make": "peugeot",
  "model": "2008",
  "engine_code": null,
  "fuel_type": "gaz",
  "gearbox": "manual",
  "mileage": "30564",
  "engine_capacity": "1199",
  "engine_power": "102",
  "first_registration_year": "2024",
  "price": "17990",
  "seller_type": "ProfessionalSeller",
  "is_premium_top_ad": null,
  "is_highlighted": false,
  "is_promoted": false
}

Parameters:

Parameter	Type	Required	Description
input_url	string	No	Paste a Standvirtual search results URL; overrides all filters below when set. Leave empty to use filters (better for AI agents).
make	string enum	No	Brand slug from Standvirtual (e.g. bmw, mercedes-benz, vw).
model	string enum	No	make:model from Standvirtual (e.g. bmw:serie-3).
price_min / price_max	integer	No	Price range in euros.
mileage_min / mileage_max	integer	No	Mileage range in km.
year_min / year_max	integer	No	First-registration year range.
energy	string enum	No	Site fuel ids: gaz, diesel, electric, hibride-gaz, hibride-diesel, plugin-hybrid, gpl, gnc, hidrogen.
gearbox	string enum	No	manual or automatic.
body_type	string enum	No	Site segment ids: city-car, mini, compact, sedan, combi, suv, coupe, cabrio, minivan.
filter_by	string enum	No	Default relevance_web. See sort options above.
max_cars	integer	No	Max cars to scrape (20–1000, default: 500).