Americanas Product Scraper 🇧🇷

Scrape produtos da Americanas.com.br — segundo maior e-commerce do Brasil — com preços atualizados, descontos, preço Pix, informações de seller, estoque e imagens.

Usa a API VTEX Catalog diretamente (sem browser, sem puppeteer). Resultado: execuções rápidas (~5-10s para 50 produtos), sem risco de bloqueio por bot detection.

---

O que você recebe

Campo	Descrição
productId	ID único do produto
name	Nome completo
brand	Marca
category	Categoria (ex: /Eletrônicos/Celulares e Smartphones/)
url	URL da página do produto
imageUrl	URL da imagem principal
ean	Código EAN/barras
price	Preço atual em R$
originalPrice	Preço de lista (sem desconto) em R$
discountPct	Percentual de desconto
pixPrice	Preço no Pix (quando disponível)
available	true se em estoque
availableQty	Quantidade em estoque
seller	Nome do vendedor principal
description	Descrição do produto (até 500 chars)
scrapedAt	Timestamp da extração

---

Como usar

Busca por termo

{
    "searchTerm": "smartphone samsung",
    "maxItems": 50
}

Busca por URL

{
    "searchUrl": "https://www.americanas.com.br/busca/notebook",
    "maxItems": 100,
    "onlyAvailable": true
}

---

Casos de uso

• Price monitoring — monitorar preços de produtos ao longo do tempo
• Análise de mercado — comparar preços entre sellers no mesmo marketplace
• Pesquisa de produtos — coletar catálogo de uma categoria específica
• Comparação de preços — integrar com outras ferramentas de comparação

---

Detalhes técnicos

• API: VTEX Catalog (/api/catalog_system/pub/products/search/{term})
• Sem browser — HTTP puro via got-scraping
• Paginação automática — percorre todas as páginas até maxItems
• Preço Pix — extraído das opções de pagamento quando disponível
• Multi-seller — prioriza o seller com estoque disponível

---

Preço

Pay-Per-Event (PPE): $0.0005 por produto extraído.

Para 1.000 produtos = $0.50 USD.

---

Exemplo de output

{
    "productId": "1234567",
    "name": "Smartphone Samsung Galaxy A54 5G 128GB Preto",
    "brand": "Samsung",
    "category": "/Celulares e Smartphones/Smartphone/",
    "url": "https://www.americanas.com.br/smartphone-samsung-galaxy-a54.../p",
    "imageUrl": "https://americanas.vtexassets.com/arquivos/ids/...",
    "ean": "7892509103456",
    "skuId": "8901234",
    "price": 1299.00,
    "originalPrice": 1899.00,
    "discountPct": 32,
    "pixPrice": 1169.10,
    "available": true,
    "availableQty": 5,
    "seller": "AMERICANAS SA",
    "description": "Smartphone Samsung Galaxy A54 5G com tela Super AMOLED...",
    "scrapedAt": "2026-03-31T18:00:00.000Z"
}