🇧🇷 Webmotors Scraper

Want Webmotors stock in a spreadsheet? This scraper makes it easy.

Use structured filters (type, make, state, year, price, transmission, fuel) — better for AI agents — or paste an input_url. When input_url is set it overrides the filters.

Webmotors lists 400,000+ vehicles. This actor reads the public stock search API and returns up to 2000 rows per run.

💡 Perfect for...

• Agents: Export Toyota stock or São Paulo listings without paging the site.
• Dashboards: Track make, year, price, and seller city.
• Market research: Slice cars vs motorcycles, transmission, and fuel.
• Data analysts: Export structured Webmotors rows with public listing URLs.
• 🤖 AI Agents: Power Claude, Cursor, Codex, the Hermes Agent, and OpenClaw workflows with live Webmotors results.
• 📚 RAG Systems: Feed titles, versions, and cities into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste /carros/estoque/toyota (input_url) or use dropdowns. input_url always wins when set.
• 🎯 Website-Matched Filters: Same stock path, estadocidade, precode / precoate, anofabricacaode / anofabricacaoate, cambio, and combustivel as webmotors.com.br.
• 🌐 Nationwide: São Paulo, Rio, Minas, Paraná, and other state slugs.

📦 What's inside the data?

id, url, title, make, model, version, year, price, currency (BRL), mileage_km, transmission, fuel, color, city, state, seller, image_url

🚀 Quick start

Option A: paste https://www.webmotors.com.br/carros/estoque/toyota. Option B: vehicle type carros, make toyota, state sao-paulo.

Input Example:

{ "vehicle_type": "carros", "make": "toyota", "state": "sao-paulo", "max_results": 100 }

Output Example:

{
  "id": "51234567890",
  "url": "https://www.webmotors.com.br/comprar/toyota/corolla/51234567890",
  "title": "TOYOTA COROLLA 2.0 XEI 16V FLEX 4P AUTOMÁTICO",
  "make": "TOYOTA",
  "model": "COROLLA",
  "version": "2.0 XEI 16V FLEX 4P AUTOMÁTICO",
  "year": 2021,
  "price": 119900,
  "currency": "BRL",
  "mileage_km": 45210,
  "transmission": "Automática",
  "color": "Branco",
  "city": "São Paulo",
  "state": "São Paulo",
  "seller": "Toyota Store"
}

Output fields:

Field	Description
id	Webmotors listing id.
url	Public vehicle page.
title	Full listing title.
make	Make name.
model	Model name.
version	Version or trim.
year	Model or manufacture year.
price	Asking price when shown.
currency	Always BRL.
mileage_km	Odometer in kilometres.
transmission	Gearbox label.
fuel	Fuel type when shown.
color	Exterior colour.
city	Seller city.
state	Seller state.
seller	Dealer or seller name.
image_url	First photo.

📋 Input reference

Parameter	Type	Required	Default	Description
input_url	string	No	—	Stock URL; overrides filters.
vehicle_type	string enum	No	carros	carros, motos.
make	string enum	No	all	chevrolet, volkswagen, fiat, toyota, hyundai, honda, jeep, renault, nissan, ford, bmw, mercedes-benz, byd, cao-a-chery, peugeot, mitsubishi.
state	string enum	No	all	sao-paulo, rio-de-janeiro, minas-gerais, parana, rio-grande-do-sul, santa-catarina, bahia, goias, pernambuco, ceara, distrito-federal.
transmission	string enum	No	any	automatica, manual, cvt, automatizada.
fuel	string enum	No	any	flex, gasolina, diesel, etanol, hibrido, eletrico.
year_min / year_max	integer	No	—	Same anofabricacaode / anofabricacaoate filters.
price_min / price_max	integer	No	—	Same precode / precoate filters (BRL).
query	string	No	—	Optional keyword (lcp).
max_results	integer	No	50	Maximum rows (1–2000).