// docs

Brastemp PDP

Extrai produto Brastemp com preços, parcelamento, imagens, ficha técnica, EAN e variações de voltagem. Cada consulta PDP custa 1 crédito.

Tempo de resposta: Preço e disponibilidade refletem o catálogo sem CEP. Avaliações e frete não são fornecidos. Campos não informados pela origem são null; listas podem ser vazias. O exemplo resume a galeria e os atributos da resposta.

Nota importante: alguns campos podem retornar null em produção, dependendo da página de origem. Consulte o schema e a descrição de cada campo para tratar valores ausentes; os exemplos mostram uma resposta possível.

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.

Chamada HTTP

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "brastemp.com.br",
  "type": "pdp",
  "url": "https://www.brastemp.com.br/geladeira-inteligente-b-smart-brastemp-frost-free-3-portas-french-door-630-litros-cor-inox-bro88ak/p"
}'

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

brastemp_com_br_pdp

Auth

Bearer ou X-API-Key

brastemp_com_br_pdp tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "brastemp_com_br_pdp",
    "arguments": {
      "url": "https://www.brastemp.com.br/geladeira-inteligente-b-smart-brastemp-frost-free-3-portas-french-door-630-litros-cor-inox-bro88ak/p",
      "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	URL pública Brastemp /slug/p, opcionalmente com ?skuId=ID. URLs /slug-SKU/p também são aceitas. O SKU precisa pertencer ao produto.	-	https://www.brastemp.com.br/geladeira-inteligente-b-smart-brastemp-frost-free-3-portas-french-door-630-litros-cor-inox-bro88ak/p
target Fonte alvo da extração.	enum	Obrigatório	Use brastemp.com.br.	brastemp.com.br	brastemp.com.br
type Tipo da extração: pdp, idp, plp, ilp, quote, review ou places.	enum	Obrigatório	Use pdp.	pdp	pdp

Exemplos de request

Produto por URL

Cada consulta PDP custa 1 crédito. Sem skuId, seleciona a primeira variação disponível, ou a primeira se todas estiverem indisponíveis.

Produto por URL

{
  "target": "brastemp.com.br",
  "type": "pdp",
  "url": "https://www.brastemp.com.br/geladeira-inteligente-b-smart-brastemp-frost-free-3-portas-french-door-630-litros-cor-inox-bro88ak/p"
}

Selecionar uma voltagem por SKU

Use uma URL de variants[].url para consultar a oferta daquela variação.

Selecionar uma voltagem por SKU

{
  "target": "brastemp.com.br",
  "type": "pdp",
  "url": "https://www.brastemp.com.br/geladeira-inteligente-b-smart-brastemp-frost-free-3-portas-french-door-630-litros-cor-inox-bro88ak/p?skuId=326199396"
}

Schema de response (leaf paths)

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

responseSchema

{
  "requestId": "string",
  "executionId": "string",
  "data.extractedAt": "string",
  "data.canonicalUrl": "string",
  "data.url": "string",
  "data.productId": "string",
  "data.sku": "string",
  "data.name": "string",
  "data.price": "number | null",
  "data.regularPrice": "number | null",
  "data.cashPrice": "number | null",
  "data.installmentPrice": "number | null",
  "data.installmentCount": "number | null",
  "data.sellerName": "string | null",
  "data.sellerId": "string | null",
  "data.sellerUrl": "null",
  "data.availability": "string | null",
  "data.currency": "string",
  "data.currencyRaw": "string",
  "data.description": "string | null",
  "data.descriptionHtml": "string | null",
  "data.images[].url": "string",
  "data.mainImage.url": "string",
  "data.brand.name": "string",
  "data.aggregateRating": "null",
  "data.breadcrumbs[].name": "string",
  "data.additionalProperties[].name": "string",
  "data.additionalProperties[].value": "string",
  "data.additionalProperties[].section": "string | null",
  "data.variants[].sku": "string",
  "data.variants[].name": "string",
  "data.variants[].url": "string",
  "data.variants[].image": "string | null",
  "data.variants[].voltage": "string | null",
  "data.variants[].ean": "string | null",
  "data.variants[].available": "boolean | null",
  "data.variants[].price": "number | null",
  "data.variants[].regularPrice": "number | null",
  "data.variants[].cashPrice": "number | null",
  "data.variants[].installmentPrice": "number | null",
  "data.variants[].installmentCount": "number | null",
  "data.variants[].sellerId": "string | null",
  "data.variants[].sellerName": "string | null",
  "data.color": "string | null",
  "data.size": "null",
  "data.voltage": "string | null",
  "data.otherSellers": "array",
  "data.mpn": "string | null",
  "data.features[]": "string",
  "data.ean": "string | null",
  "data.shippingDetails": "null"
}

Exemplo de response

responseExample

{
  "requestId": "d68564d2-34bc-47e6-a1a6-796794f8463b",
  "executionId": "f7b0f7f6-3363-4958-9f7e-6c0e0d189874",
  "data": {
    "extractedAt": "2026-09-30T16:37:16.066Z",
    "canonicalUrl": "https://www.brastemp.com.br/geladeira-inteligente-b-smart-brastemp-frost-free-3-portas-french-door-630-litros-cor-inox-bro88ak/p",
    "url": "https://www.brastemp.com.br/geladeira-inteligente-b-smart-brastemp-frost-free-3-portas-french-door-630-litros-cor-inox-bro88ak/p?skuId=326199396",
    "productId": "20128057",
    "sku": "326199396",
    "name": "Geladeira Inteligente B= Smart 3 Portas French Door Frost Free 630L Inox Brastemp - BRO88AK",
    "price": 6999,
    "regularPrice": 6999,
    "cashPrice": 6999,
    "installmentPrice": 333.28,
    "installmentCount": 21,
    "sellerName": "Brastemp",
    "sellerId": "1",
    "sellerUrl": null,
    "availability": "InStock",
    "currency": "BRL",
    "currencyRaw": "R$",
    "description": "Geladeira Brastemp Frost Free 3 Portas 630 Litros. Com funções inteligentes que entendem e acompanham o seu ritmo, a Geladeira Inteligente B= Smart possui sensores inteligentes com IA que mantém a temperatura sempre estável e os seus alimentos frescos por até 44%¹mais tempo . Tenha máxima preservação e versatilidade com o sistema de gavetas que organiza e preserva frutas, legumes e folhas por até 3 semanas² ao toque do botão +FRESH . Organize do seu jeito, com capacidade que comporta a sua vida e o novo design Brastemp : elegante, ousado e que reflete o seu estilo. É outro mundo!",
    "descriptionHtml": "<strong>Geladeira Brastemp Frost Free 3 Portas 630 Litros.</strong> <br/><br/>Com funções inteligentes que entendem e acompanham o seu ritmo, a <strong>Geladeira Inteligente B= Smart </strong>possui <strong>sensores inteligentes com IA</strong> que mantém a temperatura sempre estável e os seus <strong>alimentos frescos por até 44%¹mais tempo</strong>. Tenha máxima preservação e versatilidade com o sistema de gavetas que organiza e preserva frutas, legumes e folhas por até 3 semanas² ao toque do<strong> botão +FRESH</strong>. <br/><br/>Organize do seu jeito, com capacidade que comporta a sua vida e o <strong>novo design Brastemp</strong>: elegante, ousado e que reflete o seu estilo.<br/><br/><u>É outro mundo!</u>",
    "images": [
      {
        "url": "https://brastemp.vteximg.com.br/arquivos/ids/297182/01_Brastemp_Geladeira_BRO88AK.jpg?v=639246598006000000"
      },
      {
        "url": "https://brastemp.vteximg.com.br/arquivos/ids/297183/02_Brastemp_Geladeira_BRO88AK.jpg?v=639246598006000000"
      }
    ],
    "mainImage": {
      "url": "https://brastemp.vteximg.com.br/arquivos/ids/297182/01_Brastemp_Geladeira_BRO88AK.jpg?v=639246598006000000"
    },
    "brand": {
      "name": "Brastemp"
    },
    "aggregateRating": null,
    "breadcrumbs": [
      {
        "name": "Eletrodomésticos"
      },
      {
        "name": "Geladeira - Refrigerador"
      }
    ],
    "additionalProperties": [
      {
        "name": "Capacidade Total (L)",
        "value": "Super Alta - Acima de 550L",
        "section": "Caracteristícas Técnicas"
      },
      {
        "name": "Cor",
        "value": "Inox",
        "section": "Caracteristícas Técnicas"
      },
      {
        "name": "Modelo",
        "value": "BRO88AK",
        "section": "Caracteristícas Técnicas"
      },
      {
        "name": "Voltagem",
        "value": "Bivolt",
        "section": "Variações"
      }
    ],
    "variants": [
      {
        "sku": "326199396",
        "name": "Bivolt",
        "url": "https://www.brastemp.com.br/geladeira-inteligente-b-smart-brastemp-frost-free-3-portas-french-door-630-litros-cor-inox-bro88ak/p?skuId=326199396",
        "image": "https://brastemp.vteximg.com.br/arquivos/ids/297182/01_Brastemp_Geladeira_BRO88AK.jpg?v=639246598006000000",
        "voltage": "Bivolt",
        "ean": "7891129616509",
        "available": true,
        "price": 6999,
        "regularPrice": 6999,
        "cashPrice": 6999,
        "installmentPrice": 333.28,
        "installmentCount": 21,
        "sellerId": "1",
        "sellerName": "Brastemp"
      }
    ],
    "color": "Inox",
    "size": null,
    "voltage": "Bivolt",
    "otherSellers": [],
    "mpn": "BRO88AKXNA",
    "features": [
      "Geladeira Brastemp Frost Free 3 Portas 630 Litros. Com funções inteligentes que entendem e acompanham o seu ritmo, a Geladeira Inteligente B= Smart possui sensores inteligentes com IA que mantém a temperatura sempre estável e os seus alimentos frescos por até 44%[1] mais tempo. Tenha máxima preservação e versatilidade com o sistema de gavetas que organiza e preserva frutas, legumes e folhas por até 3 semanas[2] ao toque do botão +FRESH. Organize do seu jeito, com capacidade que comporta a sua vida e o novo design Brastemp: elegante, ousado e que reflete o seu estilo. É outro mundo!",
      ".",
      "."
    ],
    "ean": "7891129616509",
    "shippingDetails": null
  }
}

Referência completa de campos

Path	Tipo	Descrição	Exemplo
data.additionalProperties[].name	string	Nome da especificação publicada.	Capacidade Total (L)
data.additionalProperties[].section	string \| null	Grupo da especificação, quando informado.	Caracteristícas Técnicas
data.additionalProperties[].value	string	Valor textual da especificação.	Super Alta - Acima de 550L
data.aggregateRating	null	Avaliação agregada; null porque o catálogo consultado não fornece avaliações.	null
data.availability	string \| null	InStock ou OutOfStock; null quando a origem não informa.	InStock
data.brand.name	string	Nome da marca do produto.	Brastemp
data.breadcrumbs[].name	string	Nome de uma categoria no caminho do produto.	Eletrodomésticos
data.canonicalUrl	string	URL canônica do produto sem seleção de SKU.	https://www.brastemp.com.br/geladeira-inteligente-b-smart-brastemp-frost-free-3-portas-french-door-630-litros-cor-inox-bro88ak/p
data.cashPrice	number \| null	Menor valor em uma parcela publicado na oferta; não pressupõe desconto no Pix.	6999
data.color	string \| null	Cor informada no catálogo.	Inox
data.currency	string	Moeda da oferta: BRL.	BRL
data.currencyRaw	string	Símbolo da moeda: R$.	R$
data.description	string \| null	Descrição textual do produto, com tags HTML removidas.	Geladeira Brastemp Frost Free 3 Portas 630 Litros. Com funções inteligentes que entendem e acompanham o seu ritmo, a Geladeira Inteligente B= Smart possui sensores inteligentes com IA que mantém a temperatura sempre estável e os seus alimentos frescos por até 44%¹mais tempo . Tenha máxima preservação e versatilidade com o sistema de gavetas que organiza e preserva frutas, legumes e folhas por até 3 semanas² ao toque do botão +FRESH . Organize do seu jeito, com capacidade que comporta a sua vida e o novo design Brastemp : elegante, ousado e que reflete o seu estilo. É outro mundo!
data.descriptionHtml	string \| null	Descrição HTML publicada pela origem; sanitize antes de exibir como HTML.	<strong>Geladeira Brastemp Frost Free 3 Portas 630 Litros.</strong> <br/><br/>Com funções inteligentes que entendem e acompanham o seu ritmo, a <strong>Geladeira Inteligente B= Smart </strong>possui <strong>sensores inteligentes com IA</strong> que mantém a temperatura sempre estável e os seus <strong>alimentos frescos por até 44%¹mais tempo</strong>. Tenha máxima preservação e versatilidade com o sistema de gavetas que organiza e preserva frutas, legumes e folhas por até 3 semanas² ao toque do<strong> botão +FRESH</strong>. <br/><br/>Organize do seu jeito, com capacidade que comporta a sua vida e o <strong>novo design Brastemp</strong>: elegante, ousado e que reflete o seu estilo.<br/><br/><u>É outro mundo!</u>
data.ean	string \| null	EAN da variação, quando informado.	7891129616509
data.extractedAt	string	Data e hora da extração em ISO 8601.	2026-09-30T16:37:16.066Z
data.features[]	string	Destaques publicados no catálogo.	Geladeira Brastemp Frost Free 3 Portas 630 Litros. Com funções inteligentes que entendem e acompanham o seu ritmo, a Geladeira Inteligente B= Smart possui sensores inteligentes com IA que mantém a temperatura sempre estável e os seus alimentos frescos por até 44%[1] mais tempo. Tenha máxima preservação e versatilidade com o sistema de gavetas que organiza e preserva frutas, legumes e folhas por até 3 semanas[2] ao toque do botão +FRESH. Organize do seu jeito, com capacidade que comporta a sua vida e o novo design Brastemp: elegante, ousado e que reflete o seu estilo. É outro mundo!
data.images[].url	string	URL da imagem do SKU selecionado.	https://brastemp.vteximg.com.br/arquivos/ids/297182/01_Brastemp_Geladeira_BRO88AK.jpg?v=639246598006000000
data.installmentCount	number \| null	Quantidade de parcelas sem juros em cartão de crédito dessa opção.	21
data.installmentPrice	number \| null	Valor da parcela da opção com mais parcelas sem juros em cartão de crédito, quando disponível.	333.28
data.mainImage.url	string	URL da imagem do SKU selecionado.	https://brastemp.vteximg.com.br/arquivos/ids/297182/01_Brastemp_Geladeira_BRO88AK.jpg?v=639246598006000000
data.mpn	string \| null	Referência do fabricante para a variação; usa a referência do produto como alternativa.	BRO88AKXNA
data.name	string	Nome publicado pela origem.	Geladeira Inteligente B= Smart 3 Portas French Door Frost Free 630L Inox Brastemp - BRO88AK
data.otherSellers	array	Outros vendedores da mesma variação, quando presentes.	[]
data.price	number \| null	Preço atual em reais; null quando a oferta está indisponível ou sem preço.	6999
data.productId	string	Identificador do produto no catálogo Brastemp.	20128057
data.regularPrice	number \| null	Preço de referência em reais, quando informado.	6999
data.sellerId	string \| null	Identificador do vendedor da oferta.	1
data.sellerName	string \| null	Nome do vendedor da oferta.	Brastemp
data.sellerUrl	null	URL do vendedor quando disponível; atualmente null nesta origem.	null
data.shippingDetails	null	null: esta API não calcula frete nem disponibilidade por CEP.	null
data.size	null	Tamanho; null quando não se aplica.	null
data.sku	string	Identificador da variação (SKU); voltagens diferentes podem ter SKUs distintos.	326199396
data.url	string	URL pública; no produto, skuId identifica a variação selecionada.	https://www.brastemp.com.br/geladeira-inteligente-b-smart-brastemp-frost-free-3-portas-french-door-630-litros-cor-inox-bro88ak/p?skuId=326199396
data.variants[].available	boolean \| null	Disponibilidade do SKU selecionado; null quando a origem não informa.	true
data.variants[].cashPrice	number \| null	Menor valor em uma parcela publicado na oferta; não pressupõe desconto no Pix.	6999
data.variants[].ean	string \| null	EAN da variação, quando informado.	7891129616509
data.variants[].image	string \| null	Imagem principal da variação.	https://brastemp.vteximg.com.br/arquivos/ids/297182/01_Brastemp_Geladeira_BRO88AK.jpg?v=639246598006000000
data.variants[].installmentCount	number \| null	Quantidade de parcelas sem juros em cartão de crédito dessa opção.	21
data.variants[].installmentPrice	number \| null	Valor da parcela da opção com mais parcelas sem juros em cartão de crédito, quando disponível.	333.28
data.variants[].name	string	Nome da variação, frequentemente sua voltagem.	Bivolt
data.variants[].price	number \| null	Preço atual em reais; null quando a oferta está indisponível ou sem preço.	6999
data.variants[].regularPrice	number \| null	Preço de referência em reais, quando informado.	6999
data.variants[].sellerId	string \| null	Identificador do vendedor da oferta.	1
data.variants[].sellerName	string \| null	Nome do vendedor da oferta.	Brastemp
data.variants[].sku	string	Identificador da variação (SKU); voltagens diferentes podem ter SKUs distintos.	326199396
data.variants[].url	string	URL pública com skuId para consultar essa variação no PDP.	https://www.brastemp.com.br/geladeira-inteligente-b-smart-brastemp-frost-free-3-portas-french-door-630-litros-cor-inox-bro88ak/p?skuId=326199396
data.variants[].voltage	string \| null	Voltagem da variação, como 110V, 220V ou Bivolt, quando informada.	Bivolt
data.voltage	string \| null	Voltagem da variação, como 110V, 220V ou Bivolt, quando informada.	Bivolt
executionId	string	Identificador da execução do worker.	f7b0f7f6-3363-4958-9f7e-6c0e0d189874
requestId	string	Identificador da requisição HTTP na GeckoAPI.	d68564d2-34bc-47e6-a1a6-796794f8463b

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.