// docs

Buscar veículos na Webmotors

Extrai listagem de veiculos (PLP) do Webmotors por cidade/UF com filtros amigaveis para carros, motos, preco, ano, km, marca, modelo, opcionais e oportunidades.

Imóveis e veículos Busca e listagem

Como usar esta API

Siga os três passos abaixo para testar e integrar.

Fonte: Webmotors API ID: webmotors.com.br:plp Voltar ao catálogo de APIs

Nota importante: alguns campos podem retornar null em produção, dependendo da página de origem. Nesta documentação, os exemplos de output são preenchidos intencionalmente com valores não nulos para facilitar integração.

Quando a entidade consultada não existe na origem, o extract e a tool MCP retornam 200 com data: null e notFound: true. Esse caso é tratado como resposta concluída, não como erro de servidor.

1. Faça sua primeira chamada HTTP

Copie o exemplo abaixo, substitua SUA_CHAVE e execute.

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "webmotors.com.br",
  "type": "plp",
  "city": "Curitiba",
  "state": "PR",
  "vehicleType": "car",
  "usedCars": true,
  "newCars": false,
  "make": "Honda",
  "model": "Civic",
  "priceMin": 90000,
  "priceMax": 130000,
  "yearMin": 2019,
  "yearMax": 2022,
  "mileageMax": 40000,
  "sellerTypes": [
    "store",
    "private"
  ],
  "transmissions": [
    "automatic"
  ],
  "fuels": [
    "flex"
  ],
  "bodyTypes": [
    "sedan"
  ],
  "withPhotos": true,
  "hotDeal": true,
  "opportunities": [
    "Super Preco"
  ],
  "sort": "price",
  "page": 1
}'

Usar esta API com agentes via MCP

A mesma seam também aparece no MCP hospedado como uma tool dedicada. Os argumentos reaproveitam os campos do extract, mas target e type já ficam fixos pela tool.

Ver guia completo do MCP

Endpoint

POST /v1/mcp

Tool name

webmotors_com_br_plp

Auth

Bearer ou X-API-Key

webmotors_com_br_plp tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "webmotors_com_br_plp",
    "arguments": {
      "city": "Curitiba",
      "state": "PR",
      "vehicleType": "car",
      "usedCars": true,
      "newCars": false,
      "make": "Honda",
      "model": "Civic",
      "priceMin": 90000,
      "priceMax": 130000,
      "yearMin": 2019,
      "yearMax": 2022,
      "mileageMax": 40000,
      "sellerTypes": [
        "store",
        "private"
      ],
      "transmissions": [
        "automatic"
      ],
      "fuels": [
        "flex"
      ],
      "bodyTypes": [
        "sedan"
      ],
      "withPhotos": true,
      "hotDeal": true,
      "opportunities": [
        "Super Preco"
      ],
      "sort": "price",
      "page": 1,
      "executionId": "exec_example_123"
    }
  }
}

2. Confira os campos de entrada

Campos suportados nesta API do POST /v1/extract, com regras específicas de obrigatoriedade e condicionais.

Campo	Tipo	Status	Regra	Default	Exemplo
url URL alvo da extração. Para alguns PLPs pode ser omitida quando a API monta a URL a partir de outros campos.	string (URL)	Opcional	Opcional. Quando ausente, a URL e montada com city/state.	-	https://www.mercadolivre.com.br/p/MLB123456
latitude Latitude da area de busca. Deve ser enviada junto com longitude. Suportada em iFood PLP, Airbnb PLP, Zap Imóveis PLP, Chaves na Mão PLP e Webmotors PLP.	number	Opcional	Opcional para busca por raio no Webmotors PLP. Deve ser enviada junto com longitude.	-	-25.4284
longitude Longitude da area de busca. Deve ser enviada junto com latitude. Suportada em iFood PLP, Airbnb PLP, Zap Imóveis PLP, Chaves na Mão PLP e Webmotors PLP.	number	Opcional	Opcional para busca por raio no Webmotors PLP. Deve ser enviada junto com latitude.	-	-49.2733
city Cidade usada em Webmotors PLP e opcionalmente em Catho PLP (deve vir em par com state).	string	Obrigatório	Obrigatorio para PLP de Webmotors.	-	Sao Paulo
state UF usada em Webmotors PLP e opcionalmente em Catho PLP (deve vir em par com city).	string (UF 2 letras)	Obrigatório	Obrigatorio para PLP de Webmotors (UF com 2 letras).	-	SP
priceMin Preço mínimo para busca no Zapimoveis PLP e Webmotors PLP.	integer	Opcional	Preco minimo em reais para Webmotors PLP.	-	1000
priceMax Preço máximo para busca no Zapimoveis PLP e Webmotors PLP.	integer	Opcional	Preco maximo em reais para Webmotors PLP.	-	2000
usedCars Filtro de veiculos usados para Webmotors PLP. Pelo menos um entre usedCars/newCars deve ser true.	boolean	Opcional	Opcional; deve manter ao menos um entre usedCars/newCars true.	true	true
newCars Filtro de veiculos novos para Webmotors PLP. Pelo menos um entre usedCars/newCars deve ser true.	boolean	Opcional	Opcional; deve manter ao menos um entre usedCars/newCars true.	false	false
vehicleType Tipo de veiculo para Webmotors PLP. Aceita aliases como car, cars, carro, motorcycle, moto e bike.	"car" \| "motorcycle"	Opcional	Tipo de veiculo: car ou motorcycle. Aceita aliases como carro, moto e bike.	car	car
yearMin Ano/modelo minimo para Webmotors PLP.	integer	Opcional	Ano/modelo minimo para Webmotors PLP.	-	2020
yearMax Ano/modelo maximo para Webmotors PLP.	integer	Opcional	Ano/modelo maximo para Webmotors PLP.	-	2024
mileageMin Quilometragem minima para Webmotors PLP.	integer	Opcional	Quilometragem minima para Webmotors PLP.	-	0
mileageMax Quilometragem maxima para Webmotors PLP.	integer	Opcional	Quilometragem maxima para Webmotors PLP.	-	50000
engineCcMin Cilindrada minima para Webmotors PLP, principalmente motos.	integer	Opcional	Cilindrada minima para Webmotors PLP, principalmente motos.	-	125
engineCcMax Cilindrada maxima para Webmotors PLP, principalmente motos.	integer	Opcional	Cilindrada maxima para Webmotors PLP, principalmente motos.	-	300
make Marca para Webmotors PLP.	string	Opcional	Marca do veiculo para Webmotors PLP.	-	Honda
model Modelo para Webmotors PLP.	string	Opcional	Modelo do veiculo para Webmotors PLP.	-	Civic
version Versao para Webmotors PLP.	string	Opcional	Versao do veiculo para Webmotors PLP.	-	EXL
sellerTypes Tipos de anunciante para Webmotors PLP. Aceita aliases amigaveis: dealership/dealer, store/loja, private/particular/pf.	string[]	Opcional	Tipos de anunciante. Aceita aliases: dealership/dealer, store/loja, private/particular/pf.	-	["store", "private"]
transmissions Cambios para Webmotors PLP. Aceita aliases como automatic, manual e cvt, ou nomes retornados em availableFilterOptions.	string[]	Opcional	Cambios. Aceita aliases como automatic, manual e cvt, ou nomes retornados em availableFilterOptions.	-	["automatic"]
fuels Combustiveis para Webmotors PLP. Aceita aliases como flex, gasoline, diesel, electric, hybrid e gnv.	string[]	Opcional	Combustiveis. Aceita aliases como flex, gasoline, diesel, electric, hybrid e gnv.	-	["flex"]
colors Cores principais para Webmotors PLP.	string[]	Opcional	Cores principais para Webmotors PLP.	-	["Branco", "Preto"]
secondaryColors Cores secundarias para Webmotors PLP, usadas principalmente em motos.	string[]	Opcional	Cores secundarias para Webmotors PLP, usadas principalmente em motos.	-	["Preto"]
bodyTypes Carrocerias para Webmotors PLP. Aceita aliases como sedan, hatch, suv, pickup, wagon, van, coupe e convertible.	string[]	Opcional	Carrocerias. Aceita aliases como sedan, hatch, suv, pickup, wagon, van, coupe e convertible.	-	["sedan"]
doors Quantidade de portas para Webmotors PLP.	integer[]	Opcional	Lista de quantidades de portas.	-	[4]
plateEndings Final de placa para Webmotors PLP. Aceita finais individuais 0-9 ou grupos como 1_2, 3_4, 5_6, 7_8 e 9_0.	string[]	Opcional	Finais de placa. Aceita finais 0-9 ou grupos como 1_2, 3_4, 5_6, 7_8 e 9_0.	-	["1"]
armored Filtro de veiculos blindados para Webmotors PLP.	boolean	Opcional	Filtra veiculos blindados.	-	false
auction Filtro de passagem por leilao para Webmotors PLP.	boolean	Opcional	Filtra veiculos com passagem por leilao.	-	false
withPhotos Quando true, retorna apenas anuncios com fotos no Webmotors PLP.	boolean	Opcional	Quando true, retorna apenas anuncios com fotos.	-	true
mediaTypes Tipos de midia para Webmotors PLP. Use valores retornados em availableFilterOptions, como Com fotos ou Com video.	string[]	Opcional	Tipos de midia. Use os nomes retornados em availableFilterOptions, como Com fotos ou Com video.	-	["Com fotos"]
hotDeal Filtro explicito de ofertas Hot Deal no Webmotors PLP.	boolean	Opcional	Filtro explicito de ofertas Hot Deal.	-	true
features Opcionais/acessorios para Webmotors PLP.	string[]	Opcional	Opcionais/acessorios do veiculo. Use os nomes retornados em availableFilterOptions.	-	["Ar condicionado"]
characteristics Atributos do anuncio para Webmotors PLP, como unico dono.	string[]	Opcional	Atributos do anuncio. Use os nomes retornados em availableFilterOptions.	-	["Unico dono"]
needs Necessidades/estilos de uso para Webmotors PLP.	string[]	Opcional	Necessidades/estilos de uso. Use os nomes retornados em availableFilterOptions.	-	["Carros para familia"]
opportunities Oportunidades Webmotors PLP, como Super Preco, Com Financiamento, Vistoriado, Visao360, Car Delivery, Troca com troco e Possui WhatsApp.	string[]	Opcional	Oportunidades como Super Preco, Com Financiamento, Vistoriado, Visao360, Car Delivery, Troca com troco e Possui WhatsApp.	-	["Super Preco"]
hotDeals Filtros de feirao/ofertas especiais para Webmotors PLP.	string[]	Opcional	Filtros de feirao/ofertas especiais.	-	["Feirao"]
coolingTypes Tipos de refrigeracao para Webmotors PLP de motos.	string[]	Opcional	Tipos de refrigeracao para motos.	-	["Ar"]
starterTypes Tipos de partida para Webmotors PLP de motos.	string[]	Opcional	Tipos de partida para motos.	-	["Eletrica"]
engineTypes Tipos de motor para Webmotors PLP de motos.	string[]	Opcional	Tipos de motor para motos.	-	["4 tempos"]
brakeTypes Tipos de freio para Webmotors PLP de motos.	string[]	Opcional	Tipos de freio para motos.	-	["ABS"]
feedTypes Tipos de alimentacao para Webmotors PLP de motos.	string[]	Opcional	Tipos de alimentacao para motos.	-	["Injecao eletronica"]
shiftTypes Quantidade/tipo de marchas para Webmotors PLP de motos.	string[]	Opcional	Quantidade/tipo de marchas para motos.	-	["5"]
dealerId Id do revendedor para restringir a Webmotors PLP a um anunciante especifico.	string (digits)	Opcional	Id numerico do revendedor para restringir a busca a um anunciante especifico.	-	12345
radiusKm Raio em km para Webmotors PLP quando latitude e longitude sao enviados. Default do backend: 100.	integer (1-500)	Opcional	Raio em km para busca por latitude/longitude. Default do backend: 100.	-	100
sort Ordenacao para OLX PLP, Webmotors PLP, Booking Review e Hoteis Review. Webmotors: relevance/price/biggest_price/year_desc/mileage_asc. OLX: relevance/date/price/biggest_price/price_relevance. Booking/Hoteis Review: most_relevant/newest_first/oldest_first/score_desc/score_asc.	"relevance" \| "date" \| "price" \| "biggest_price" \| "price_relevance" \| "most_relevant" \| "newest_first" \| "oldest_first" \| "score_desc" \| "score_asc" \| "year_desc" \| "mileage_asc"	Opcional	Ordenacao Webmotors: relevance, price, biggest_price, year_desc ou mileage_asc.	relevance	date
target Fonte alvo da extração.	enum	Obrigatório	Sempre obrigatorio no payload e deve combinar com o seam.	-	mercadolivre.com.br
type Tipo da extração: pdp, idp, plp, quote, review ou places.	enum	Obrigatório	Sempre obrigatorio no payload e deve combinar com o seam.	-	pdp
page Paginacao. Em PLP inicia em 1; em review (MercadoLivre, Booking e Hoteis) inicia em 0.	integer	Opcional	Suportado para PLP; deve ser inteiro >= 1.	-	2

Exemplos de entrada

Carros usados com filtros

Consulta carros usados por cidade/UF com filtros amigaveis de marca, modelo, preco, ano, km, cambio, combustivel e oportunidades.

Carros usados com filtros

{
  "target": "webmotors.com.br",
  "type": "plp",
  "city": "Curitiba",
  "state": "PR",
  "vehicleType": "car",
  "usedCars": true,
  "newCars": false,
  "make": "Honda",
  "model": "Civic",
  "priceMin": 90000,
  "priceMax": 130000,
  "yearMin": 2019,
  "yearMax": 2022,
  "mileageMax": 40000,
  "sellerTypes": [
    "store",
    "private"
  ],
  "transmissions": [
    "automatic"
  ],
  "fuels": [
    "flex"
  ],
  "bodyTypes": [
    "sedan"
  ],
  "withPhotos": true,
  "hotDeal": true,
  "opportunities": [
    "Super Preco"
  ],
  "sort": "price",
  "page": 1
}

Motos por cilindrada

Consulta motos usadas com filtros de cilindrada e especificacoes mecanicas.

Motos por cilindrada

{
  "target": "webmotors.com.br",
  "type": "plp",
  "city": "Curitiba",
  "state": "PR",
  "vehicleType": "motorcycle",
  "usedCars": true,
  "newCars": false,
  "engineCcMin": 125,
  "engineCcMax": 300,
  "coolingTypes": [
    "Ar"
  ],
  "brakeTypes": [
    "ABS"
  ],
  "shiftTypes": [
    "5"
  ],
  "mediaTypes": [
    "Com video"
  ],
  "sort": "mileage_asc",
  "page": 1
}

Estrutura técnica da resposta

Mapa de paths de saída com tipo esperado para esta API.

responseSchema

{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "notFound": "boolean (optional; true when the upstream entity was not found and data is null)",
  "data.source": "string",
  "data.type": "string",
  "data.url": "string",
  "data.requestUrl": "string",
  "data.extractedAt": "string (iso datetime)",
  "data.query": "string",
  "data.city": "string",
  "data.citySlug": "string",
  "data.state": "string",
  "data.usedCars": "boolean",
  "data.newCars": "boolean",
  "data.vehicleType": "string",
  "data.searchMode": "string",
  "data.sortOrder": "string",
  "data.totalResults": "number",
  "data.primaryResults": "number",
  "data.page": "number",
  "data.resultsPerPage": "number",
  "data.offset": "number",
  "data.nextPage": "number",
  "data.nextPageUrl": "string",
  "data.availableFilters[]": "string",
  "data.availableFilterOptions[].name": "string",
  "data.availableFilterOptions[].label": "string",
  "data.availableFilterOptions[].items[].name": "string",
  "data.availableFilterOptions[].items[].label": "string",
  "data.availableFilterOptions[].items[].count": "number",
  "data.availableFilterOptions[].items[].selected": "boolean",
  "data.items[].position": "number",
  "data.items[].url": "string",
  "data.items[].advertisementUrl": "string",
  "data.items[].sku": "string",
  "data.items[].name": "string",
  "data.items[].condition": "string",
  "data.items[].currency": "string",
  "data.items[].currencyRaw": "string",
  "data.items[].price": "number",
  "data.items[].regularPrice": "number",
  "data.items[].brand.name": "string",
  "data.items[].model": "string",
  "data.items[].version": "string",
  "data.items[].manufactureYear": "number",
  "data.items[].modelYear": "number",
  "data.items[].mileageKm": "number",
  "data.items[].transmission": "string",
  "data.items[].bodyType": "string",
  "data.items[].fuelType": "string",
  "data.items[].engineCc": "number",
  "data.items[].coolingType": "string",
  "data.items[].starterType": "string",
  "data.items[].engineType": "string",
  "data.items[].brakeType": "string",
  "data.items[].feedType": "string",
  "data.items[].shiftType": "string",
  "data.items[].numberOfDoors": "number",
  "data.items[].thumbnail": "string",
  "data.items[].images[].url": "string",
  "data.items[].sellerId": "string",
  "data.items[].sellerName": "string",
  "data.items[].sellerType": "string",
  "data.items[].sellerCity": "string",
  "data.items[].sellerState": "string",
  "data.items[].productCode": "string",
  "data.items[].channels[]": "string",
  "data.items[].goodDeal": "boolean",
  "data.items[].hotDeal": "boolean",
  "data.items[].fipePercent": "number",
  "data.items[].isInspected": "boolean",
  "data.items[].isZeroKm": "boolean"
}

3. Confira um exemplo de resposta

responseExample

{
  "requestId": "99999999-1111-4111-8111-999999999999",
  "executionId": "99999999-2222-4222-8222-999999999999",
  "data": {
    "source": "webmotors.com.br",
    "type": "plp",
    "url": "https://www.webmotors.com.br/carros/pr-sao-jose-dos-pinhais",
    "requestUrl": "https://www.webmotors.com.br/api/search/car?...&actualPage=1",
    "extractedAt": "2026-02-12T14:01:00.000Z",
    "query": "volvo",
    "city": "Sao Jose dos Pinhais",
    "citySlug": "sao-jose-dos-pinhais",
    "state": "PR",
    "usedCars": true,
    "newCars": true,
    "vehicleType": "car",
    "searchMode": "all",
    "sortOrder": "1",
    "totalResults": 978,
    "primaryResults": 47,
    "page": 1,
    "resultsPerPage": 47,
    "offset": 0,
    "nextPage": 2,
    "nextPageUrl": "https://www.webmotors.com.br/api/search/car?...&actualPage=2",
    "availableFilters": [
      "price",
      "year",
      "transmission"
    ],
    "availableFilterOptions": [
      {
        "name": "Make",
        "label": "Marca",
        "items": [
          {
            "name": "Honda",
            "label": "Honda",
            "count": 24,
            "selected": false,
            "description": "Marca Honda",
            "items": [
              {
                "name": "Civic",
                "label": "Civic",
                "count": 11,
                "selected": false,
                "description": "Modelo Civic",
                "items": []
              }
            ]
          }
        ]
      }
    ],
    "items": [
      {
        "position": 1,
        "url": "https://www.webmotors.com.br/comprar/omoda/7/.../64572082",
        "advertisementUrl": "https://www.webmotors.com.br/comprar/omoda/7/.../64572082",
        "sku": "64572082",
        "name": "OMODA 7 1.5 TGDI PHEV PRESTIGE DHT",
        "condition": "used",
        "currency": "BRL",
        "currencyRaw": "R$",
        "price": 108900,
        "regularPrice": 112900,
        "brand": {
          "name": "OMODA"
        },
        "model": "7",
        "version": "1.5 TGDI PHEV PRESTIGE DHT",
        "manufactureYear": 2024,
        "modelYear": 2025,
        "mileageKm": 12000,
        "transmission": "Automatica",
        "bodyType": "SUV",
        "fuelType": "Hibrido",
        "engineCc": 1500,
        "coolingType": "Ar",
        "starterType": "Eletrica",
        "engineType": "4 tempos",
        "brakeType": "ABS",
        "feedType": "Injecao eletronica",
        "shiftType": "5",
        "numberOfDoors": 4,
        "thumbnail": "https://www.webmotors.com.br/imagens/prod/380151/OMODA_7.webp",
        "images": [
          {
            "url": "https://www.webmotors.com.br/imagens/prod/380151/OMODA_7.webp"
          }
        ],
        "sellerId": "8855",
        "sellerName": "PRIXX",
        "sellerType": "dealer",
        "sellerCity": "Sao Jose dos Pinhais",
        "sellerState": "PR",
        "productCode": "380151",
        "channels": [
          "WEBMOTORS",
          "MOBILE"
        ],
        "goodDeal": false,
        "hotDeal": true,
        "fipePercent": 94.5,
        "isInspected": true,
        "isZeroKm": false
      }
    ]
  }
}

Referência completa da resposta

Path	Tipo	Descrição	Exemplo
data.availableFilterOptions[].items[].count	number	Quantidade de resultados estimada para a opcao de filtro.	24
data.availableFilterOptions[].items[].label	string	Rotulo amigavel de uma opcao de filtro disponivel.	Honda
data.availableFilterOptions[].items[].name	string	Valor tecnico de uma opcao de filtro disponivel.	Honda
data.availableFilterOptions[].items[].selected	boolean	Indica se a opcao de filtro veio selecionada na busca.	false
data.availableFilterOptions[].label	string	Rotulo amigavel do grupo de filtro retornado pelo Webmotors.	Marca
data.availableFilterOptions[].name	string	Nome tecnico do grupo de filtro retornado pelo Webmotors.	Make
data.availableFilters[]	string	Campo data.availableFilters[] retornado no payload de resposta.	price
data.city	string	Campo data.city retornado no payload de resposta.	Sao Jose dos Pinhais
data.citySlug	string	Campo data.citySlug retornado no payload de resposta.	sao-jose-dos-pinhais
data.extractedAt	string (iso datetime)	Campo data.extractedAt retornado no payload de resposta.	2026-02-12T14:01:00.000Z
data.items[].advertisementUrl	string	Campo data.items[].advertisementUrl retornado no payload de resposta.	https://www.webmotors.com.br/comprar/omoda/7/.../64572082
data.items[].bodyType	string	Campo data.items[].bodyType retornado no payload de resposta.	SUV
data.items[].brakeType	string	Tipo de freio quando disponivel, principalmente em motos.	ABS
data.items[].brand.name	string	Campo data.items[].brand.name retornado no payload de resposta.	OMODA
data.items[].channels[]	string	Campo data.items[].channels[] retornado no payload de resposta.	WEBMOTORS
data.items[].condition	string	Campo data.items[].condition retornado no payload de resposta.	used
data.items[].coolingType	string	Tipo de refrigeracao quando disponivel, principalmente em motos.	Ar
data.items[].currency	string	Campo data.items[].currency retornado no payload de resposta.	BRL
data.items[].currencyRaw	string	Campo data.items[].currencyRaw retornado no payload de resposta.	R$
data.items[].engineCc	number	Cilindrada do veiculo quando disponivel.	1500
data.items[].engineType	string	Tipo de motor quando disponivel, principalmente em motos.	4 tempos
data.items[].feedType	string	Tipo de alimentacao quando disponivel, principalmente em motos.	Injecao eletronica
data.items[].fipePercent	number	Campo data.items[].fipePercent retornado no payload de resposta.	94.5
data.items[].fuelType	string	Campo data.items[].fuelType retornado no payload de resposta.	Hibrido
data.items[].goodDeal	boolean	Campo data.items[].goodDeal retornado no payload de resposta.	false
data.items[].hotDeal	boolean	Campo data.items[].hotDeal retornado no payload de resposta.	true
data.items[].images[].url	string	Campo data.items[].images[].url retornado no payload de resposta.	https://www.webmotors.com.br/imagens/prod/380151/OMODA_7.webp
data.items[].isInspected	boolean	Campo data.items[].isInspected retornado no payload de resposta.	true
data.items[].isZeroKm	boolean	Campo data.items[].isZeroKm retornado no payload de resposta.	false
data.items[].manufactureYear	number	Campo data.items[].manufactureYear retornado no payload de resposta.	2024
data.items[].mileageKm	number	Campo data.items[].mileageKm retornado no payload de resposta.	12000
data.items[].model	string	Campo data.items[].model retornado no payload de resposta.	7
data.items[].modelYear	number	Campo data.items[].modelYear retornado no payload de resposta.	2025
data.items[].name	string	Campo data.items[].name retornado no payload de resposta.	OMODA 7 1.5 TGDI PHEV PRESTIGE DHT
data.items[].numberOfDoors	number	Campo data.items[].numberOfDoors retornado no payload de resposta.	4
data.items[].position	number	Campo data.items[].position retornado no payload de resposta.	1
data.items[].price	number	Campo data.items[].price retornado no payload de resposta.	108900
data.items[].productCode	string	Campo data.items[].productCode retornado no payload de resposta.	380151
data.items[].regularPrice	number	Campo data.items[].regularPrice retornado no payload de resposta.	112900
data.items[].sellerCity	string	Campo data.items[].sellerCity retornado no payload de resposta.	Sao Jose dos Pinhais
data.items[].sellerId	string	Campo data.items[].sellerId retornado no payload de resposta.	8855
data.items[].sellerName	string	Campo data.items[].sellerName retornado no payload de resposta.	PRIXX
data.items[].sellerState	string	Campo data.items[].sellerState retornado no payload de resposta.	PR
data.items[].sellerType	string	Campo data.items[].sellerType retornado no payload de resposta.	dealer
data.items[].shiftType	string	Quantidade/tipo de marchas quando disponivel, principalmente em motos.	5
data.items[].sku	string	Campo data.items[].sku retornado no payload de resposta.	64572082
data.items[].starterType	string	Tipo de partida quando disponivel, principalmente em motos.	Eletrica
data.items[].thumbnail	string	Campo data.items[].thumbnail retornado no payload de resposta.	https://www.webmotors.com.br/imagens/prod/380151/OMODA_7.webp
data.items[].transmission	string	Campo data.items[].transmission retornado no payload de resposta.	Automatica
data.items[].url	string	Campo data.items[].url retornado no payload de resposta.	https://www.webmotors.com.br/comprar/omoda/7/.../64572082
data.items[].version	string	Campo data.items[].version retornado no payload de resposta.	1.5 TGDI PHEV PRESTIGE DHT
data.newCars	boolean	Campo data.newCars retornado no payload de resposta.	true
data.nextPage	number	Campo data.nextPage retornado no payload de resposta.	2
data.nextPageUrl	string	Campo data.nextPageUrl retornado no payload de resposta.	https://www.webmotors.com.br/api/search/car?...&actualPage=2
data.offset	number	Campo data.offset retornado no payload de resposta.	0
data.page	number	Campo data.page retornado no payload de resposta.	1
data.primaryResults	number	Campo data.primaryResults retornado no payload de resposta.	47
data.query	string	Campo data.query retornado no payload de resposta.	volvo
data.requestUrl	string	Campo data.requestUrl retornado no payload de resposta.	https://www.webmotors.com.br/api/search/car?...&actualPage=1
data.resultsPerPage	number	Campo data.resultsPerPage retornado no payload de resposta.	47
data.searchMode	string	Campo data.searchMode retornado no payload de resposta.	all
data.sortOrder	string	Codigo de ordenacao enviado ao Webmotors.	1
data.source	string	Campo data.source retornado no payload de resposta.	webmotors.com.br
data.state	string	Campo data.state retornado no payload de resposta.	PR
data.totalResults	number	Campo data.totalResults retornado no payload de resposta.	978
data.type	string	Campo data.type retornado no payload de resposta.	plp
data.url	string	Campo data.url retornado no payload de resposta.	https://www.webmotors.com.br/carros/pr-sao-jose-dos-pinhais
data.usedCars	boolean	Campo data.usedCars retornado no payload de resposta.	true
data.vehicleType	string	Tipo de veiculo consultado: car ou motorcycle.	car
executionId	string (uuid)	Campo executionId retornado no payload de resposta.	99999999-2222-4222-8222-999999999999
notFound	boolean (optional; true when the upstream entity was not found and data is null)	Present and true when the upstream entity was not found. In this case data is null and the request still completes successfully.	N/A
requestId	string (uuid)	Campo requestId retornado no payload de resposta.	99999999-1111-4111-8111-999999999999

Erros comuns

Respostas com notFound: true não entram nesta tabela, porque retornam sucesso HTTP 200.

Status	errorCode	Quando acontece
400	INVALID_PAYLOAD	JSON inválido ou violação das regras de validação do payload.
401	UNAUTHORIZED	Header Authorization ausente ou token/chave inválida.
402	INSUFFICIENT_CREDITS	Saldo de créditos insuficiente para a API solicitada.
403	FORBIDDEN	Usuário sem acesso ou API temporariamente desabilitada.
409	EXECUTION_CONFLICT	executionId conflita com uma execução em estado incompatível.
429	RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS	Limite de taxa ou limite de requisições em voo excedido.
5xx	UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_INVOCATION_FAILED / WORKER_FUNCTION_ERROR / WORKER_INVALID_RESPONSE / INTERNAL_ERROR	Falha de servidor no worker, provider/proxy ou gateway. Nesses casos os créditos são estornados automaticamente.