Puxa Aqui

// 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/volvo/xc60/.../65200385",
  "target": "webmotors.com.br",
  "type": "pdp"
}'

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, plp ou review.
 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/volvo/xc60/.../65200385",
  "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/volvo/xc60/variant/1"
    ],
    "cashPrice": 247900,
    "canonicalUrl": "https://www.webmotors.com.br/comprar/volvo/xc60/.../65200385",
    "price": 247900,
    "additionalProperties": [
      {
        "name": "Ano",
        "value": "2022/2022"
      }
    ],
    "regularPrice": 249900,
    "sellerName": "BCAR",
    "itemCondition": "used",
    "images": [
      {
        "url": "https://image.webmotors.com.br/xc60-main.webp"
      }
    ],
    "brand": {
      "name": "Volvo"
    },
    "aggregateRating": {
      "ratingValue": 4.7,
      "bestRating": 5,
      "reviewCount": 89
    },
    "currency": "BRL",
    "currencyRaw": "R$",
    "description": "Veiculo revisado, unico dono e com historico completo.",
    "mainImage": {
      "url": "https://image.webmotors.com.br/xc60-main.webp"
    },
    "sku": "65200385",
    "availability": "InStock",
    "name": "Volvo XC60 2.0 T8 Recharge Inscription Expression AWD",
    "url": "https://www.webmotors.com.br/comprar/volvo/xc60/.../65200385",
    "otherSellers": [
      {
        "sellerName": "Loja Premium Cars",
        "price": 246500,
        "sellerUrl": "https://www.webmotors.com.br/carros/estoque/?idrevendedor=9999",
        "sellerId": "9999"
      }
    ],
    "sellerId": "3882943",
    "sellerUrl": "https://www.webmotors.com.br/carros/estoque/?idrevendedor=3882943",
    "installmentPrice": "3874.10",
    "installmentCount": 72,
    "sellerType": "dealer",
    "vehicleLocation": "Sao Jose dos Pinhais - PR",
    "vehicleCity": "Sao Jose dos Pinhais",
    "vehicleState": "PR",
    "manufactureYear": 2022,
    "modelYear": 2022,
    "mileageKm": 60000,
    "transmission": "Automatica",
    "bodyType": "Utilitario esportivo",
    "fuelType": "Gasolina e eletrico",
    "finalPlate": "7",
    "color": "Preto",
    "acceptsTradeIn": true,
    "ipvaPaid": true,
    "licensed": true,
    "allMaintenanceOnSchedule": true,
    "allMaintenanceAtDealership": false,
    "vehicleFeatures": [
      "Airbag",
      "Ar condicionado",
      "GPS"
    ],
    "badges": [
      "Car Delivery",
      "Troca + Troco",
      "Vistoriado"
    ],
    "sellerCity": "Sao Jose dos Pinhais",
    "sellerState": "PR",
    "sellerOpenStatus": "Aberto agora",
    "sellerPhone": "(41) 3333-4444",
    "sellerCode": "BCAR",
    "sellerAchievements": {
      "sellerSince": "03/2020",
      "totalAds": 214,
      "responseTimeHours": 2
    },
    "priceComparison": {
      "announcedPrice": 247900,
      "webmotorsPrice": 245800,
      "fipePrice": 238676,
      "fipeUrl": "https://www.webmotors.com.br/tabela-fipe/carros/volvo/xc60",
      "currency": "BRL"
    },
    "inspection": {
      "isInspected": true,
      "inspectionReportUrl": "https://www.webmotors.com.br/laudo/65200385",
      "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. 2022/2022
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. Utilitario esportivo
data.brand.name string Campo data.brand.name retornado no payload de resposta. Volvo
data.canonicalUrl string Campo data.canonicalUrl retornado no payload de resposta. https://www.webmotors.com.br/comprar/volvo/xc60/.../65200385
data.cashPrice number Campo data.cashPrice retornado no payload de resposta. 247900
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. Gasolina e eletrico
data.images[].url string Campo data.images[].url retornado no payload de resposta. https://image.webmotors.com.br/xc60-main.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. https://www.webmotors.com.br/laudo/65200385
data.inspection.isInspected boolean Campo data.inspection.isInspected retornado no payload de resposta. true
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://image.webmotors.com.br/xc60-main.webp
data.manufactureYear number Campo data.manufactureYear retornado no payload de resposta. 2022
data.mileageKm number Campo data.mileageKm retornado no payload de resposta. 60000
data.modelYear number Campo data.modelYear retornado no payload de resposta. 2022
data.name string Campo data.name retornado no payload de resposta. Volvo XC60 2.0 T8 Recharge Inscription Expression AWD
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. 247900
data.priceComparison.announcedPrice number Campo data.priceComparison.announcedPrice retornado no payload de resposta. 247900
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. 238676
data.priceComparison.fipeUrl string Campo data.priceComparison.fipeUrl retornado no payload de resposta. https://www.webmotors.com.br/tabela-fipe/carros/volvo/xc60
data.priceComparison.webmotorsPrice number Campo data.priceComparison.webmotorsPrice retornado no payload de resposta. 245800
data.regularPrice number Campo data.regularPrice retornado no payload de resposta. 249900
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. Sao Jose dos Pinhais
data.sellerCode string Campo data.sellerCode retornado no payload de resposta. BCAR
data.sellerId string Campo data.sellerId retornado no payload de resposta. 3882943
data.sellerName string Campo data.sellerName retornado no payload de resposta. BCAR
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=3882943
data.sku string Campo data.sku retornado no payload de resposta. 65200385
data.transmission string Campo data.transmission retornado no payload de resposta. Automatica
data.url string Campo data.url retornado no payload de resposta. https://www.webmotors.com.br/comprar/volvo/xc60/.../65200385
data.variants[] string Campo data.variants[] retornado no payload de resposta. https://www.webmotors.com.br/comprar/volvo/xc60/variant/1
data.vehicleCity string Campo data.vehicleCity retornado no payload de resposta. Sao Jose dos Pinhais
data.vehicleFeatures[] string Campo data.vehicleFeatures[] retornado no payload de resposta. Airbag
data.vehicleLocation string Campo data.vehicleLocation retornado no payload de resposta. Sao Jose dos Pinhais - 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.
500 WORKER_ERROR / INTERNAL_ERROR Falha interna no worker ou no gateway.