// docs

Webmotors PDP

Extrai dados completos de anuncio de veiculo (PDP) do Webmotors.

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.

Chamada HTTP

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.webmotors.com.br/comprar/chevrolet/tracker/1-2-turbo-flex-premier-automatico/4-portas/2024/65274301",
  "target": "webmotors.com.br",
  "type": "pdp"
}'

Chamada 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_pdp

Auth

Bearer ou X-API-Key

webmotors_com_br_pdp tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "webmotors_com_br_pdp",
    "arguments": {
      "url": "https://www.webmotors.com.br/comprar/chevrolet/tracker/1-2-turbo-flex-premier-automatico/4-portas/2024/65274301",
      "executionId": "exec_example_123"
    }
  }
}

Possibilidades de input

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)	Obrigatório	Obrigatorio para este seam.	-	https://www.mercadolivre.com.br/p/MLB123456
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, review ou places.	enum	Obrigatório	Sempre obrigatorio no payload e deve combinar com o seam.	-	pdp

Exemplos de request

PDP por URL

Consulta de anuncio individual do Webmotors.

PDP por URL

{
  "url": "https://www.webmotors.com.br/comprar/chevrolet/tracker/1-2-turbo-flex-premier-automatico/4-portas/2024/65274301",
  "target": "webmotors.com.br",
  "type": "pdp"
}

Schema de response (leaf paths)

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

responseSchema

{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "data.isInternational": "boolean",
  "data.variants[]": "string",
  "data.cashPrice": "number",
  "data.canonicalUrl": "string",
  "data.price": "number",
  "data.additionalProperties[].name": "string",
  "data.additionalProperties[].value": "string",
  "data.regularPrice": "number",
  "data.sellerName": "string",
  "data.itemCondition": "string",
  "data.images[].url": "string",
  "data.brand.name": "string",
  "data.aggregateRating.ratingValue": "number",
  "data.aggregateRating.bestRating": "number",
  "data.aggregateRating.reviewCount": "number",
  "data.currency": "string",
  "data.currencyRaw": "string",
  "data.description": "string",
  "data.mainImage.url": "string",
  "data.sku": "string",
  "data.availability": "string",
  "data.name": "string",
  "data.url": "string",
  "data.otherSellers[].sellerName": "string",
  "data.otherSellers[].price": "number",
  "data.otherSellers[].sellerUrl": "string",
  "data.otherSellers[].sellerId": "string",
  "data.sellerId": "string",
  "data.sellerUrl": "string",
  "data.installmentPrice": "string",
  "data.installmentCount": "number",
  "data.sellerType": "string",
  "data.vehicleLocation": "string",
  "data.vehicleCity": "string",
  "data.vehicleState": "string",
  "data.manufactureYear": "number",
  "data.modelYear": "number",
  "data.mileageKm": "number",
  "data.transmission": "string",
  "data.bodyType": "string",
  "data.fuelType": "string",
  "data.finalPlate": "string",
  "data.color": "string",
  "data.acceptsTradeIn": "boolean",
  "data.ipvaPaid": "boolean",
  "data.licensed": "boolean",
  "data.allMaintenanceOnSchedule": "boolean",
  "data.allMaintenanceAtDealership": "boolean",
  "data.vehicleFeatures[]": "string",
  "data.badges[]": "string",
  "data.sellerCity": "string",
  "data.sellerState": "string",
  "data.sellerOpenStatus": "string",
  "data.sellerPhone": "string",
  "data.sellerCode": "string",
  "data.sellerAchievements.sellerSince": "string",
  "data.sellerAchievements.totalAds": "number",
  "data.sellerAchievements.responseTimeHours": "number",
  "data.priceComparison.announcedPrice": "number",
  "data.priceComparison.webmotorsPrice": "number",
  "data.priceComparison.fipePrice": "number",
  "data.priceComparison.fipeUrl": "string",
  "data.priceComparison.currency": "string",
  "data.inspection.isInspected": "boolean",
  "data.inspection.inspectionReportUrl": "string",
  "data.inspection.inspectionItems[]": "string"
}

Exemplo de response

responseExample

{
  "requestId": "88888888-1111-4111-8111-888888888888",
  "executionId": "88888888-2222-4222-8222-888888888888",
  "data": {
    "isInternational": false,
    "variants": [
      "https://www.webmotors.com.br/comprar/chevrolet/tracker/variant/1"
    ],
    "cashPrice": 117900,
    "canonicalUrl": "https://www.webmotors.com.br/comprar/chevrolet/tracker/1-2-turbo-flex-premier-automatico/4-portas/2024/65274301",
    "price": 117900,
    "additionalProperties": [
      {
        "name": "Ano",
        "value": "2024/2024"
      }
    ],
    "regularPrice": 117900,
    "sellerName": "CAUNETO VEICULOS",
    "itemCondition": "used",
    "images": [
      {
        "url": "https://www.webmotors.com.br/2026/202603/20260316/chevrolet-tracker-1-2-turbo-flex-premier-automatico-wmimagem20274194837.webp"
      }
    ],
    "brand": {
      "name": "Chevrolet"
    },
    "aggregateRating": {
      "ratingValue": 4.7,
      "bestRating": 5,
      "reviewCount": 89
    },
    "currency": "BRL",
    "currencyRaw": "R$",
    "description": "Veiculo revisado, unico dono e com historico completo.",
    "mainImage": {
      "url": "https://www.webmotors.com.br/2026/202603/20260316/chevrolet-tracker-1-2-turbo-flex-premier-automatico-wmimagem20274194837.webp"
    },
    "sku": "65274301",
    "availability": "InStock",
    "name": "Chevrolet Tracker 1.2 Turbo Flex Premier Automático",
    "url": "https://www.webmotors.com.br/comprar/chevrolet/tracker/1-2-turbo-flex-premier-automatico/4-portas/2024/65274301",
    "otherSellers": [
      {
        "sellerName": "Loja Premium Cars",
        "price": 246500,
        "sellerUrl": "https://www.webmotors.com.br/carros/estoque/?idrevendedor=9999",
        "sellerId": "9999"
      }
    ],
    "sellerId": "3879342",
    "sellerUrl": "https://www.webmotors.com.br/carros/estoque/?idrevendedor=3879342",
    "installmentPrice": "3874.10",
    "installmentCount": 72,
    "sellerType": "dealer",
    "vehicleLocation": "Toledo - PR",
    "vehicleCity": "Toledo",
    "vehicleState": "PR",
    "manufactureYear": 2024,
    "modelYear": 2024,
    "mileageKm": 49883,
    "transmission": "Automática",
    "bodyType": "Utilitário esportivo",
    "fuelType": "Flex",
    "finalPlate": "7",
    "color": "Preto",
    "acceptsTradeIn": true,
    "ipvaPaid": true,
    "licensed": true,
    "allMaintenanceOnSchedule": true,
    "allMaintenanceAtDealership": false,
    "vehicleFeatures": [
      "Airbag",
      "Ar condicionado",
      "GPS"
    ],
    "badges": [
      "Car Delivery",
      "Troca + Troco",
      "Bom negócio"
    ],
    "sellerCity": "Toledo",
    "sellerState": "PR",
    "sellerOpenStatus": "Aberto agora",
    "sellerPhone": "(41) 3333-4444",
    "sellerCode": "CAUNETO",
    "sellerAchievements": {
      "sellerSince": "03/2020",
      "totalAds": 214,
      "responseTimeHours": 2
    },
    "priceComparison": {
      "announcedPrice": 117900,
      "webmotorsPrice": 116500,
      "fipePrice": 120000,
      "fipeUrl": "https://www.webmotors.com.br/tabela-fipe/carros/chevrolet/tracker",
      "currency": "BRL"
    },
    "inspection": {
      "isInspected": false,
      "inspectionReportUrl": "",
      "inspectionItems": [
        "Motor",
        "Freios",
        "Suspensao"
      ]
    }
  }
}

Referência completa de campos

Path	Tipo	Descrição	Exemplo
data.acceptsTradeIn	boolean	Campo data.acceptsTradeIn retornado no payload de resposta.	true
data.additionalProperties[].name	string	Campo data.additionalProperties[].name retornado no payload de resposta.	Ano
data.additionalProperties[].value	string	Campo data.additionalProperties[].value retornado no payload de resposta.	2024/2024
data.aggregateRating.bestRating	number	Campo data.aggregateRating.bestRating retornado no payload de resposta.	5
data.aggregateRating.ratingValue	number	Campo data.aggregateRating.ratingValue retornado no payload de resposta.	4.7
data.aggregateRating.reviewCount	number	Campo data.aggregateRating.reviewCount retornado no payload de resposta.	89
data.allMaintenanceAtDealership	boolean	Campo data.allMaintenanceAtDealership retornado no payload de resposta.	false
data.allMaintenanceOnSchedule	boolean	Campo data.allMaintenanceOnSchedule retornado no payload de resposta.	true
data.availability	string	Campo data.availability retornado no payload de resposta.	InStock
data.badges[]	string	Campo data.badges[] retornado no payload de resposta.	Car Delivery
data.bodyType	string	Campo data.bodyType retornado no payload de resposta.	Utilitário esportivo
data.brand.name	string	Campo data.brand.name retornado no payload de resposta.	Chevrolet
data.canonicalUrl	string	Campo data.canonicalUrl retornado no payload de resposta.	https://www.webmotors.com.br/comprar/chevrolet/tracker/1-2-turbo-flex-premier-automatico/4-portas/2024/65274301
data.cashPrice	number	Campo data.cashPrice retornado no payload de resposta.	117900
data.color	string	Campo data.color retornado no payload de resposta.	Preto
data.currency	string	Campo data.currency retornado no payload de resposta.	BRL
data.currencyRaw	string	Campo data.currencyRaw retornado no payload de resposta.	R$
data.description	string	Campo data.description retornado no payload de resposta.	Veiculo revisado, unico dono e com historico completo.
data.finalPlate	string	Campo data.finalPlate retornado no payload de resposta.	7
data.fuelType	string	Campo data.fuelType retornado no payload de resposta.	Flex
data.images[].url	string	Campo data.images[].url retornado no payload de resposta.	https://www.webmotors.com.br/2026/202603/20260316/chevrolet-tracker-1-2-turbo-flex-premier-automatico-wmimagem20274194837.webp
data.inspection.inspectionItems[]	string	Campo data.inspection.inspectionItems[] retornado no payload de resposta.	Motor
data.inspection.inspectionReportUrl	string	Campo data.inspection.inspectionReportUrl retornado no payload de resposta.
data.inspection.isInspected	boolean	Campo data.inspection.isInspected retornado no payload de resposta.	false
data.installmentCount	number	Campo data.installmentCount retornado no payload de resposta.	72
data.installmentPrice	string	Campo data.installmentPrice retornado no payload de resposta.	3874.10
data.ipvaPaid	boolean	Campo data.ipvaPaid retornado no payload de resposta.	true
data.isInternational	boolean	Campo data.isInternational retornado no payload de resposta.	false
data.itemCondition	string	Campo data.itemCondition retornado no payload de resposta.	used
data.licensed	boolean	Campo data.licensed retornado no payload de resposta.	true
data.mainImage.url	string	Campo data.mainImage.url retornado no payload de resposta.	https://www.webmotors.com.br/2026/202603/20260316/chevrolet-tracker-1-2-turbo-flex-premier-automatico-wmimagem20274194837.webp
data.manufactureYear	number	Campo data.manufactureYear retornado no payload de resposta.	2024
data.mileageKm	number	Campo data.mileageKm retornado no payload de resposta.	49883
data.modelYear	number	Campo data.modelYear retornado no payload de resposta.	2024
data.name	string	Campo data.name retornado no payload de resposta.	Chevrolet Tracker 1.2 Turbo Flex Premier Automático
data.otherSellers[].price	number	Campo data.otherSellers[].price retornado no payload de resposta.	246500
data.otherSellers[].sellerId	string	Campo data.otherSellers[].sellerId retornado no payload de resposta.	9999
data.otherSellers[].sellerName	string	Campo data.otherSellers[].sellerName retornado no payload de resposta.	Loja Premium Cars
data.otherSellers[].sellerUrl	string	Campo data.otherSellers[].sellerUrl retornado no payload de resposta.	https://www.webmotors.com.br/carros/estoque/?idrevendedor=9999
data.price	number	Campo data.price retornado no payload de resposta.	117900
data.priceComparison.announcedPrice	number	Campo data.priceComparison.announcedPrice retornado no payload de resposta.	117900
data.priceComparison.currency	string	Campo data.priceComparison.currency retornado no payload de resposta.	BRL
data.priceComparison.fipePrice	number	Campo data.priceComparison.fipePrice retornado no payload de resposta.	120000
data.priceComparison.fipeUrl	string	Campo data.priceComparison.fipeUrl retornado no payload de resposta.	https://www.webmotors.com.br/tabela-fipe/carros/chevrolet/tracker
data.priceComparison.webmotorsPrice	number	Campo data.priceComparison.webmotorsPrice retornado no payload de resposta.	116500
data.regularPrice	number	Campo data.regularPrice retornado no payload de resposta.	117900
data.sellerAchievements.responseTimeHours	number	Campo data.sellerAchievements.responseTimeHours retornado no payload de resposta.	2
data.sellerAchievements.sellerSince	string	Campo data.sellerAchievements.sellerSince retornado no payload de resposta.	03/2020
data.sellerAchievements.totalAds	number	Campo data.sellerAchievements.totalAds retornado no payload de resposta.	214
data.sellerCity	string	Campo data.sellerCity retornado no payload de resposta.	Toledo
data.sellerCode	string	Campo data.sellerCode retornado no payload de resposta.	CAUNETO
data.sellerId	string	Campo data.sellerId retornado no payload de resposta.	3879342
data.sellerName	string	Campo data.sellerName retornado no payload de resposta.	CAUNETO VEICULOS
data.sellerOpenStatus	string	Campo data.sellerOpenStatus retornado no payload de resposta.	Aberto agora
data.sellerPhone	string	Campo data.sellerPhone retornado no payload de resposta.	(41) 3333-4444
data.sellerState	string	Campo data.sellerState retornado no payload de resposta.	PR
data.sellerType	string	Campo data.sellerType retornado no payload de resposta.	dealer
data.sellerUrl	string	Campo data.sellerUrl retornado no payload de resposta.	https://www.webmotors.com.br/carros/estoque/?idrevendedor=3879342
data.sku	string	Campo data.sku retornado no payload de resposta.	65274301
data.transmission	string	Campo data.transmission retornado no payload de resposta.	Automática
data.url	string	Campo data.url retornado no payload de resposta.	https://www.webmotors.com.br/comprar/chevrolet/tracker/1-2-turbo-flex-premier-automatico/4-portas/2024/65274301
data.variants[]	string	Campo data.variants[] retornado no payload de resposta.	https://www.webmotors.com.br/comprar/chevrolet/tracker/variant/1
data.vehicleCity	string	Campo data.vehicleCity retornado no payload de resposta.	Toledo
data.vehicleFeatures[]	string	Campo data.vehicleFeatures[] retornado no payload de resposta.	Airbag
data.vehicleLocation	string	Campo data.vehicleLocation retornado no payload de resposta.	Toledo - PR
data.vehicleState	string	Campo data.vehicleState retornado no payload de resposta.	PR
executionId	string (uuid)	Campo executionId retornado no payload de resposta.	88888888-2222-4222-8222-888888888888
requestId	string (uuid)	Campo requestId retornado no payload de resposta.	88888888-1111-4111-8111-888888888888

Erros comuns

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.