Americanas Scraper: Brazil Product Prices, Sellers & Offers API

Scrape Americanas Brazil (americanas.com.br) product prices, discounts, Pix and cash offers, installment plans, marketplace sellers and stock at scale. This Americanas scraper turns any search term, category or catalog URL into clean JSON, CSV or Excel for price monitoring, competitor tracking and product research across Brazilian e-commerce. No login, no browser, no official API key.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

What it does

The Americanas scraper queries the Americanas Brazil catalog by search term, category or a raw catalog URL, applies your price, brand, stock and sort filters, paginates through every matching product, and writes one normalized record per SKU and seller to the run dataset. Prices, list prices and discount percentages are returned as numbers. The full installment plan table (parcelamento) is captured per payment method, accepted payment methods are listed, marketplace vs first-party sellers are flagged, and any missing source value is returned as an honest null instead of a fabricated value.

Use it for retail price monitoring in Brazil, competitor price tracking, MAP compliance, catalog enrichment, assortment analysis, and building product and price datasets for Brazilian e-commerce.

Why this scraper

• Most complete field set. Over 50 fields per offer, including EAN, SKU, brand, full category breadcrumb, all images, specifications, installment table, payment methods, promotions and seller type.
• Honest discounts. The discount is computed against a trusted reference price, so an inflated placeholder list price can never fake a large markdown. hasDiscount, discountPercent and discountAmount reflect a genuine markdown only.
• Pix and cash signals. Cash and Pix offers surface through spotPrice and the promotion teasers, so you see the real checkout price story.
• Marketplace aware. Every third-party seller and first-party (1P) offer is captured with sellerName, sellerId and an isMarketplace flag.
• Optional AI add-ons. Clean and translate descriptions, or extract structured attributes and English keyword tags (paid plans only, billed only when produced).

Quickstart

Open the actor, paste this into the input, and press Run. It returns the first 10 coffee machine offers.

{
  "searchTerm": "cafeteira",
  "maxProducts": 10,
  "sortOrder": "OrderByBestDiscountDESC",
  "onlyAvailable": true
}

Provide a searchTerm, a categoryId, or a startUrl. Combine searchTerm with categoryId to search inside one category, and add minPrice, maxPrice or brands to narrow the results.

How it compares

Capability	This actor (scrapers_lat)	gio21/americanas-product-scraper	latinamericadata/americanas-brasil
Search term input	Yes	Yes	Yes
Category input	Yes (id or path)	No	No
Website or catalog URL input	Yes	Yes (search URL)	No
Price range filter	Yes	No	No
Brand filter	Yes	No	No
Stock filter	Yes	Yes	No
Sort order	Yes (8 modes)	No	Yes
Product id, SKU, EAN	Yes	Yes	Yes
Price, list price, discount	Yes	Yes	Yes
Reference price and honest discount	Yes	No	No
Installment plan table (parcelamento)	Yes (full table)	No	No
Payment methods	Yes	No	No
Pix and promotion teasers	Yes	Pix price only	No
All images, specifications	Yes	Partial	No
Marketplace vs first-party flag	Yes	Seller name only	Seller name only
Collections, best seller, unit price	Yes	No	No
AI description, translation, attributes	Yes	No	No

This actor accepts every input the listed competitors accept and returns every product field they return, plus the extra fields above. It is a strict superset.

Input reference

Field	Type	Required	Default	Description
searchTerm	string	no	geladeira	Full-text query against the Americanas catalog, for example iphone, tênis nike.
categoryId	string	no	(none)	Restrict to one Americanas category by numeric VTEX id (for example 742) or a category path.
startUrl	string	no	(none)	Advanced. An Americanas search or category URL, or a full catalog search URL. Its parameters take precedence.
maxProducts	integer	no	50	Maximum offers to collect. Each SKU and seller is one record. Free plans are capped at 10 per run.
sortOrder	enum	no	(relevance)	Result order: OrderByPriceASC, OrderByPriceDESC, OrderByTopSaleDESC, OrderByReviewRateDESC, OrderByNameASC, OrderByNameDESC, OrderByReleaseDateDESC, OrderByBestDiscountDESC.
minPrice	integer	no	(none)	Only return offers priced at or above this amount in BRL.
maxPrice	integer	no	(none)	Only return offers priced at or below this amount in BRL.
brands	string[]	no	(none)	Keep only offers whose brand matches one of these names (case insensitive, partial match).
onlyAvailable	boolean	no	false	When on, only offers currently in stock are returned.
withDetails	boolean	no	true	Add-on (paid plans). Adds the full description and specifications table. Billed only when detail content is present.
withAiDescription	boolean	no	false	AI add-on (paid plans). Clean Portuguese description plus an English translation. Billed only when produced.
withAiAttributes	boolean	no	false	AI add-on (paid plans). Structured attributes and English keyword tags. Billed only when produced.
proxyConfiguration	object	no	(off)	Optional Apify proxy. A Brazil residential proxy can help if you hit rate limits.

Output reference

One dataset item per SKU and seller. Values are string, number, integer, boolean, string[], object[], object, or null when the source value is absent.

Field	Type	Description
name	string	Product name.
nameComplete	string	Full SKU name with variant details.
brand	string	Brand name, or null when the source lists a placeholder.
brandId	string	VTEX brand id.
productId	string	Americanas product id.
sku	string	SKU (item) id.
ean	string	EAN or GTIN barcode.
referenceId	string	Seller or catalog reference id.
productReference	string	Product reference value.
productReferenceCode	string	Product reference code.
url	string	Product page URL.
linkText	string	URL slug.
imageUrl	string	Primary image URL.
images	string[]	All image URLs.
categories	string[]	Category breadcrumb, most specific first.
categoryId	string	Leaf category id.
categoryIds	string[]	Numeric category path, leaf first.
collections	string[]	Marketing collections and clusters.
bestSeller	boolean	true when the store flags the item as a best seller.
price	number	Current selling price.
listPrice	number	List (reference) price as reported by the source.
priceWithoutDiscount	number	Price before promotions.
sellingPrice	number	Full selling price.
spotPrice	number	Cash or spot price when the source provides it.
referencePrice	number	Trusted before-price used for discount math, or null.
discountPercent	integer	Discount percent versus the reference price (0 when no genuine markdown).
discountAmount	number	Amount saved in BRL versus the reference price.
hasDiscount	boolean	true only when a genuine markdown exists.
pricePerUnit	number	Price per measurement unit.
currency	string	Always BRL.
priceValidUntil	string	ISO date the price is valid until.
rewardValue	number	Loyalty reward value when present.
tax	number	Tax amount when present.
installments	object	Best interest-free plan {number, value, interestRate, interestFree, total}.
installmentsTable	object[]	Full installment plan table per payment method.
paymentMethods	string[]	Accepted payment methods, for example Pix, Visa, Mastercard, Elo, boleto.
promoTeasers	string[]	Promotion and Pix discount teaser names.
discountHighlights	string[]	Discount highlight promotion names.
availableQuantity	integer	Quantity available for the offer.
isAvailable	boolean	true when the offer is in stock.
sellerName	string	Seller name (marketplace or first-party).
sellerId	string	Seller id.
isMarketplace	boolean	true for third-party marketplace sellers.
measurementUnit	string	Selling unit, for example un.
unitMultiplier	number	Unit multiplier for the price.
isKit	boolean	true when the SKU is a kit or bundle.
releaseDate	string	ISO product release date.
estimatedArrivalDate	string	Estimated arrival date when present.
videos	string[]	Video URLs when present.
description	string	Full product description (details add-on).
specifications	object	Specification name to value map (details add-on).
observedAt	string	ISO 8601 timestamp of collection.
error	string	null on success. On a failed run a single item with a populated error is written instead.
aiDescription	string	Clean Portuguese description from the AI add-on, or null.
aiDescriptionEn	string	English translation from the AI add-on, or null.
aiAttributes	object	Structured attributes and tags from the AI add-on, or null.

Ratings and review counts are not exposed by the Americanas catalog search used here, so those fields are intentionally not returned rather than faked.

Example output record

Real record from a live run (input {"searchTerm": "cafeteira", "sortOrder": "OrderByBestDiscountDESC"}, arrays trimmed for readability):

{
  "name": "Cafeteira Elétrica Oster 2Day 2 em 1 OCAF200",
  "url": "https://www.americanas.com.br/cafeteira-eletrica-oster-2day-2-em-1-ocaf200-8404994/p",
  "productId": "8404994",
  "sku": "8894906",
  "ean": "7898700210309",
  "brand": "Oster",
  "brandId": "774",
  "categories": ["Eletroportáteis > Cafeteira", "Eletroportáteis"],
  "price": 139.99,
  "listPrice": 299.9,
  "referencePrice": 299.9,
  "discountPercent": 53,
  "discountAmount": 159.91,
  "hasDiscount": true,
  "currency": "BRL",
  "installments": { "number": 2, "value": 69.99, "interestRate": 0, "interestFree": true, "total": 139.99 },
  "paymentMethods": ["Hipercard", "Elo", "Pix", "Visa", "Mastercard", "American Express"],
  "promoTeasers": ["BLACKFRIDAY | DESCONTO A VISTA | 5% OFF | PIX | MAGALU | TODOS OS DEPARTAMENTOS"],
  "availableQuantity": 1,
  "isAvailable": true,
  "sellerName": "Magazine Luiza",
  "sellerId": "magazineluiza",
  "isMarketplace": true,
  "specifications": { "marca": "Oster", "voltagem": "110 V", "cor": "Inox / Preto" },
  "observedAt": "2026-09-06T00:12:47.904Z",
  "error": null
}

Run via API and CLI

Start a run and read the dataset. Replace <TOKEN> with your Apify API token.

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~americanas-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerm":"cafeteira","maxProducts":25,"sortOrder":"OrderByPriceASC","onlyAvailable":true}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~americanas-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"categoryId":"742","maxProducts":100,"sortOrder":"OrderByBestDiscountDESC"}'

Apify CLI:

$apify call scrapers_lat/americanas-scraper --input '{"searchTerm":"iphone","maxProducts":50}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV or Excel by changing format:

curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets.

Use cases

• Retail price monitoring in Brazil. Track prices, Pix offers and discounts across Americanas daily.
• Competitor price tracking. Compare your catalog against Americanas first-party and marketplace sellers.
• MAP and promotion compliance. Detect markdowns, promotions and installment offers on your products.
• Market and assortment research. Map brands, categories, best sellers and pricing bands.
• Catalog enrichment. Match by EAN or SKU to enrich your own product data with images and specifications.

Billing and limits

• Pay per result. You are charged per offer returned (result event). See the pricing tab for the current price.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 offers per run. Upgrade for a higher maxProducts.
• Add-ons (withDetails, withAiDescription, withAiAttributes) require a paid plan and are billed per record only when they produce content.

FAQ and troubleshooting

A run returned 0 offers. Why? The search or category matched nothing, or the catalog was briefly unavailable. Zero-result runs are not charged. Loosen the query or remove onlyAvailable.

What counts as one record? Each SKU and seller pairing is one record, so a product sold by several marketplace sellers can yield several records.

How do I find a category id? Open a category on americanas.com.br and read the numeric id, or paste the category URL into startUrl.

Why are the AI fields null? The AI add-ons are off by default and require a paid Apify plan. Enable withAiDescription or withAiAttributes on a paid plan.

Do you return ratings or reviews? No. The catalog search used here does not expose star ratings or review counts, so those fields are not returned rather than faked.

Do I need a login? No. The actor reads only publicly visible catalog data.

Is this an official Americanas tool? No. This actor is independent and has no affiliation with Americanas or Lojas Americanas. It reads only data that is publicly visible.

Related scrapers

• AliExpress Product Scraper: AliExpress products by keyword or URL.
• Amazon Product Scraper: Amazon product data by keyword or ASIN.
• AdondeVivir Scraper: Latin American real estate listings.
• 1688 Wholesale Scraper: 1688.com wholesale supplier and product data.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

Independent tool, not affiliated with Americanas or Lojas Americanas. Accesses only publicly available data.

---

Americanas Scraper: API de Preços, Vendedores e Ofertas do Brasil

Extraia da Americanas (americanas.com.br) preços de produtos, descontos, ofertas no Pix e à vista, planos de parcelamento, vendedores do marketplace e estoque em escala. Este scraper da Americanas transforma qualquer termo de busca, categoria ou URL de catálogo em JSON, CSV ou Excel limpos, para monitoramento de preços, acompanhamento de concorrentes e pesquisa de produtos no e-commerce brasileiro. Sem login, sem navegador e sem chave de API oficial.

📥 Entrada · 📤 Saída · 💰 Preços · ▶️ Exemplos

O que faz

O scraper da Americanas consulta o catálogo da Americanas por termo de busca, categoria ou URL de catálogo, aplica seus filtros de preço, marca, estoque e ordenação, percorre todos os produtos correspondentes e grava um registro normalizado por SKU e vendedor no dataset da execução. Preços, preços de tabela e percentuais de desconto são retornados como números. A tabela completa de parcelamento é capturada por meio de pagamento, os métodos de pagamento aceitos são listados, vendedores do marketplace e do próprio site são identificados, e qualquer valor ausente na fonte é retornado como um null honesto, em vez de um valor inventado.

Use para monitoramento de preços no varejo do Brasil, acompanhamento de preços de concorrentes, verificação de conformidade de preços, enriquecimento de catálogo, análise de sortimento e construção de bases de dados de produtos e preços do e-commerce brasileiro.

Por que este scraper

• Conjunto de campos mais completo. Mais de 50 campos por oferta, incluindo EAN, SKU, marca, caminho completo de categoria, todas as imagens, especificações, tabela de parcelamento, métodos de pagamento, promoções e tipo de vendedor.
• Descontos honestos. O desconto é calculado sobre um preço de referência confiável, para que um preço de tabela inflado nunca simule um grande desconto. hasDiscount, discountPercent e discountAmount refletem apenas um desconto real.
• Sinais de Pix e à vista. Ofertas à vista e no Pix aparecem em spotPrice e nos teasers de promoção, para você ver o preço real no checkout.
• Ciente do marketplace. Cada vendedor terceiro e cada oferta do próprio site (1P) vem com sellerName, sellerId e o indicador isMarketplace.
• Complementos de IA opcionais. Limpe e traduza descrições, ou extraia atributos estruturados e tags de palavra chave em inglês (apenas planos pagos, cobrado somente quando gerado).

Início rápido

Abra o actor, cole isto na entrada e clique em Executar. Retorna as 10 primeiras ofertas de cafeteira.

{
  "searchTerm": "cafeteira",
  "maxProducts": 10,
  "sortOrder": "OrderByBestDiscountDESC",
  "onlyAvailable": true
}

Informe um searchTerm, um categoryId ou um startUrl. Combine searchTerm com categoryId para buscar dentro de uma categoria, e adicione minPrice, maxPrice ou brands para refinar os resultados.

Como se compara

Recurso	Este actor (scrapers_lat)	gio21/americanas-product-scraper	latinamericadata/americanas-brasil
Entrada por termo de busca	Sim	Sim	Sim
Entrada por categoria	Sim (id ou caminho)	Não	Não
Entrada por URL do site ou catálogo	Sim	Sim (URL de busca)	Não
Filtro de faixa de preço	Sim	Não	Não
Filtro de marca	Sim	Não	Não
Filtro de estoque	Sim	Sim	Não
Ordenação	Sim (8 modos)	Não	Sim
ID do produto, SKU, EAN	Sim	Sim	Sim
Preço, preço de tabela, desconto	Sim	Sim	Sim
Preço de referência e desconto honesto	Sim	Não	Não
Tabela de parcelamento	Sim (completa)	Não	Não
Métodos de pagamento	Sim	Não	Não
Teasers de Pix e promoções	Sim	Só preço no Pix	Não
Todas as imagens, especificações	Sim	Parcial	Não
Indicador marketplace vs próprio site	Sim	Só nome do vendedor	Só nome do vendedor
Coleções, mais vendido, preço por unidade	Sim	Não	Não
Descrição, tradução e atributos por IA	Sim	Não	Não

Este actor aceita todas as entradas que os concorrentes listados aceitam e retorna todos os campos de produto que eles retornam, mais os campos extras acima. É um superconjunto estrito.

Referência de entrada

Campo	Tipo	Obrigatório	Padrão	Descrição
searchTerm	string	não	geladeira	Consulta de texto completo no catálogo da Americanas, por exemplo iphone, tênis nike.
categoryId	string	não	(nenhum)	Restringe a uma categoria da Americanas por id numérico VTEX (por exemplo 742) ou por caminho de categoria.
startUrl	string	não	(nenhum)	Avançado. Uma URL de busca ou de categoria da Americanas, ou uma URL de busca de catálogo. Seus parâmetros têm prioridade.
maxProducts	integer	não	50	Máximo de ofertas a coletar. Cada SKU e vendedor é um registro. Planos gratuitos têm limite de 10 por execução.
sortOrder	enum	não	(relevância)	Ordem dos resultados: OrderByPriceASC, OrderByPriceDESC, OrderByTopSaleDESC, OrderByReviewRateDESC, OrderByNameASC, OrderByNameDESC, OrderByReleaseDateDESC, OrderByBestDiscountDESC.
minPrice	integer	não	(nenhum)	Retorna apenas ofertas com preço igual ou acima deste valor em BRL.
maxPrice	integer	não	(nenhum)	Retorna apenas ofertas com preço igual ou abaixo deste valor em BRL.
brands	string[]	não	(nenhum)	Mantém apenas ofertas cuja marca corresponde a um destes nomes (sem diferenciar maiúsculas, correspondência parcial).
onlyAvailable	boolean	não	false	Quando ativo, retorna apenas ofertas em estoque.
withDetails	boolean	não	true	Complemento (planos pagos). Adiciona a descrição completa e a tabela de especificações. Cobrado apenas quando há conteúdo de detalhe.
withAiDescription	boolean	não	false	Complemento de IA (planos pagos). Descrição limpa em português mais tradução para o inglês. Cobrado apenas quando gerado.
withAiAttributes	boolean	não	false	Complemento de IA (planos pagos). Atributos estruturados e tags de palavra chave em inglês. Cobrado apenas quando gerado.
proxyConfiguration	object	não	(desligado)	Proxy Apify opcional. Um proxy residencial do Brasil pode ajudar em caso de limite de requisições.

Referência de saída

Um item do dataset por SKU e vendedor. Os valores são string, number, integer, boolean, string[], object[], object ou null quando o valor de origem está ausente.

Campo	Tipo	Descrição
name	string	Nome do produto.
nameComplete	string	Nome completo do SKU com detalhes de variante.
brand	string	Marca, ou null quando a fonte traz um valor genérico.
brandId	string	Id VTEX da marca.
productId	string	Id do produto na Americanas.
sku	string	Id do SKU (item).
ean	string	Código de barras EAN ou GTIN.
referenceId	string	Id de referência do vendedor ou do catálogo.
productReference	string	Valor de referência do produto.
productReferenceCode	string	Código de referência do produto.
url	string	URL da página do produto.
linkText	string	Slug da URL.
imageUrl	string	URL da imagem principal.
images	string[]	Todas as URLs de imagem.
categories	string[]	Caminho de categorias, do mais específico ao mais amplo.
categoryId	string	Id da categoria folha.
categoryIds	string[]	Caminho numérico de categorias, folha primeiro.
collections	string[]	Coleções e clusters de marketing.
bestSeller	boolean	true quando a loja marca o item como mais vendido.
price	number	Preço de venda atual.
listPrice	number	Preço de tabela informado pela fonte.
priceWithoutDiscount	number	Preço antes das promoções.
sellingPrice	number	Preço de venda cheio.
spotPrice	number	Preço à vista ou spot quando a fonte informa.
referencePrice	number	Preço anterior confiável usado no cálculo do desconto, ou null.
discountPercent	integer	Percentual de desconto sobre o preço de referência (0 quando não há desconto real).
discountAmount	number	Valor economizado em BRL sobre o preço de referência.
hasDiscount	boolean	true apenas quando existe um desconto real.
pricePerUnit	number	Preço por unidade de medida.
currency	string	Sempre BRL.
priceValidUntil	string	Data ISO até quando o preço é válido.
rewardValue	number	Valor de recompensa de fidelidade quando presente.
tax	number	Valor de imposto quando presente.
installments	object	Melhor plano sem juros {number, value, interestRate, interestFree, total}.
installmentsTable	object[]	Tabela completa de parcelamento por meio de pagamento.
paymentMethods	string[]	Métodos de pagamento aceitos, por exemplo Pix, Visa, Mastercard, Elo, boleto.
promoTeasers	string[]	Nomes de teasers de promoção e de desconto no Pix.
discountHighlights	string[]	Nomes de promoções em destaque de desconto.
availableQuantity	integer	Quantidade disponível na oferta.
isAvailable	boolean	true quando a oferta está em estoque.
sellerName	string	Nome do vendedor (marketplace ou próprio site).
sellerId	string	Id do vendedor.
isMarketplace	boolean	true para vendedores terceiros do marketplace.
measurementUnit	string	Unidade de venda, por exemplo un.
unitMultiplier	number	Multiplicador de unidade do preço.
isKit	boolean	true quando o SKU é um kit ou combo.
releaseDate	string	Data ISO de lançamento do produto.
estimatedArrivalDate	string	Data estimada de chegada quando presente.
videos	string[]	URLs de vídeo quando presentes.
description	string	Descrição completa do produto (complemento de detalhes).
specifications	object	Mapa de nome para valor das especificações (complemento de detalhes).
observedAt	string	Timestamp ISO 8601 da coleta.
error	string	null em caso de sucesso. Em uma execução com falha, um único item com error preenchido é gravado.
aiDescription	string	Descrição limpa em português do complemento de IA, ou null.
aiDescriptionEn	string	Tradução para o inglês do complemento de IA, ou null.
aiAttributes	object	Atributos e tags estruturados do complemento de IA, ou null.

Avaliações e número de comentários não são expostos pela busca de catálogo usada aqui, então esses campos não são retornados de propósito, em vez de serem inventados.

Registro de saída de exemplo

Registro real de uma execução ao vivo (entrada {"searchTerm": "cafeteira", "sortOrder": "OrderByBestDiscountDESC"}, listas reduzidas para leitura):

{
  "name": "Cafeteira Elétrica Oster 2Day 2 em 1 OCAF200",
  "url": "https://www.americanas.com.br/cafeteira-eletrica-oster-2day-2-em-1-ocaf200-8404994/p",
  "productId": "8404994",
  "sku": "8894906",
  "ean": "7898700210309",
  "brand": "Oster",
  "brandId": "774",
  "categories": ["Eletroportáteis > Cafeteira", "Eletroportáteis"],
  "price": 139.99,
  "listPrice": 299.9,
  "referencePrice": 299.9,
  "discountPercent": 53,
  "discountAmount": 159.91,
  "hasDiscount": true,
  "currency": "BRL",
  "installments": { "number": 2, "value": 69.99, "interestRate": 0, "interestFree": true, "total": 139.99 },
  "paymentMethods": ["Hipercard", "Elo", "Pix", "Visa", "Mastercard", "American Express"],
  "promoTeasers": ["BLACKFRIDAY | DESCONTO A VISTA | 5% OFF | PIX | MAGALU | TODOS OS DEPARTAMENTOS"],
  "availableQuantity": 1,
  "isAvailable": true,
  "sellerName": "Magazine Luiza",
  "sellerId": "magazineluiza",
  "isMarketplace": true,
  "specifications": { "marca": "Oster", "voltagem": "110 V", "cor": "Inox / Preto" },
  "observedAt": "2026-09-06T00:12:47.904Z",
  "error": null
}

Executar via API e CLI

Inicie uma execução e leia o dataset. Substitua <TOKEN> pelo seu token de API da Apify.

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~americanas-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerm":"cafeteira","maxProducts":25,"sortOrder":"OrderByPriceASC","onlyAvailable":true}'

Inicie de forma assíncrona:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~americanas-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"categoryId":"742","maxProducts":100,"sortOrder":"OrderByBestDiscountDESC"}'

Apify CLI:

$apify call scrapers_lat/americanas-scraper --input '{"searchTerm":"iphone","maxProducts":50}'

Obter os resultados

Toda execução grava em um dataset. Baixe os itens em JSON, CSV ou Excel mudando o format:

curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> é retornado como defaultDatasetId no objeto da execução. Use offset e limit para paginar grandes conjuntos de resultados.

Casos de uso

• Monitoramento de preços no varejo do Brasil. Acompanhe preços, ofertas no Pix e descontos na Americanas diariamente.
• Acompanhamento de preços de concorrentes. Compare seu catálogo com vendedores próprios e do marketplace da Americanas.
• Conformidade de preços e promoções. Detecte descontos, promoções e ofertas de parcelamento nos seus produtos.
• Pesquisa de mercado e sortimento. Mapeie marcas, categorias, mais vendidos e faixas de preço.
• Enriquecimento de catálogo. Faça a correspondência por EAN ou SKU para enriquecer seus dados com imagens e especificações.

Cobrança e limites

• Pagamento por resultado. Você é cobrado por oferta retornada (evento result). Veja a aba de preços para o valor atual.
• Sem cobrança em falha. Se uma execução falha, o actor grava um único item com o campo error preenchido e não cobra por ele. Execuções vazias não custam nada.
• Limite de gasto respeitado. Defina maxTotalChargeUsd na execução; ao ser atingido, o actor para de emitir e cobrar resultados.
• Planos gratuitos da Apify têm limite de 10 ofertas por execução. Faça upgrade para um maxProducts maior.
• Complementos (withDetails, withAiDescription, withAiAttributes) exigem plano pago e são cobrados por registro apenas quando produzem conteúdo.

Perguntas frequentes e solução de problemas

Uma execução retornou 0 ofertas. Por quê? A busca ou a categoria não encontrou nada, ou o catálogo ficou indisponível por um momento. Execuções sem resultado não são cobradas. Amplie a consulta ou remova onlyAvailable.

O que conta como um registro? Cada par de SKU e vendedor é um registro, então um produto vendido por vários vendedores do marketplace pode gerar vários registros.

Como encontro o id de uma categoria? Abra uma categoria em americanas.com.br e leia o id numérico, ou cole a URL da categoria em startUrl.

Por que os campos de IA estão null? Os complementos de IA vêm desligados por padrão e exigem um plano pago da Apify. Ative withAiDescription ou withAiAttributes em um plano pago.

Vocês retornam avaliações ou comentários? Não. A busca de catálogo usada aqui não expõe notas nem número de comentários, então esses campos não são retornados em vez de serem inventados.

Preciso de login? Não. O actor lê apenas dados de catálogo visíveis publicamente.

É uma ferramenta oficial da Americanas? Não. Este actor é independente e não tem afiliação com a Americanas ou Lojas Americanas. Ele lê apenas dados visíveis publicamente.

Ferramenta independente, sem afiliação com a Americanas ou Lojas Americanas. Acessa apenas dados disponíveis publicamente.