// docs
Extrai produto Electrolux 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.
curl -X POST https://api.geckoapi.com.br/v1/extract \
-H "Authorization: Bearer SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"target": "loja.electrolux.com.br",
"type": "pdp",
"url": "https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p"
}'
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.
Endpoint
POST /v1/mcp
Tool name
loja_electrolux_com_br_pdp
Auth
Bearer ou X-API-Key
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "loja_electrolux_com_br_pdp",
"arguments": {
"url": "https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p",
"executionId": "exec_example_123"
}
}
}
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 de loja.electrolux.com.br terminando em /p, opcionalmente com ?skuId=ID. O SKU precisa pertencer ao produto. Sufixos numéricos no slug são preservados. | - | https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p |
| target Fonte alvo da extração. | enum | Obrigatório | Use loja.electrolux.com.br. | loja.electrolux.com.br | loja.electrolux.com.br |
| type Tipo da extração: pdp, idp, plp, ilp, quote, review ou places. | enum | Obrigatório | Use pdp. | pdp | pdp |
Cada consulta PDP custa 1 crédito. Sem skuId, seleciona a primeira variação disponível, ou a primeira se todas estiverem indisponíveis.
{
"target": "loja.electrolux.com.br",
"type": "pdp",
"url": "https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p"
}Use uma URL de variants[].url para consultar a oferta daquela variação.
{
"target": "loja.electrolux.com.br",
"type": "pdp",
"url": "https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p?skuId=310128356"
}Mapa de paths de saída com tipo esperado para esta API.
{
"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"
}{
"requestId": "d68564d2-34bc-47e6-a1a6-796794f8463b",
"executionId": "f7b0f7f6-3363-4958-9f7e-6c0e0d189874",
"data": {
"extractedAt": "2026-09-30T18:03:17.890Z",
"canonicalUrl": "https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p",
"url": "https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p?skuId=310128356",
"productId": "2011348",
"sku": "310128356",
"name": "Geladeira Electrolux Frost Free 320L Duplex Branca (TF38)",
"price": 2599,
"regularPrice": 3189,
"cashPrice": 2599,
"installmentPrice": 236.27,
"installmentCount": 11,
"sellerName": "Electrolux",
"sellerId": "1",
"sellerUrl": null,
"availability": "InStock",
"currency": "BRL",
"currencyRaw": "R$",
"description": "A Geladeira Electrolux Frost Free 320L Duplex Branca (TF38 ) tem a exclusiva Gaveta HortiFruti : organizar e visualizar suas frutas e legumes nunca foi tão fácil. Esse espaço dedicado previne o desperdício e mantém seus alimentos frescos por mais tempo. O novo design é robusto e garante que esse refrigerador seja não apenas durável, mas também prático, adaptando-se perfeitamente à sua rotina e às suas necessidades de armazenamento. E, para aqueles momentos em que você precisa de resfriamento rápido, o Turbo Freezer é a solução ideal, perfeito para festas ou para quando você chega em casa com a",
"descriptionHtml": "<p>A Geladeira Electrolux Frost Free 320L Duplex Branca (TF38 ) tem a exclusiva Gaveta HortiFruti : organizar e visualizar suas frutas e legumes nunca foi tão fácil. Esse espaço dedicado previne o desperdício e mantém seus alimentos frescos por mais tempo. O novo design é robusto e garante que esse refrigerador seja não apenas durável, mas também prático, adaptando-se perfeitamente à sua rotina e às suas necessidades de armazenamento. E, para aqueles momentos em que você precisa de resfriamento rápido, o Turbo Freezer é a solução ideal, perfeito para festas ou para quando você chega em casa com a</p>",
"images": [
{
"url": "https://electrolux.vteximg.com.br/arquivos/ids/292138/Refrigerator_TF38_Front_Electrolux_Portuguese-1000x1000.raw.jpg?v=639102192178870000"
},
{
"url": "https://electrolux.vteximg.com.br/arquivos/ids/292139/Refrigerator_TF38_Dimensions_Electrolux_Portuguese-1000x1000.raw.jpg?v=639102192179300000"
}
],
"mainImage": {
"url": "https://electrolux.vteximg.com.br/arquivos/ids/292138/Refrigerator_TF38_Front_Electrolux_Portuguese-1000x1000.raw.jpg?v=639102192178870000"
},
"brand": {
"name": "Electrolux"
},
"aggregateRating": null,
"breadcrumbs": [
{
"name": "Eletrodomésticos"
},
{
"name": "Geladeiras "
},
{
"name": " Refrigeradores"
},
{
"name": "Geladeira frost free"
}
],
"additionalProperties": [
{
"name": "Serviço",
"value": "310131083",
"section": "Serviços"
},
{
"name": "Manual do produto",
"value": "https://electrolux.vtexcrm.com.br/DynamicForm/GetFile?dataEntityInstanceId=MN-375e4551-4482-4daa-85ec-94d8e5045978&fileName=G0045837_IM_DB44_DB44S_IB45_IB45S_IB54_IB54S_IB54B_IB55_IB55S_IF43_IF43S_IB43B_IW43S_IF45_IF45S_IW45S-583x1296.raw.pdf",
"section": "Apoio ao Cliente"
},
{
"name": "Infográfico",
"value": "https://content.electrolux.com.br/brasil/electrolux/tokyo/v2/tf38/index.html",
"section": "Apoio ao Cliente"
},
{
"name": "Guia rápido",
"value": "https://api.electrolux-medialibrary.com/asset/b92f105e-cf0c-4cfe-8bfc-f757d229daa1/E4RM3Q/250830DD6P/PDF/250830DD6P.pdf",
"section": "Apoio ao Cliente"
},
{
"name": "Vídeos",
"value": "https://youtu.be/Ss76hwG6viM",
"section": null
},
{
"name": "Água na porta",
"value": "Não",
"section": "Este Produto inclui"
}
],
"variants": [
{
"sku": "310128356",
"name": "127V",
"url": "https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p?skuId=310128356",
"image": "https://electrolux.vteximg.com.br/arquivos/ids/292138/Refrigerator_TF38_Front_Electrolux_Portuguese-1000x1000.raw.jpg?v=639102192178870000",
"voltage": "127V",
"ean": "7909569472170",
"available": true,
"price": 2599,
"regularPrice": 3189,
"cashPrice": 2599,
"installmentPrice": 236.27,
"installmentCount": 11,
"sellerId": "1",
"sellerName": "Electrolux"
},
{
"sku": "310128357",
"name": "220V",
"url": "https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p?skuId=310128357",
"image": "https://electrolux.vteximg.com.br/arquivos/ids/292149/Refrigerator_TF38_Front_Electrolux_Portuguese-1000x1000.raw.jpg?v=639102192182600000",
"voltage": "220V",
"ean": "7909569472187",
"available": true,
"price": 2599,
"regularPrice": 3189,
"cashPrice": 2599,
"installmentPrice": 236.27,
"installmentCount": 11,
"sellerId": "1",
"sellerName": "Electrolux"
}
],
"color": "Branco",
"size": null,
"voltage": "127V",
"otherSellers": [],
"mpn": "924263178",
"features": [
"Alarme de porta aberta",
"Cesta porta ovos"
],
"ean": "7909569472170",
"shippingDetails": null
}
}| Path | Tipo | Descrição | Exemplo |
|---|---|---|---|
| data.additionalProperties[].name | string | Nome da especificação publicada. | Serviço |
| data.additionalProperties[].section | string | null | Grupo da especificação, quando informado. | Serviços |
| data.additionalProperties[].value | string | Valor textual da especificação. | 310131083 |
| 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. | Electrolux |
| 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://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p |
| data.cashPrice | number | null | Menor valor em uma parcela publicado na oferta; não pressupõe desconto no Pix. | 2599 |
| data.color | string | null | Cor informada no catálogo. | Branco |
| 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. | A Geladeira Electrolux Frost Free 320L Duplex Branca (TF38 ) tem a exclusiva Gaveta HortiFruti : organizar e visualizar suas frutas e legumes nunca foi tão fácil. Esse espaço dedicado previne o desperdício e mantém seus alimentos frescos por mais tempo. O novo design é robusto e garante que esse refrigerador seja não apenas durável, mas também prático, adaptando-se perfeitamente à sua rotina e às suas necessidades de armazenamento. E, para aqueles momentos em que você precisa de resfriamento rápido, o Turbo Freezer é a solução ideal, perfeito para festas ou para quando você chega em casa com a |
| data.descriptionHtml | string | null | Descrição HTML publicada pela origem; sanitize antes de exibir como HTML. | <p>A Geladeira Electrolux Frost Free 320L Duplex Branca (TF38 ) tem a exclusiva Gaveta HortiFruti : organizar e visualizar suas frutas e legumes nunca foi tão fácil. Esse espaço dedicado previne o desperdício e mantém seus alimentos frescos por mais tempo. O novo design é robusto e garante que esse refrigerador seja não apenas durável, mas também prático, adaptando-se perfeitamente à sua rotina e às suas necessidades de armazenamento. E, para aqueles momentos em que você precisa de resfriamento rápido, o Turbo Freezer é a solução ideal, perfeito para festas ou para quando você chega em casa com a</p> |
| data.ean | string | null | EAN da variação, quando informado. | 7909569472170 |
| data.extractedAt | string | Data e hora da extração em ISO 8601. | 2026-09-30T18:03:17.890Z |
| data.features[] | string | Destaques publicados no catálogo. | Alarme de porta aberta |
| data.images[].url | string | URL da imagem do SKU selecionado. | https://electrolux.vteximg.com.br/arquivos/ids/292138/Refrigerator_TF38_Front_Electrolux_Portuguese-1000x1000.raw.jpg?v=639102192178870000 |
| data.installmentCount | number | null | Quantidade de parcelas sem juros em cartão de crédito dessa opção. | 11 |
| data.installmentPrice | number | null | Valor da parcela da opção com mais parcelas sem juros em cartão de crédito, quando disponível. | 236.27 |
| data.mainImage.url | string | URL da imagem do SKU selecionado. | https://electrolux.vteximg.com.br/arquivos/ids/292138/Refrigerator_TF38_Front_Electrolux_Portuguese-1000x1000.raw.jpg?v=639102192178870000 |
| data.mpn | string | null | Referência do fabricante para a variação; usa a referência do produto como alternativa. | 924263178 |
| data.name | string | Nome publicado pela origem. | Geladeira Electrolux Frost Free 320L Duplex Branca (TF38) |
| 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. | 2599 |
| data.productId | string | Identificador do produto no catálogo Electrolux. | 2011348 |
| data.regularPrice | number | null | Preço de referência em reais, quando informado. | 3189 |
| data.sellerId | string | null | Identificador do vendedor da oferta. | 1 |
| data.sellerName | string | null | Nome do vendedor da oferta. | Electrolux |
| 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. | 310128356 |
| data.url | string | URL pública; no produto, skuId identifica a variação selecionada. | https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p?skuId=310128356 |
| 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. | 2599 |
| data.variants[].ean | string | null | EAN da variação, quando informado. | 7909569472170 |
| data.variants[].image | string | null | Imagem principal da variação. | https://electrolux.vteximg.com.br/arquivos/ids/292138/Refrigerator_TF38_Front_Electrolux_Portuguese-1000x1000.raw.jpg?v=639102192178870000 |
| data.variants[].installmentCount | number | null | Quantidade de parcelas sem juros em cartão de crédito dessa opção. | 11 |
| 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. | 236.27 |
| data.variants[].name | string | Nome da variação, frequentemente sua voltagem. | 127V |
| data.variants[].price | number | null | Preço atual em reais; null quando a oferta está indisponível ou sem preço. | 2599 |
| data.variants[].regularPrice | number | null | Preço de referência em reais, quando informado. | 3189 |
| data.variants[].sellerId | string | null | Identificador do vendedor da oferta. | 1 |
| data.variants[].sellerName | string | null | Nome do vendedor da oferta. | Electrolux |
| data.variants[].sku | string | Identificador da variação (SKU); voltagens diferentes podem ter SKUs distintos. | 310128356 |
| data.variants[].url | string | URL pública com skuId para consultar essa variação no PDP. | https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p?skuId=310128356 |
| data.variants[].voltage | string | null | Voltagem da variação, como 110V, 220V ou Bivolt, quando informada. | 127V |
| data.voltage | string | null | Voltagem da variação, como 110V, 220V ou Bivolt, quando informada. | 127V |
| 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 |
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. |