// docs

Webmotors: Search listings

Extracts vehicle listing (PLP) from Webmotors by city/UF with friendly filters for cars, motorcycles, price, year, km, make, model, options and opportunities.

webmotors.com.br:plp · 1 credit per request

Standard credit cost. Your account pricing is shown in the sandbox.

Try this operation in the sandbox

HTTP request

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -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
}'

Keep your API key on your server. See the quickstart for authentication and response handling.

MCP request

The hosted MCP tool fixes target and type for this operation. Its remaining arguments use the same input rules as Extract.

POST /v1/mcp · Bearer or X-API-Key authentication

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

Supported inputs

Conditional fields depend on the alternatives and constraints in the rule column. Fields marked unsupported are omitted.

Field	Type	Requirement	Rule	Default	Example
url URL extraction target. For some PLPs it can be omitted when API assembles URL from other fields.	string (URL)	Optional	Optional. When absent, the URL is assembled with city/state.	-	https://www.mercadolivre.com.br/p/MLB123456
latitude Latitude of the search area. It must be sent together with longitude. Supported in Airbnb PLP, Zap Imóveis PLP, VivaReal PLP, Chaves na Mão PLP and Webmotors PLP.	number	Optional	Optional for searching by radius in Webmotors PLP. It must be sent together with longitude.	-	-25.4284
longitude Longitude of the search area. It must be sent together with latitude. Supported in Airbnb PLP, Zap Imóveis PLP, VivaReal PLP, Chaves na Mão PLP and Webmotors PLP.	number	Optional	Optional for searching by radius in Webmotors PLP. It must be sent together with latitude.	-	-49.2733
city City used in structured searches for properties and vehicles and optionally in Catho PLP. In VivaReal, it requires state.	string	Required	Mandatory for PLP of Webmotors.	-	Curitiba
state UF used in structured searches for properties and vehicles and optionally in Catho PLP.	string (UF 2 letters)	Required	Mandatory for PLP of Webmotors (UF with 2 letters).	-	PR
priceMin Minimum price for PLP searches for properties and vehicles.	integer	Optional	Minimum price in reais for Webmotors PLP.	-	90000
priceMax Maximum price for PLP searches for properties and vehicles.	integer	Optional	Maximum price in reais for Webmotors PLP.	-	130000
usedCars Used vehicle filter for Webmotors PLP. At least one of usedCars/newCars must be true.	boolean	Optional	Optional; must maintain at least one of usedCars/newCars true.	true	true
newCars New vehicle filter for Webmotors PLP. At least one of usedCars/newCars must be true.	boolean	Optional	Optional; must maintain at least one of usedCars/newCars true.	false	false
vehicleType Vehicle type for Webmotors PLP. Accepts aliases such as car, cars, carro, motorcycle, moto and bike.	"car" \| "motorcycle"	Optional	Vehicle type: car or motorcycle. Accepts aliases such as car, motorcycle and bike.	car	car
yearMin Minimum year/model for Webmotors PLP.	integer	Optional	Minimum year/model for Webmotors PLP.	-	2019
yearMax Maximum year/model for Webmotors PLP.	integer	Optional	Maximum year/model for Webmotors PLP.	-	2022
mileageMin Minimum mileage for Webmotors PLP.	integer	Optional	Minimum mileage for Webmotors PLP.	-	0
mileageMax Maximum mileage for Webmotors PLP.	integer	Optional	Maximum mileage for Webmotors PLP.	-	40000
engineCcMin Minimum displacement for Webmotors PLP, mainly motorcycles.	integer	Optional	Minimum displacement for Webmotors PLP, mainly motorcycles.	-	125
engineCcMax Maximum displacement for Webmotors PLP, mainly motorcycles.	integer	Optional	Maximum displacement for Webmotors PLP, mainly motorcycles.	-	300
make Brand for Webmotors PLP.	string	Optional	Vehicle brand for Webmotors PLP.	-	Honda
model Model for Webmotors PLP.	string	Optional	Vehicle model for Webmotors PLP.	-	Civic
version Version for Webmotors PLP.	string	Optional	Vehicle version for Webmotors PLP.	-	EXL
sellerTypes Advertiser types for Webmotors PLP. Accepts friendly aliases: dealership/dealer, store/loja, private/particular/pf.	string[]	Optional	Advertiser types. Aliases accepted: dealership/dealer, store/loja, private/particular/pf.	-	["store","private"]
transmissions Changes for Webmotors PLP. Accepts aliases such as automatic, manual and cvt, or names returned in availableFilterOptions.	string[]	Optional	Exchanges. Accepts aliases such as automatic, manual and cvt, or names returned in availableFilterOptions.	-	["automatic"]
fuels Fuels for Webmotors PLP. Accepts aliases such as flex, gasoline, diesel, electric, hybrid and NGV.	string[]	Optional	Fuels. Accepts aliases such as flex, gasoline, diesel, electric, hybrid and NGV.	-	["flex"]
colors Main colors for Webmotors PLP.	string[]	Optional	Main colors for Webmotors PLP.	-	["Branco", "Preto"]
secondaryColors Secondary colors for Webmotors PLP, mainly used on motorcycles.	string[]	Optional	Secondary colors for Webmotors PLP, mainly used on motorcycles.	-	["Preto"]
bodyTypes Bodies for Webmotors PLP. Accepts aliases such as sedan, hatch, SUV, pickup, wagon, van, coupe and convertible.	string[]	Optional	Bodywork. Accepts aliases such as sedan, hatch, SUV, pickup, wagon, van, coupe and convertible.	-	["sedan"]
doors Number of ports for Webmotors PLP.	integer[]	Optional	Door quantity list.	-	[4]
plateEndings End plate for Webmotors PLP. Accepts individual endings 0-9 or groups like 1_2, 3_4, 5_6, 7_8 e 9_0.	string[]	Optional	Board ends. Accepts endings 0-9 or groups like 1_2, 3_4, 5_6, 7_8 e 9_0.	-	["1"]
armored Armored vehicle filter for Webmotors PLP.	boolean	Optional	Filters armored vehicles.	-	false
auction Auction pass-through filter for Webmotors PLP.	boolean	Optional	Filters vehicles that have been auctioned.	-	false
withPhotos When true, returns only ads with photos in Webmotors PLP.	boolean	Optional	When true, only returns ads with photos.	-	true
mediaTypes Media types for Webmotors PLP. Use values returned in availableFilterOptions, such as With photos or With video.	string[]	Optional	Media types. Use the names returned in availableFilterOptions, such as With photos or With video.	-	["Com video"]
hotDeal Explicit filter of Hot Deal offers on Webmotors PLP.	boolean	Optional	Explicit filter of Hot Deal offers.	-	true
features Options/accessories for Webmotors PLP.	string[]	Optional	Vehicle options/accessories. Use the names returned in availableFilterOptions.	-	["Ar condicionado"]
characteristics Ad attributes for Webmotors PLP, as sole owner.	string[]	Optional	Ad attributes. Use the names returned in availableFilterOptions.	-	["Unico dono"]
needs Needs/Usage Styles for Webmotors PLP.	string[]	Optional	Usage needs/styles. Use the names returned in availableFilterOptions.	-	["Carros para familia"]
opportunities Opportunities Webmotors PLP, such as Super Price, With Financing, Inspected, Visao360, Car Delivery, Exchange with change and Has WhatsApp.	string[]	Optional	Opportunities such as Super Price, With Financing, Inspected, Visao360, Car Delivery, Exchange with change and Has WhatsApp.	-	["Super Preco"]
hotDeals Fair filters/special offers for Webmotors PLP.	string[]	Optional	Fair filters/special offers.	-	["Feirao"]
coolingTypes Types of cooling for Webmotors PLP motorcycles.	string[]	Optional	Types of refrigeration for motorcycles.	-	["Ar"]
starterTypes Starter types for Webmotors PLP motorcycles.	string[]	Optional	Starter types for motorcycles.	-	["Eletrica"]
engineTypes Engine types for Webmotors PLP motorcycle.	string[]	Optional	Engine types for motorcycles.	-	["4 tempos"]
brakeTypes Brake Types for Webmotors PLP Motorcycle.	string[]	Optional	Types of brakes for motorcycles.	-	["ABS"]
feedTypes Types of power supply for Webmotors PLP motorcycles.	string[]	Optional	Types of power supply for motorcycles.	-	["Injecao eletronica"]
shiftTypes Quantity/type of gears for Webmotors PLP motorcycles.	string[]	Optional	Quantity/type of gears for motorcycles.	-	["5"]
dealerId Reseller ID to restrict Webmotors PLP to a specific advertiser.	string (digits)	Optional	Numeric dealer ID to restrict the search to a specific advertiser.	-	12345
radiusKm Radius in km for Webmotors PLP when latitude and longitude are shipped. Backend default: 100.	integer (1-500)	Optional	Radius in km for searching for latitude/longitude. Backend default: 100.	-	100
sort Ordering for VivaReal, Chaves na Mão, OLX and Webmotors PLP, Booking Review and Hotels Review. VivaReal: relevance/date/price/biggest_price/biggest_area. Webmotors: relevance/price/biggest_price/year_desc/mileage_asc. OLX: relevance/date/price/biggest_price/price_relevance. Booking/Hotels Review: most_relevant/newest_first/oldest_first/score_desc/score_asc.	"relevance" \| "date" \| "price" \| "biggest_price" \| "biggest_area" \| "price_relevance" \| "most_relevant" \| "newest_first" \| "oldest_first" \| "score_desc" \| "score_asc" \| "year_desc" \| "mileage_asc"	Optional	Sorting Webmotors: relevance, price, biggest_price, year_desc or mileage_asc.	relevance	price
target Target source for extraction.	enum	Required	Always mandatory in the payload and must match the operation.	-	webmotors.com.br
type Extraction type: pdp, idp, plp, ilp, quote, review or places.	enum	Required	Always mandatory in the payload and must match the operation.	-	plp
page Pagination. In PLP, including Trivago, and in Reclame AQUI ILP starts in 1; in review (MercadoLivre, Booking and Hotels) starts in 0. The Reclame AQUI ILP even accepts the page 100.	integer	Optional	Supported for PLP; must be integer >= 1.	-	1

Request examples

Used cars with filters

Query used cars by city/UF with user-friendly filters on brand, model, price, year, km, exchange rate, fuel and opportunities.

Used cars with filters

{
  "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
}

Motorcycles by engine capacity

Query used motorcycles with displacement filters and mechanical specifications.

Motorcycles by engine capacity

{
  "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
}

Response schema

Leaf paths and expected types. Field names and enum values are part of the API contract.

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

Example response

Illustrative response. Product names, reviews and other source content retain their original language. Missing and null values do not imply zero stock, free shipping or zero reviews.

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/carros/pr-sao-jose-dos-pinhais",
    "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
      }
    ]
  }
}

Complete field reference

Path	Type	Description	Example
data.availableFilterOptions[].items[].count	number	Estimated number of results for the filter option.	24
data.availableFilterOptions[].items[].label	string	Friendly label of an available filter option.	Honda
data.availableFilterOptions[].items[].name	string	Technical value of an available filter option.	Honda
data.availableFilterOptions[].items[].selected	boolean	Indicates whether the filter option was selected in the search.	false
data.availableFilterOptions[].label	string	Friendly label of the filter group returned by Webmotors.	Marca
data.availableFilterOptions[].name	string	Technical name of the filter group returned by Webmotors.	Make
data.availableFilters[]	string	Field data.availableFilters[] returned in the response payload.	price
data.city	string	Field data.city returned in the response payload.	Sao Jose dos Pinhais
data.citySlug	string	Field data.citySlug returned in the response payload.	sao-jose-dos-pinhais
data.extractedAt	string (iso datetime)	data.extractedAt field returned in the response payload.	2026-02-12T14:01:00.000Z
data.items[].advertisementUrl	string	Field data.items[].advertisementUrl returned in the response payload.	https://www.webmotors.com.br/comprar/omoda/7/.../64572082
data.items[].bodyType	string	Field data.items[].bodyType returned in the response payload.	SUV
data.items[].brakeType	string	Brake type when available, mainly on motorcycles.	ABS
data.items[].brand.name	string	Field data.items[].brand.name returned in the response payload.	OMODA
data.items[].channels[]	string	Field data.items[].channels[] returned in the response payload.	WEBMOTORS
data.items[].condition	string	Field data.items[].condition returned in the response payload.	used
data.items[].coolingType	string	Type of refrigeration when available, mainly on motorcycles.	Ar
data.items[].currency	string	data.items[].currency field returned in the response payload.	BRL
data.items[].currencyRaw	string	Field data.items[].currencyRaw returned in the response payload.	R$
data.items[].engineCc	number	Vehicle engine capacity when available.	1500
data.items[].engineType	string	Engine type when available, mainly on motorcycles.	4 tempos
data.items[].feedType	string	Power supply type when available, mainly on motorcycles.	Injecao eletronica
data.items[].fipePercent	number	Field data.items[].fipePercent returned in the response payload.	94.5
data.items[].fuelType	string	Field data.items[].fuelType returned in the response payload.	Hibrido
data.items[].goodDeal	boolean	Field data.items[].goodDeal returned in the response payload.	false
data.items[].hotDeal	boolean	Field data.items[].hotDeal returned in the response payload.	true
data.items[].images[].url	string	Field data.items[].images[].url returned in the response payload.	https://www.webmotors.com.br/imagens/prod/380151/OMODA_7.webp
data.items[].isInspected	boolean	Field data.items[].isInspected returned in the response payload.	true
data.items[].isZeroKm	boolean	Field data.items[].isZeroKm returned in the response payload.	false
data.items[].manufactureYear	number	data.items[].manufactureYear field returned in the response payload.	2024
data.items[].mileageKm	number	Field data.items[].mileageKm returned in the response payload.	12000
data.items[].model	string	Field data.items[].model returned in the response payload.	7
data.items[].modelYear	number	data.items[].modelYear field returned in the response payload.	2025
data.items[].name	string	data.items[].name field returned in the response payload.	OMODA 7 1.5 TGDI PHEV PRESTIGE DHT
data.items[].numberOfDoors	number	Field data.items[].numberOfDoors returned in the response payload.	4
data.items[].position	number	data.items[].position field returned in the response payload.	1
data.items[].price	number	Field data.items[].price returned in the response payload.	108900
data.items[].productCode	string	Field data.items[].productCode returned in the response payload.	380151
data.items[].regularPrice	number	Field data.items[].regularPrice returned in the response payload.	112900
data.items[].sellerCity	string	data.items[].sellerCity field returned in the response payload.	Sao Jose dos Pinhais
data.items[].sellerId	string	Field data.items[].sellerId returned in the response payload.	8855
data.items[].sellerName	string	Field data.items[].sellerName returned in the response payload.	PRIXX
data.items[].sellerState	string	Field data.items[].sellerState returned in the response payload.	PR
data.items[].sellerType	string	Field data.items[].sellerType returned in the response payload.	dealer
data.items[].shiftType	string	Number/type of gears when available, mainly on motorcycles.	5
data.items[].sku	string	Field data.items[].sku returned in the response payload.	64572082
data.items[].starterType	string	Starting type when available, mainly on motorcycles.	Eletrica
data.items[].thumbnail	string	Field data.items[].thumbnail returned in the response payload.	https://www.webmotors.com.br/imagens/prod/380151/OMODA_7.webp
data.items[].transmission	string	Field data.items[].transmission returned in the response payload.	Automatica
data.items[].url	string	data.items[].url field returned in the response payload.	https://www.webmotors.com.br/comprar/omoda/7/.../64572082
data.items[].version	string	Field data.items[].version returned in the response payload.	1.5 TGDI PHEV PRESTIGE DHT
data.newCars	boolean	Field data.newCars returned in the response payload.	true
data.nextPage	number	Field data.nextPage returned in the response payload.	2
data.nextPageUrl	string	Field data.nextPageUrl returned in the response payload.	https://www.webmotors.com.br/api/search/car?...&actualPage=2
data.offset	number	Field data.offset returned in the response payload.	0
data.page	number	Field data.page returned in the response payload.	1
data.primaryResults	number	Field data.primaryResults returned in the response payload.	47
data.query	string	data.query field returned in the response payload.	volvo
data.requestUrl	string	Same value as `data.url`; never exposes the queried internal endpoint.	https://www.webmotors.com.br/carros/pr-sao-jose-dos-pinhais
data.resultsPerPage	number	Field data.resultsPerPage returned in the response payload.	47
data.searchMode	string	Field data.searchMode returned in the response payload.	all
data.sortOrder	string	Sort code sent to Webmotors.	1
data.source	string	Field data.source returned in the response payload.	webmotors.com.br
data.state	string	Field data.state returned in the response payload.	PR
data.totalResults	number	Field data.totalResults returned in the response payload.	978
data.type	string	Field data.type returned in the response payload.	plp
data.url	string	Field data.url returned in the response payload.	https://www.webmotors.com.br/carros/pr-sao-jose-dos-pinhais
data.usedCars	boolean	data.usedCars field returned in the response payload.	true
data.vehicleType	string	Type of vehicle consulted: car or motorcycle.	car
executionId	string (uuid)	Field executionId returned in the response payload.	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)	Field requestId returned in the response payload.	99999999-1111-4111-8111-999999999999

Errors and missing data

When supported by this operation, an entity not found upstream can return HTTP 200 with data: null and notFound: true. Check the documented response fields before interpreting an empty result. Source-specific behavior and exceptions are described above.

HTTP status	Error code	Meaning
400	`INVALID_PAYLOAD`	Invalid JSON or a request that violates the documented validation rules.
401	`UNAUTHORIZED`	Missing authorization or an invalid API key or token.
402	`INSUFFICIENT_CREDITS`	The account has insufficient credits for this operation.
403	`FORBIDDEN`	The account does not have access, or the API is temporarily disabled.
409	`EXECUTION_CONFLICT`	The execution identifier conflicts with an incompatible execution state.
429	`RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS`	A rate limit or simultaneous request limit was exceeded.
5xx	`UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_FUNCTION_ERROR`	An upstream, worker or gateway failure. Failed requests follow the platform refund policy.

Other Webmotors operations

Get listing details (PDP)