Americanas Brazil Product Price & Seller Scraper

Here is one real result, with every field the actor returns (the installmentsTable and specifications arrays are trimmed here for readability):

{
  "imageUrl": "https://americanas.vteximg.com.br/arquivos/ids/5377037/4884324270_1_xlarge.jpg?v=638751407018970000",
  "images": [
    "https://americanas.vteximg.com.br/arquivos/ids/5377037/4884324270_1_xlarge.jpg?v=638751407018970000",
    "https://americanas.vteximg.com.br/arquivos/ids/5376963/4884324270_4_xlarge.jpg?v=638751407013930000"
  ],
  "description": "Aproveite todo o sabor do café com a Cafeteira Elétrica Electrolux Expert CMP70...",
  "specifications": [
    { "name": "Condição do Item", "values": ["Novo"] },
    { "name": "Fabricante", "values": ["Electrolux"] },
    { "name": "Garantia (meses)", "values": ["12"] },
    { "name": "Programável", "values": ["Sim"] }
  ],
  "releaseDate": "2025-02-14T02:32:00Z",
  "productReference": "4884324253",
  "installmentsTable": [
    { "number": 1, "value": 569.9, "interestRate": 0, "total": 569.9, "paymentName": "Visa à vista" },
    { "number": 11, "value": 51.8, "interestRate": 0, "total": 569.9, "paymentName": "Cartão Cliente A 11 vezes sem juros" }
  ],
  "priceValidUntil": "2027-08-14T06:23:28Z",
  "promoTeasers": null,
  "measurementUnit": "un",
  "unitMultiplier": 1,
  "name": "Cafeteira Elétrica Electrolux Expert (CMP70)",
  "brand": "Electrolux",
  "price": 569.9,
  "listPrice": 899.9,
  "priceWithoutDiscount": 569.9,
  "sellingPrice": 569.9,
  "discountPercent": 37,
  "installments": { "number": 11, "value": 51.8, "interestRate": 0, "interestFree": true, "total": 569.9 },
  "availableQuantity": 1,
  "isAvailable": true,
  "sku": "2389848",
  "ean": "7896347160414",
  "referenceId": "4884324270",
  "sellerName": "Electrolux",
  "sellerId": "TALD92147994180539",
  "isMarketplace": true,
  "categories": [
    "Eletroportáteis > Cafeteira > Cafeteira elétrica",
    "Eletroportáteis > Cafeteira",
    "Eletroportáteis"
  ],
  "productId": "2243618",
  "url": "https://www.americanas.com.br/cafeteira-eletrica-electrolux-expert-cmp70-4884324253/p",
  "observedAt": "2026-08-14T06:26:13.417Z",
  "error": null,
  "aiDescription": null,
  "aiDescriptionEn": null,
  "aiAttributes": null
}

The most complete Americanas Brazil product scraper available. It returns every field the Americanas VTEX catalog exposes per offer (name, brand, prices, discount, the full installment plan table, EAN, SKU, seller, stock, images, specifications, and the category path), plus optional AI add-ons for a clean and translated description and structured attributes, and gives you five filters to target exactly the offers you need.

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

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor queries the Americanas Brazil VTEX catalog by search term, category id, or a raw catalog URL, applies your sort and availability filters, paginates through the matching products, and writes one normalized record per available SKU and seller to the run's dataset. Prices, list prices, and discount percentages are returned as numbers, the complete installment plan table is captured per payment method, and missing source values are returned as null. Two optional AI add-ons (paid plans only) can add a clean Portuguese description with an English translation and structured product attributes with English keyword tags.

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": "",
  "onlyAvailable": false
}

Provide a searchTerm, a categoryId, or a startUrl. Combine searchTerm with categoryId to search within one category.

Input reference

Field	Type	Required	Default	Description
searchTerm	string	no	geladeira	Full-text query against the Americanas catalog, for example iphone, tênis nike. Maps to the VTEX ft parameter.
categoryId	string	no	(none)	Restrict to one Americanas category by its numeric VTEX id, for example 742 for Audio & Video. Maps to fq=C:.
startUrl	string	no	(none)	Advanced. A full VTEX catalog search URL whose query string (ft, fq, O) is used as-is. Its parameters take precedence.
maxProducts	integer	no	10	Maximum offers to collect. Each available SKU and seller is one record. Free Apify plans are capped at 10 per run.
sortOrder	enum	no	(relevance)	Result order. One of OrderByPriceASC, OrderByPriceDESC, OrderByTopSaleDESC, OrderByReviewRateDESC, OrderByNameASC, OrderByNameDESC, OrderByReleaseDateDESC, OrderByBestDiscountDESC. Maps to the VTEX O parameter.
onlyAvailable	boolean	no	false	When on, only offers currently in stock are returned.
withAiDescription	boolean	no	false	AI add-on (paid plans only). Clean Portuguese description plus an English translation per product. Billed only when produced.
withAiAttributes	boolean	no	false	AI add-on (paid plans only). Structured product attributes and English keyword tags. Billed only when produced.
proxyConfiguration	object	no	(Apify proxy)	Standard Apify proxy configuration. Residential Brazil proxy is recommended for reliable catalog access.

Output reference

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

Field	Type	Description
name	string	Product name.
brand	string	Brand name.
productId	string	Americanas VTEX product ID.
url	string	Canonical product page URL.
imageUrl	string	Primary product image URL.
images	string[]	All product image URLs.
description	string	Full product description (HTML from the source).
specifications	object[]	Product specifications as {name, values[]} pairs.
price	number	Current price.
listPrice	number	List (reference) price.
priceWithoutDiscount	number	Price before discount.
sellingPrice	number	Current selling price.
discountPercent	integer	Discount percentage off the list price.
installments	object	Best interest-free installment plan {number, value, interestRate, interestFree, total}.
installmentsTable	object[]	Full installment table per payment method {number, value, interestRate, total, paymentName}.
priceValidUntil	string	ISO date the price is valid until.
promoTeasers	object[]	Promotional teasers when present, else null.
measurementUnit	string	Selling unit, for example un.
unitMultiplier	number	Unit multiplier for the price.
availableQuantity	integer	Quantity available for the offer.
isAvailable	boolean	true when the offer is in stock.
sku	string	SKU identifier.
ean	string	EAN barcode.
referenceId	string	Manufacturer or catalog reference ID.
productReference	string	Product reference code.
releaseDate	string	ISO product release date.
sellerName	string	Seller (marketplace or first-party) name.
sellerId	string	Seller ID.
isMarketplace	boolean	true when the offer is from a marketplace seller.
categories	string[]	Category paths from most specific to broadest.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed run, a single item with a populated error field 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.

Example output record

Real record from a live run (input {"searchTerm": "cafeteira", "maxProducts": 2}):

{
  "name": "Cafeteira Elétrica Electrolux Expert (CMP70)",
  "brand": "Electrolux",
  "productId": "2243618",
  "url": "https://www.americanas.com.br/cafeteira-eletrica-electrolux-expert-cmp70-4884324253/p",
  "imageUrl": "https://americanas.vteximg.com.br/arquivos/ids/5377037/4884324270_1_xlarge.jpg?v=638751407018970000",
  "price": 569.9,
  "listPrice": 899.9,
  "discountPercent": 37,
  "installments": { "number": 11, "value": 51.8, "interestRate": 0, "interestFree": true, "total": 569.9 },
  "priceValidUntil": "2027-08-14T06:23:28Z",
  "availableQuantity": 1,
  "isAvailable": true,
  "sku": "2389848",
  "ean": "7896347160414",
  "referenceId": "4884324270",
  "sellerName": "Electrolux",
  "sellerId": "TALD92147994180539",
  "isMarketplace": true,
  "categories": [
    "Eletroportáteis > Cafeteira > Cafeteira elétrica",
    "Eletroportáteis > Cafeteira",
    "Eletroportáteis"
  ],
  "observedAt": "2026-08-14T06:26:13.417Z",
  "error": null
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

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:

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

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

# Paginate large datasets
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. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per offer returned (result event). See the pricing tab for the current per-result 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 higher maxProducts.
• AI add-ons (withAiDescription, withAiAttributes) require a paid plan and are charged only when the model returns usable output.

FAQ and troubleshooting

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

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

How do I find a category id? Open a category on americanas.com.br and read the numeric VTEX category id, or pass a full category URL via 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 to populate aiDescription, aiDescriptionEn, and aiAttributes.

Do I need a login? No. The actor reads only publicly visible catalog data. A residential Brazil proxy is recommended for reliable access.

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.