Webmotors Scraper

Disclaimer: Unofficial tool — not affiliated with, sponsored by, or endorsed by Webmotors S.A. or its affiliates. Data is read from publicly accessible search results only. No login. You are responsible for complying with applicable law (including LGPD and GDPR where personal data appears) and the site’s terms. No warranty on accuracy or availability. Provided for informational and research use.

Webmotors scraper for used and new car listings in Brazil. Each row is a public search card: asking price in BRL, mileage, year, city, seller type (private or dealer), and FIPE percent when the card includes it. Use it as a Webmotors API alternative from Python, Node.js, cURL, or Apify MCP.

Best for: dealer comps on one model, a city inventory check, and a scheduled run that saves only new ads and price changes.

Actor	Role
Webmotors Scraper ◄── you are here	Brazil car listings, FIPE percent, price monitor
Cars.com Scraper	US used, new, and CPO inventory
mobile.de Scraper	Germany vehicle listings
Car-Part Scraper	US recycler parts inventory

When to use this Actor

• One model in a state — Set make, model, and state. Leave city empty to cover the state.
• A filtered search you already built — Paste the search URL. Make and state are ignored when Search URLs is set.
• Price versus FIPE — fipePercent is the asking price as a percent of the FIPE reference. Some cards omit it.
• New ads and price cuts — Turn on monitor mode and schedule the same search. The first run stores a baseline and saves nothing. Later runs save new listing ids and price changes.

When not to use this Actor

• Seller phone or tax id — Those are not read. Comments that contain a phone or CPF are stripped before the row is saved.
• A national dump in one run — Cap maxItems (250). Split by state or model.
• US or German inventory — Use Cars.com Scraper or mobile.de Scraper.

Key features

• Search cards — One request returns up to 24 listings. Default 256 MB. No browser.
• FIPE percent on the card — Integer percent when the search payload includes it.
• Make, model, state, or a pasted URL — Price, year, and mileage filters are optional.
• Private versus dealer — sellerType is PF or PJ.
• Monitor — Named key-value store of listing id and last price for that search.

Input

Field	Required	Default	What it does
Search URLs	No	Gol in São Paulo state	Search page. Wins over the filters below.
Make	No	—	Brand when Search URLs is empty.
Model	No	—	Model, used together with Make.
State	No	SP	Brazilian state code.
City	No	—	City inside that state. Empty means the whole state.
Vehicle type	No	All cars	All, used, or new.
Min / max price	No	—	Asking price in BRL.
Min / max year	No	—	Model year.
Max mileage	No	—	Kilometers.
Maximum listings	No	25	Cards to read, up to 250.
Monitor mode	No	off	Baseline first, then new ids and price changes.
Monitor state store	No	webmotors-monitor	Named store for the baseline.
Proxy	Yes	Brazil residential	Datacenter IPs are blocked.

{
  "make": "VOLKSWAGEN",
  "model": "GOL",
  "state": "SP",
  "vehicleType": "all",
  "maxItems": 25,
  "monitorMode": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "BR"
  }
}

Output

Field	Meaning
id	Listing id
url	Public listing page
title	Card title
make, model, version	Brand, model, trim
yearFabrication, yearModel	Year built and model year
odometer	Kilometers
transmission, doors, bodyType, color	Specs from the card
price	Asking price in BRL
fipePercent	Asking price as a percent of FIPE. Omitted when the card has none
sellerType	PF private or PJ dealer
city, stateCode	Location
photo	First photo
changeType	new or price_change on monitor runs
previousPrice	Prior asking price when changeType is price_change
scrapedAt	UTC timestamp

{
  "id": "74012141",
  "url": "https://www.webmotors.com.br/comprar/volkswagen/gol/1-6-mi-city-8v-flex-4p-manual/4-portas/2014/74012141",
  "title": "VOLKSWAGEN GOL 1.6 MI CITY 8V FLEX 4P MANUAL",
  "make": "VOLKSWAGEN",
  "model": "GOL",
  "version": "1.6 MI CITY 8V FLEX 4P MANUAL",
  "yearFabrication": 2013,
  "yearModel": 2014,
  "odometer": 173000,
  "transmission": "Manual",
  "price": 35900,
  "currency": "BRL",
  "fipePercent": 94,
  "sellerType": "PF",
  "city": "São Paulo",
  "stateCode": "SP"
}

Use cases

• Compare asking prices for one model in São Paulo against FIPE percent and keep the rows where the percent is under 100.
• Split a dealer’s watchlist by state and export city, seller type, and mileage to a sheet.
• Schedule monitor mode each morning and export only listings whose price moved.
• For the US market after this file, run Cars.com Scraper. For Germany, run mobile.de Scraper.

Integration examples

Replace APIFY_TOKEN. The slug below is the Store name.

Node.js

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor("crawloop/webmotors-scraper").call({
  make: "VOLKSWAGEN",
  model: "GOL",
  state: "SP",
  maxItems: 25,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("crawloop/webmotors-scraper").call(run_input={
    "make": "FIAT",
    "model": "ARGO",
    "state": "RJ",
    "vehicleType": "used",
    "maxItems": 25,
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(len(items))

cURL

curl -X POST "https://api.apify.com/v2/acts/crawloop~webmotors-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"make":"VOLKSWAGEN","model":"GOL","state":"SP","maxItems":10}'

MCP and AI assistants

Use this Actor from AI tools via Apify MCP. Connect your Apify account, then call this Actor by its Store name crawloop/webmotors-scraper.

Example prompts:

• "Run Webmotors Scraper for Volkswagen Gol in SP and return the top 20 rows as JSON"
• "Scrape used Fiat Argo listings in RJ and summarize price, mileage, and FIPE percent"
• "Run Webmotors Scraper in monitor mode for Chevrolet Onix in MG, then use Cars.com Scraper when the next market is the US"

Suite next step

This Actor covers Brazil car search cards. For US dealer inventory, run Cars.com Scraper. For Germany, run mobile.de Scraper.

FAQ

Does this open every listing page? No. Rows are the search cards. Phone numbers and tax ids are not requested.

Why is a proxy required? The search API returns a block page from datacenter IPs. The run uses Apify residential egress in Brazil.

What does monitor mode skip? Listing ids already stored for that same search, unless the asking price changed. A quiet tick writes zero rows. The first run only fills the baseline.

Is FIPE percent always present? No. Some cards leave it empty. Those rows omit fipePercent.