Webmotors API: anúncios de veículos e preço FIPE em JSON
A Webmotors não oferece uma API aberta a desenvolvedores. O que volta aqui é o que o site publica — marca, modelo, ano, quilometragem e preço — em JSON. Há um endpoint que muda o que dá para fazer com isso: o **preço FIPE** do anúncio. Comparar o preço pedido com a referência FIPE é exatamente a conta que um comprador faz, e aqui ela vem pronta.
Endpoints
| endpoint | O que retorna | Obrigatórios |
|---|---|---|
| search | Busca no estoque ao vivo (carros e motos) por marca, modelo, versão e ano-modelo, com os filtros do site. | todos opcionais |
| listing | O registro completo de um anúncio, a partir da URL que a busca retorna: todas as especificações e fotos. | url |
| reference_price | O preço FIPE de referência do anúncio — o índice brasileiro de preços de usados — junto ao valor pedido. | listing_id |
| makes_models | A árvore marca → modelo da própria Webmotors, com as grafias exatas que a busca aceita. | todos opcionais |
Cada chamada é cobrada em créditos. Chamadas com erro ou bloqueadas são gratuitas.
Exemplo que funciona
Pegue as grafias em makes_models antes de buscar. Nome de modelo escrito de outro jeito devolve resultado vazio, e vazio parece falha sem ser.
curl -X POST https://api.reefapi.com/webmotors/v1/reference_price \
-H "x-api-key: SUA_CHAVE" \
-H "content-type: application/json" \
-d '{"listing_id": "..."}'{
"ok": true,
"data": {
"asking_price": 89900.0,
"fipe_price": 84300.0,
"currency": "BRL"
},
"meta": { "record_count": 1, "cache_hit": false, "mode": "live" }
}Em vez de escrever seu próprio scraper da Webmotors
Um scraper próprio da Webmotors funciona no primeiro dia. O problema aparece depois: quando a estrutura da listagem muda, o parser devolve lista vazia em vez de erro, e numa varredura longa a proteção contra bots corta no meio.
Além disso, cruzar anúncio com tabela FIPE por conta própria significa manter uma segunda fonte e casar modelo por modelo — é justamente aí que esse tipo de projeto costuma empacar. Aqui isso é um endpoint.
Para uma extração única o seu script sai mais barato, e dizemos isso sem rodeios. Para um acompanhamento diário, o custo está nas falhas que ninguém percebe.
Mais documentação em português
Limites e observações honestas
- Não é a API oficial da Webmotors e não temos parceria com a Webmotors.
- O preço FIPE é a referência publicada para aquele anúncio; não é uma avaliação nossa do veículo.
- Se o anúncio não informa quilometragem ou ano, o campo vem null — não preenchemos por estimativa.
- Sem cache: cada chamada reflete o momento da consulta.