Webmotors vehicle search
Search Webmotors (Brazil's largest car and motorcycle marketplace) with every filter the site's search offers: condition (new/used), make, model and version (up to three makes), state and city, year, price, mileage, engine size, power, trunk and tank capacity, transmission, fuel, colour, body type, doors, plate ending, armoured or not, seller type, vehicle attributes (single owner, IPVA paid...), optional items, lifestyle category, traction, wheel size, opportunities (below FIPE, WhatsApp, car delivery...), auction history, photos only, official stores and fairs, one dealer's stock; for motorcycles also cylinder capacity, cooling, starter, gears, brakes and fuel system. Each vehicle: id, listing link, title, make/model/version with ids, model and manufacture year, mileage, price, financing preview, percent of the FIPE price, good-deal flag, transmission, fuel, body, doors, colours, engine, power, traction, trunk, tank, wheels, attributes, description, seller (business sellers with name, address, CNPJ; private sellers with the first name the site shows, city and state, no phone), photos. Also returns the total, the site's facet counts for every filter (makes with models and versions, states, years, colours...) and the site search link. The site serves at most 417 pages. Pass next_page back as page; null on the last page.
Every response includes credits_used: the credits this call cost.
Part of the Webmotors API: 8 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
vehicle_type | car | bike | car (default) or bike (motorcycles). Default: car |
condition | all | new | used | all (default), new or used. Default: all |
make | string | Make name (toyota, honda, volkswagen). Up to three, comma-separated; the n-th model and version belong to the n-th make (see /webmotors/v1/makes). Example: toyota |
model | string | Model name for the make (corolla, civic). Example: corolla |
version | string | Version name as the site lists it (e.g. 2.0 XEI 16V FLEX 4P AUTOMÁTICO). |
state | string | Brazilian state code (SP, RJ, MG) or its name. Example: SP |
city | string | City name within state (Campinas, Rio de Janeiro). |
year_min | integer | Earliest model year. Example: 2018 |
year_max | integer | Latest model year. |
price_min | number | Lowest price in BRL. |
price_max | number | Highest price in BRL. |
mileage_min | number | Lowest mileage in km. |
mileage_max | number | Highest mileage in km. |
engine_min | number | Smallest engine size in litres (1.0, 2.0). |
engine_max | number | Largest engine size in litres. |
hp_min | number | Lowest power in hp. |
hp_max | number | Highest power in hp. |
trunk_min | number | Smallest trunk in litres. |
trunk_max | number | Largest trunk in litres. |
tank_min | number | Smallest fuel tank in litres. |
tank_max | number | Largest fuel tank in litres. |
cc_min | number | Motorcycles: smallest cylinder capacity (cc). |
cc_max | number | Motorcycles: largest cylinder capacity (cc). |
transmission | string | Comma-separated: Automática, Manual, CVT, Automatizada, Semi-automática... |
fuel | string | Comma-separated: Gasolina e álcool, Gasolina, Diesel, Elétrico, Gasolina e elétrico... |
color | string | Comma-separated colours: Branco, Preto, Cinza, Prata, Azul, Vermelho... |
secondary_color | string | Motorcycles: secondary colour. |
body_type | string | Comma-separated: Utilitário esportivo, Hatchback, Sedã, Picape, Minivan, Cupê, Conversível (motorcycles: Street, Trail, Scooter, Custom, Naked...). |
doors | string | Comma-separated door counts (2, 4). |
plate_end | string | Comma-separated plate-ending groups: 1 e 2, 3 e 4, 5 e 6, 7 e 8, 9 e 0. |
armored | boolean | true for armoured only, false for not armoured. |
seller_type | string | Comma-separated: private, store, dealership. |
attributes | string | Comma-separated: Único dono, IPVA pago, Licenciado, Garantia de fábrica, Aceita troca... |
features | string | Comma-separated optional items: Teto solar, Bancos em couro, Câmera de ré... |
lifestyle | string | Comma-separated categories: Carros elétricos, SUVs, Carros para família, Carros de luxo... (see /webmotors/v1/categories). |
traction | string | Comma-separated: Dianteira, Traseira, Integral permanente, Integral parcial. |
wheel_size | string | Comma-separated rim sizes (17, 18). |
opportunities | string | Comma-separated: Super Preco (below FIPE), Com Financiamento, Possui WhatsApp, Responde Rapido, Troca com troco, Car Delivery, Vistoriado. |
auction_history | boolean | true: only vehicles with auction history; false: only without. |
with_photos | boolean | true: listings with photos only. |
offer | string | Official store or fair name (see /webmotors/v1/offers). |
dealer_id | string | A business seller's id: that dealer's stock. |
cooling | string | Motorcycles: ar or líquida. |
starter | string | Motorcycles: elétrica, pedal, pedal e elétrica. |
engine_type | string | Motorcycles: 4 Tempos, 2 Tempos, Elétrico de corrente contínua. |
gears | string | Motorcycles: 4, 5, 6 or automático. |
brakes | string | Motorcycles: disco/disco, disco/tambor, tambor/tambor. |
fuel_system | string | Motorcycles: Injeção Eletrônica or Carburador. |
sort | relevance | price_asc | price_desc | year_desc | mileage_asc | relevance (default), price_asc, price_desc, year_desc, mileage_asc. Default: relevance |
page | integer | Page number (1-417). Default: 1 |
per_page | integer | Results per page (up to 48). Default: 24 |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/webmotors/v1/search?make=toyota&model=corolla&state=SP&year_min=2018" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/webmotors/v1/search",
params={"make": "toyota", "model": "corolla", "state": "SP", "year_min": "2018"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/webmotors/v1/search");
url.searchParams.set("make", "toyota");
url.searchParams.set("model", "corolla");
url.searchParams.set("state", "SP");
url.searchParams.set("year_min", "2018");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"applied_filters": {"vehicle_type": "car","condition": "all","state": "SP","make": ["toyota"],"model": ["corolla"],"year_min": 2018},"sort": "relevance","page": 1,"per_page": 24,"total": 3234,"total_pages": 135,"count": 24,"next_page": 2,"search_url": "https://www.webmotors.com.br/carros/estoque?tipoveiculo=carros&estadocidade=S%C3%A3o%20Paulo&marca1=TOYOTA&modelo1=COROLLA&anode=2018","items": [{"id": 81850901,"url": "https://www.webmotors.com.br/comprar/toyota/corolla/20-vvt-ie-flex-xei-direct-shift/4-portas/2019/81850901","vehicle_type": "car","condition": "used","title": "TOYOTA COROLLA 2.0 VVT-IE FLEX XEI DIRECT SHIFT","make": "TOYOTA","model": "COROLLA","version": "2.0 VVT-IE FLEX XEI DIRECT SHIFT","make_id": 35,"model_id": 776,"version_id": 348132,"year_manufacture": 2019,"year_model": 2020,"mileage_km": 156476,"price": 99990,"search_price": 99990,"currency": "BRL","financing": {"installment": 1965.1,"installments": 60,"monthly_rate": 0.019},"fipe_percent": 89,"good_deal": true,"transmission": "Automática","fuel": null,"body_type": "Sedã","doors": 4,"color": "Prata","secondary_color": null,"armored": false,"engine_size": "2.0","horsepower": "177 cv","traction": "Dianteira","trunk_capacity": null,"fuel_tank": "50 l","wheel_size": 17,"cubic_capacity": null,"engine_type": null,"brakes": null,"fuel_system": null,"cooling": null,"starter": null,"auction_history": false,"…": "8 more fields"},{"id": 81850998,"url": "https://www.webmotors.com.br/comprar/toyota/corolla/20-vvt-ie-flex-xei-direct-shift/4-portas/2021/81850998","vehicle_type": "car","condition": "used","title": "TOYOTA COROLLA 2.0 VVT-IE FLEX XEI DIRECT SHIFT","make": "TOYOTA","model": "COROLLA","version": "2.0 VVT-IE FLEX XEI DIRECT SHIFT","make_id": 35,"model_id": 776,"version_id": 348132,"year_manufacture": 2021,"year_model": 2022,"mileage_km": 50254,"price": 117990,"search_price": 117990,"currency": "BRL","financing": {"installment": 2318.85,"installments": 60,"monthly_rate": 0.019},"fipe_percent": 99,"good_deal": true,"transmission": "Automática","fuel": null,"body_type": "Sedã","doors": 4,"color": "Branco","secondary_color": null,"armored": false,"engine_size": "2.0","horsepower": "177 cv","traction": "Dianteira","trunk_capacity": "470 l","fuel_tank": "50 l","wheel_size": 17,"cubic_capacity": null,"engine_type": null,"brakes": null,"fuel_system": null,"cooling": null,"starter": null,"auction_history": false,"…": "8 more fields"},"… 22 more"],"facets": {"vehicle_type": [{"value": "carro","count": 3234,"selected": true}],"condition": [{"value": "U","count": 3019},{"value": "N","count": 215}],"state": [{"value": "São Paulo (SP)","count": 3234,"selected": true,"items": [{"…": "2 fields"},{"…": "2 fields"},"… 168 more"]},{"value": "Rio de Janeiro (RJ)","count": 582},"… 25 more"],"make": [{"value": "TOYOTA","count": 11172,"selected": true,"items": [{"…": "4 fields"},{"…": "2 fields"},"… 16 more"]},{"value": "VOLKSWAGEN","count": 23435},"… 66 more"],"year": [{"value": "2018","count": 334},{"value": "2023","count": 609},"… 7 more"],"traction": [{"value": "Dianteira","count": 3164}],"wheel_size": [{"value": "17","count": 2796},{"value": "16","count": 395}],"color": [{"value": "Preto","count": 1147},{"value": "Branco","count": 828},"… 8 more"],"doors": [{"value": "4","count": 3225},{"value": "0","count": 9}],"seller_type": [{"value": "Loja","count": 1379},{"value": "Concessionária","count": 1053},"… 1 more"],"seller_kind": [{"value": "PJ","count": 2432},{"value": "PF","count": 802}],"transmission": [{"value": "Automática","count": 1622},{"value": "CVT","count": 1598},"… 2 more"],"fuel": [{"value": "Gasolina e álcool","count": 2736},{"value": "Gasolina e elétrico","count": 482},"… 4 more"],"features": [{"value": "Vidros elétricos","count": 2662},{"value": "Travas elétricas","count": 2581},"… 32 more"],"attributes": [{"value": "Aceita troca","count": 2798},{"value": "IPVA pago","count": 1477},"… 6 more"],"plate_end": [{"value": "1 e 2","count": 620},{"value": "3 e 4","count": 648},"… 3 more"],"armored": [{"value": "Sem blindagem","count": 2947},{"value": "Com blindagem","count": 287}],"media": [{"value": "Com fotos","count": 3128}],"opportunities": [{"value": "Com Financiamento","count": 3233},{"value": "Super Preco","count": 1246},"… 6 more"],"body_type": [{"value": "Sedã","count": 3234}],"auction_history": [{"value": "Sem passagem por leilão","count": 3232},{"value": "Com passagem por leilão","count": 2}],"lifestyle": [{"value": "Sedans","count": 2901},{"value": "Carros econômicos","count": 1986},"… 3 more"],"offer": [{"value": "Black Feirão","count": 650},{"value": "Loja Oficial Grupo Automob","count": 45},"… 17 more"]},"cached": false,"credits_used": 1}