Webmotors vehicle search

GET https://api.api.sh/webmotors/v1/search
1 credit / call automotive try it in the playground →

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

nametypedescription
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"

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}
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.