Puxa Aqui

// docs

Amazon PDP

Extrai dados completos de produto (PDP) da Amazon Brasil.

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.amazon.com.br/dp/B09B8V1LZ3",
  "target": "amazon.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

Requisicao basica para pagina de produto Amazon.

PDP por URL 
{
  "url": "https://www.amazon.com.br/dp/B09B8V1LZ3",
  "target": "amazon.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[].asin": "string",
  "data.variants[].url": "string",
  "data.shippingFee.shippingFee": "string",
  "data.shippingFee.zipCode": "string",
  "data.taxFreePrice": "number",
  "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.breadcrumbs[].name": "string",
  "data.breadcrumbs[].url": "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.mpn": "string",
  "data.size": "string",
  "data.color": "string",
  "data.style": "string",
  "data.sellerSocialReason": "string",
  "data.sellerCnpj": "string",
  "data.sellerAddress": "string",
  "data.sellerCity": "string",
  "data.sellerState": "string",
  "data.sellerCountry": "string"
}

Exemplo de response

responseExample 
{
  "requestId": "44444444-1111-4111-8111-444444444444",
  "executionId": "44444444-2222-4222-8222-444444444444",
  "data": {
    "isInternational": false,
    "variants": [
      {
        "asin": "B09B8V1LZ3",
        "url": "https://www.amazon.com.br/dp/B09B8V1LZ3"
      }
    ],
    "shippingFee": {
      "shippingFee": "R$ 12,90",
      "zipCode": "80000-000"
    },
    "taxFreePrice": 359,
    "cashPrice": 359,
    "canonicalUrl": "https://www.amazon.com.br/dp/B09B8V1LZ3",
    "price": 379,
    "additionalProperties": [
      {
        "name": "Marca",
        "value": "Amazon"
      }
    ],
    "regularPrice": 429,
    "sellerName": "Amazon.com.br",
    "itemCondition": "new",
    "images": [
      {
        "url": "https://m.media-amazon.com/images/I/echo-dot-main.jpg"
      }
    ],
    "brand": {
      "name": "Amazon"
    },
    "aggregateRating": {
      "ratingValue": 4.8,
      "bestRating": 5,
      "reviewCount": 10234
    },
    "currency": "BRL",
    "currencyRaw": "R$",
    "breadcrumbs": [
      {
        "name": "Eletronicos",
        "url": "https://www.amazon.com.br/eletronicos"
      }
    ],
    "description": "Smart speaker com Alexa integrada.",
    "mainImage": {
      "url": "https://m.media-amazon.com/images/I/echo-dot-main.jpg"
    },
    "sku": "B09B8V1LZ3",
    "availability": "InStock",
    "name": "Echo Dot 5a geracao",
    "url": "https://www.amazon.com.br/dp/B09B8V1LZ3",
    "otherSellers": [
      {
        "sellerName": "Loja Parceira Prime",
        "price": 389,
        "sellerUrl": "https://www.amazon.com.br/sp?seller=A1SELLER123",
        "sellerId": "A1SELLER123"
      }
    ],
    "sellerId": "A1AMAZONBR",
    "sellerUrl": "https://www.amazon.com.br/sp?seller=A1AMAZONBR",
    "installmentPrice": "31.58",
    "installmentCount": 12,
    "mpn": "ECHODOT5",
    "size": "Padrao",
    "color": "Preto",
    "style": "Com relogio",
    "sellerSocialReason": "Amazon Servicos de Varejo do Brasil Ltda",
    "sellerCnpj": "15.436.940/0001-03",
    "sellerAddress": "Av. Juscelino Kubitschek, 2041",
    "sellerCity": "Sao Paulo",
    "sellerState": "SP",
    "sellerCountry": "Brasil"
  }
}

Referência completa de campos

Path Tipo Descrição Exemplo
data.additionalProperties[].name string Campo data.additionalProperties[].name retornado no payload de resposta. Marca
data.additionalProperties[].value string Campo data.additionalProperties[].value retornado no payload de resposta. Amazon
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.8
data.aggregateRating.reviewCount number Campo data.aggregateRating.reviewCount retornado no payload de resposta. 10234
data.availability string Campo data.availability retornado no payload de resposta. InStock
data.brand.name string Campo data.brand.name retornado no payload de resposta. Amazon
data.breadcrumbs[].name string Campo data.breadcrumbs[].name retornado no payload de resposta. Eletronicos
data.breadcrumbs[].url string Campo data.breadcrumbs[].url retornado no payload de resposta. https://www.amazon.com.br/eletronicos
data.canonicalUrl string Campo data.canonicalUrl retornado no payload de resposta. https://www.amazon.com.br/dp/B09B8V1LZ3
data.cashPrice number Campo data.cashPrice retornado no payload de resposta. 359
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. Smart speaker com Alexa integrada.
data.images[].url string Campo data.images[].url retornado no payload de resposta. https://m.media-amazon.com/images/I/echo-dot-main.jpg
data.installmentCount number Campo data.installmentCount retornado no payload de resposta. 12
data.installmentPrice string Campo data.installmentPrice retornado no payload de resposta. 31.58
data.isInternational boolean Campo data.isInternational retornado no payload de resposta. false
data.itemCondition string Campo data.itemCondition retornado no payload de resposta. new
data.mainImage.url string Campo data.mainImage.url retornado no payload de resposta. https://m.media-amazon.com/images/I/echo-dot-main.jpg
data.mpn string Campo data.mpn retornado no payload de resposta. ECHODOT5
data.name string Campo data.name retornado no payload de resposta. Echo Dot 5a geracao
data.otherSellers[].price number Campo data.otherSellers[].price retornado no payload de resposta. 389
data.otherSellers[].sellerId string Campo data.otherSellers[].sellerId retornado no payload de resposta. A1SELLER123
data.otherSellers[].sellerName string Campo data.otherSellers[].sellerName retornado no payload de resposta. Loja Parceira Prime
data.otherSellers[].sellerUrl string Campo data.otherSellers[].sellerUrl retornado no payload de resposta. https://www.amazon.com.br/sp?seller=A1SELLER123
data.price number Campo data.price retornado no payload de resposta. 379
data.regularPrice number Campo data.regularPrice retornado no payload de resposta. 429
data.sellerAddress string Campo data.sellerAddress retornado no payload de resposta. Av. Juscelino Kubitschek, 2041
data.sellerCity string Campo data.sellerCity retornado no payload de resposta. Sao Paulo
data.sellerCnpj string Campo data.sellerCnpj retornado no payload de resposta. 15.436.940/0001-03
data.sellerCountry string Campo data.sellerCountry retornado no payload de resposta. Brasil
data.sellerId string Campo data.sellerId retornado no payload de resposta. A1AMAZONBR
data.sellerName string Campo data.sellerName retornado no payload de resposta. Amazon.com.br
data.sellerSocialReason string Campo data.sellerSocialReason retornado no payload de resposta. Amazon Servicos de Varejo do Brasil Ltda
data.sellerState string Campo data.sellerState retornado no payload de resposta. SP
data.sellerUrl string Campo data.sellerUrl retornado no payload de resposta. https://www.amazon.com.br/sp?seller=A1AMAZONBR
data.shippingFee.shippingFee string Campo data.shippingFee.shippingFee retornado no payload de resposta. R$ 12,90
data.shippingFee.zipCode string Campo data.shippingFee.zipCode retornado no payload de resposta. 80000-000
data.size string Campo data.size retornado no payload de resposta. Padrao
data.sku string Campo data.sku retornado no payload de resposta. B09B8V1LZ3
data.style string Campo data.style retornado no payload de resposta. Com relogio
data.taxFreePrice number Campo data.taxFreePrice retornado no payload de resposta. 359
data.url string Campo data.url retornado no payload de resposta. https://www.amazon.com.br/dp/B09B8V1LZ3
data.variants[].asin string Campo data.variants[].asin retornado no payload de resposta. B09B8V1LZ3
data.variants[].url string Campo data.variants[].url retornado no payload de resposta. https://www.amazon.com.br/dp/B09B8V1LZ3
executionId string (uuid) Campo executionId retornado no payload de resposta. 44444444-2222-4222-8222-444444444444
requestId string (uuid) Campo requestId retornado no payload de resposta. 44444444-1111-4111-8111-444444444444

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.