# Americanas Product Search Scraper (`stealth_mode/americanas-product-search-scraper`) Actor Scrape product listings from Americanas.com.br, one of Brazil's largest online retailers. Extract prices, images, brands, seller information, and product specifications from search results. Ideal for price monitoring, market research, and competitive analysis in the Brazilian e-commerce market. - **URL**: https://apify.com/stealth\_mode/americanas-product-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Americanas Product Search Scraper: Extract E-commerce Data from Brazil's Leading Marketplace ### Understanding Americanas.com.br and Its Market Value Americanas.com.br is a major Brazilian e-commerce platform offering millions of products across electronics, fashion, home goods, and more. For businesses operating in or entering the Brazilian market, Americanas data provides crucial insights into pricing strategies, product availability, and consumer trends. This scraper automates product data collection from search results, eliminating manual copying across hundreds of listings. Extract comprehensive product information for competitive analysis, price tracking, or market research. ### What This Scraper Extracts The scraper processes Americanas search result pages, capturing multiple product listings per URL. It collects: **Product Identifiers:** ID, SKU, GTIN, and slug enable unique product tracking and database integration. **Basic Information:** Product name (complete and display versions), brand, categories, and category IDs for classification. **Visual Assets:** Product images for displaying in price comparison tools or catalogs. **Pricing Data:** Offers object containing current prices, discounts, and seller information. **Seller Details:** Information about who's selling the product, crucial for marketplace analysis. **Specifications:** Product properties and variant information ("is variant of" field tracks product variations). **Delivery Information:** Delivery promise badges and delivery promises indicate shipping options and speed. **Marketing Elements:** Cluster highlights, tags, and advertisement flags show promotional strategies. **Inventory Data:** Unit multiplier and availability information. **Target Users:** Price monitoring services track competitor pricing across thousands of products. Market researchers analyze Brazilian consumer goods trends and pricing patterns. E-commerce businesses benchmark their offerings against marketplace competition. Retailers identify product gaps and pricing opportunities in specific categories. ### Input Configuration **Example Configuration:** ```json { "urls": ["https://www.americanas.com.br/s?q=shoe&fuzzy=auto&operator=and&facets=fuzzy%2Coperator&sort=score_desc&page=1"], "ignore_url_failures": true, "max_items_per_url": 50 } ```` **Parameter Details:** **urls:** Search result page URLs from Americanas. Build URLs by performing searches on Americanas.com.br and copying the resulting URLs. Include pagination parameters (`&page=1`, `&page=2`) for multi-page extraction. **ignore\_url\_failures:** Set `true` to continue processing if individual URLs fail. Essential when scraping multiple search queries where some may return errors. **max\_items\_per\_url:** Controls items extracted per URL (default: 20, max recommended: 50). Americanas typically displays 24-48 products per page. Higher values ensure complete page coverage. **URL Construction Tips:** Use Americanas search filters to narrow results by category, price range, or brand, then copy the filtered URL. For comprehensive category extraction, include multiple page URLs. ### Output Fields Explained **Sample Output:** ```json { "additional_property": [], "advertisement": null, "brand": { "brand_name": "Candide", "name": "Candide" }, "delivery_promise_badges": null, "gtin": "7897500556013", "has_specifications": false, "image": [ { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140031/image-fc465116ac514994928608d35c0c449f.jpg?v=639011393595000000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140033/image-2034c50004cb493c93ac2086ab235925.jpg?v=639011393595300000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140035/image-743f9d48c4c6489b99cda1ec5ad920b7.jpg?v=639011393595470000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140039/image-5cc0106de68b4f1487fc5ab142f231dc.jpg?v=639011393596870000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140030/image-721f37aacfdd4e96b12dcb8a55c708fe.jpg?v=639011393595000000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140032/image-aab8b7346b4d46dda6ea52d120519677.jpg?v=639011393595130000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140029/image-2d64c9cb11aa4c3cbc1527ef98c47db8.jpg?v=639011393595000000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140037/image-34e42d280476462da2460b510e520c78.jpg?v=639011393596230000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140025/image-d2eca69feb7a4431b1dcf47e35fb36e3.jpg?v=639011393594830000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140023/image-68c44e1c45fe4379a487014622c19af3.jpg?v=639011393593800000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140027/image-e33774adea024d1bae4330b1854999b6.jpg?v=639011393595000000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140026/image-6261f94a073f4bcfb7e390600e801d35.jpg?v=639011393595000000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140028/image-6cf3e8b497a64e08a29d872ab0169c61.jpg?v=639011393595000000" }, { "alternate_name": "", "url": "https://americanas.vtexassets.com/arquivos/ids/37140034/image-c6c1536d8d344af99a01ffa2afdb5aad.jpg?v=639011393595470000" } ], "is_variant_of": { "name": "Lançador de Dardos X-Shot Royale Kickback", "product_group_i_d": "8328554", "sku_variants": { "active_variations": {}, "all_variants_by_name": {}, "available_variations": {}, "slugs_map": {}, "all_variant_products": [ { "name": "Lançador de Dardos X-Shot Royale Kickback", "product_i_d": "8808481" } ] } }, "name": "Lançador de Dardos X-Shot Royale Kickback", "offers": { "low_price": 109.24, "low_price_with_taxes": 109.24, "offers": [ { "availability": "https://schema.org/InStock", "list_price": 169.9, "list_price_with_taxes": 169.9, "price": 109.24, "price_with_taxes": 109.24, "quantity": 10000, "seller": { "identifier": "magazineluiza" } }, { "availability": "https://schema.org/OutOfStock", "list_price": 0, "list_price_with_taxes": 0, "price": 0, "price_with_taxes": 0, "quantity": 0, "seller": { "identifier": "1" } } ] }, "id": "8808481", "sku": "8808481", "slug": "lancador-de-dardos-x-shot-royale-kickback-8328554-8808481", "unit_multiplier": 1, "categories": [ "/Brinquedos/" ], "category_id": "1402", "cluster_highlights": [ { "id": "4259", "name": "loja-magalu" }, { "id": "4354", "name": "magalu-prateleira" }, { "id": "4542", "name": "brinquedo-magalu" } ], "delivery_promises_badges": [], "link": "/lancador-de-dardos-x-shot-royale-kickback-8328554/p", "name_complete": "Lançador de Dardos X-Shot Royale Kickback", "properties": [ { "name": "Idade recomendada", "values": [ "A partir de 8 anos" ] }, { "name": "Modelo", "values": [ "Royale Kickback" ] }, { "name": "sellerId", "values": [ "1" ] } ], "sellers": [ { "commertial_offer": { "installments": [], "teasers": [] }, "seller_default": false, "seller_id": "1", "seller_name": "AMERICANAS SA" }, { "commertial_offer": { "installments": [ { "interest_rate": 0, "name": "American Express à vista", "number_of_installments": 1, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "American Express", "total_value_plus_interest_rate": 114.99, "value": 114.99 }, { "interest_rate": 0, "name": "American Express 2 vezes sem juros", "number_of_installments": 2, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "American Express", "total_value_plus_interest_rate": 114.99, "value": 57.49 }, { "interest_rate": 1.84, "name": "American Express 3 vezes com juros", "number_of_installments": 3, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "American Express", "total_value_plus_interest_rate": 119.22, "value": 39.74 }, { "interest_rate": 1.84, "name": "American Express 4 vezes com juros", "number_of_installments": 4, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "American Express", "total_value_plus_interest_rate": 120.32, "value": 30.08 }, { "interest_rate": 1.84, "name": "American Express 5 vezes com juros", "number_of_installments": 5, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "American Express", "total_value_plus_interest_rate": 121.4, "value": 24.28 }, { "interest_rate": 1.84, "name": "American Express 6 vezes com juros", "number_of_installments": 6, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "American Express", "total_value_plus_interest_rate": 122.46, "value": 20.41 }, { "interest_rate": 1.84, "name": "American Express 7 vezes com juros", "number_of_installments": 7, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "American Express", "total_value_plus_interest_rate": 123.55, "value": 17.65 }, { "interest_rate": 1.84, "name": "American Express 8 vezes com juros", "number_of_installments": 8, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "American Express", "total_value_plus_interest_rate": 124.64, "value": 15.58 }, { "interest_rate": 1.84, "name": "American Express 9 vezes com juros", "number_of_installments": 9, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "American Express", "total_value_plus_interest_rate": 125.82, "value": 13.98 }, { "interest_rate": 1.84, "name": "American Express 10 vezes com juros", "number_of_installments": 10, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "American Express", "total_value_plus_interest_rate": 126.9, "value": 12.69 }, { "interest_rate": 1.84, "name": "American Express 11 vezes com juros", "number_of_installments": 11, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "American Express", "total_value_plus_interest_rate": 128.04, "value": 11.64 }, { "interest_rate": 1.84, "name": "American Express 12 vezes com juros", "number_of_installments": 12, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "American Express", "total_value_plus_interest_rate": 129.12, "value": 10.76 }, { "interest_rate": 0, "name": "Visa à vista", "number_of_installments": 1, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Visa", "total_value_plus_interest_rate": 114.99, "value": 114.99 }, { "interest_rate": 0, "name": "Visa 2 vezes sem juros", "number_of_installments": 2, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Visa", "total_value_plus_interest_rate": 114.99, "value": 57.49 }, { "interest_rate": 1.84, "name": "Visa 3 vezes com juros", "number_of_installments": 3, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Visa", "total_value_plus_interest_rate": 119.22, "value": 39.74 }, { "interest_rate": 1.84, "name": "Visa 4 vezes com juros", "number_of_installments": 4, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Visa", "total_value_plus_interest_rate": 120.32, "value": 30.08 }, { "interest_rate": 1.84, "name": "Visa 5 vezes com juros", "number_of_installments": 5, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Visa", "total_value_plus_interest_rate": 121.4, "value": 24.28 }, { "interest_rate": 1.84, "name": "Visa 6 vezes com juros", "number_of_installments": 6, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Visa", "total_value_plus_interest_rate": 122.46, "value": 20.41 }, { "interest_rate": 1.84, "name": "Visa 7 vezes com juros", "number_of_installments": 7, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Visa", "total_value_plus_interest_rate": 123.55, "value": 17.65 }, { "interest_rate": 1.84, "name": "Visa 8 vezes com juros", "number_of_installments": 8, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Visa", "total_value_plus_interest_rate": 124.64, "value": 15.58 }, { "interest_rate": 1.84, "name": "Visa 9 vezes com juros", "number_of_installments": 9, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Visa", "total_value_plus_interest_rate": 125.82, "value": 13.98 }, { "interest_rate": 1.84, "name": "Visa 10 vezes com juros", "number_of_installments": 10, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Visa", "total_value_plus_interest_rate": 126.9, "value": 12.69 }, { "interest_rate": 1.84, "name": "Visa 11 vezes com juros", "number_of_installments": 11, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Visa", "total_value_plus_interest_rate": 128.04, "value": 11.64 }, { "interest_rate": 1.84, "name": "Visa 12 vezes com juros", "number_of_installments": 12, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Visa", "total_value_plus_interest_rate": 129.12, "value": 10.76 }, { "interest_rate": 0, "name": "Mastercard à vista", "number_of_installments": 1, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Mastercard", "total_value_plus_interest_rate": 114.99, "value": 114.99 }, { "interest_rate": 0, "name": "Mastercard 2 vezes sem juros", "number_of_installments": 2, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Mastercard", "total_value_plus_interest_rate": 114.99, "value": 57.49 }, { "interest_rate": 1.84, "name": "Mastercard 3 vezes com juros", "number_of_installments": 3, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Mastercard", "total_value_plus_interest_rate": 119.22, "value": 39.74 }, { "interest_rate": 1.84, "name": "Mastercard 4 vezes com juros", "number_of_installments": 4, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Mastercard", "total_value_plus_interest_rate": 120.32, "value": 30.08 }, { "interest_rate": 1.84, "name": "Mastercard 5 vezes com juros", "number_of_installments": 5, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Mastercard", "total_value_plus_interest_rate": 121.4, "value": 24.28 }, { "interest_rate": 1.84, "name": "Mastercard 6 vezes com juros", "number_of_installments": 6, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Mastercard", "total_value_plus_interest_rate": 122.46, "value": 20.41 }, { "interest_rate": 1.84, "name": "Mastercard 7 vezes com juros", "number_of_installments": 7, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Mastercard", "total_value_plus_interest_rate": 123.55, "value": 17.65 }, { "interest_rate": 1.84, "name": "Mastercard 8 vezes com juros", "number_of_installments": 8, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Mastercard", "total_value_plus_interest_rate": 124.64, "value": 15.58 }, { "interest_rate": 1.84, "name": "Mastercard 9 vezes com juros", "number_of_installments": 9, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Mastercard", "total_value_plus_interest_rate": 125.82, "value": 13.98 }, { "interest_rate": 1.84, "name": "Mastercard 10 vezes com juros", "number_of_installments": 10, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Mastercard", "total_value_plus_interest_rate": 126.9, "value": 12.69 }, { "interest_rate": 1.84, "name": "Mastercard 11 vezes com juros", "number_of_installments": 11, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Mastercard", "total_value_plus_interest_rate": 128.04, "value": 11.64 }, { "interest_rate": 1.84, "name": "Mastercard 12 vezes com juros", "number_of_installments": 12, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Mastercard", "total_value_plus_interest_rate": 129.12, "value": 10.76 }, { "interest_rate": 0, "name": "Hipercard à vista", "number_of_installments": 1, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Hipercard", "total_value_plus_interest_rate": 114.99, "value": 114.99 }, { "interest_rate": 0, "name": "Hipercard 2 vezes sem juros", "number_of_installments": 2, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Hipercard", "total_value_plus_interest_rate": 114.99, "value": 57.49 }, { "interest_rate": 1.84, "name": "Hipercard 3 vezes com juros", "number_of_installments": 3, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Hipercard", "total_value_plus_interest_rate": 119.22, "value": 39.74 }, { "interest_rate": 1.84, "name": "Hipercard 4 vezes com juros", "number_of_installments": 4, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Hipercard", "total_value_plus_interest_rate": 120.32, "value": 30.08 }, { "interest_rate": 1.84, "name": "Hipercard 5 vezes com juros", "number_of_installments": 5, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Hipercard", "total_value_plus_interest_rate": 121.4, "value": 24.28 }, { "interest_rate": 1.84, "name": "Hipercard 6 vezes com juros", "number_of_installments": 6, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Hipercard", "total_value_plus_interest_rate": 122.46, "value": 20.41 }, { "interest_rate": 1.84, "name": "Hipercard 7 vezes com juros", "number_of_installments": 7, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Hipercard", "total_value_plus_interest_rate": 123.55, "value": 17.65 }, { "interest_rate": 1.84, "name": "Hipercard 8 vezes com juros", "number_of_installments": 8, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Hipercard", "total_value_plus_interest_rate": 124.64, "value": 15.58 }, { "interest_rate": 1.84, "name": "Hipercard 9 vezes com juros", "number_of_installments": 9, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Hipercard", "total_value_plus_interest_rate": 125.82, "value": 13.98 }, { "interest_rate": 1.84, "name": "Hipercard 10 vezes com juros", "number_of_installments": 10, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Hipercard", "total_value_plus_interest_rate": 126.9, "value": 12.69 }, { "interest_rate": 1.84, "name": "Hipercard 11 vezes com juros", "number_of_installments": 11, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Hipercard", "total_value_plus_interest_rate": 128.04, "value": 11.64 }, { "interest_rate": 1.84, "name": "Hipercard 12 vezes com juros", "number_of_installments": 12, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Hipercard", "total_value_plus_interest_rate": 129.12, "value": 10.76 }, { "interest_rate": 0, "name": "Elo à vista", "number_of_installments": 1, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Elo", "total_value_plus_interest_rate": 114.99, "value": 114.99 }, { "interest_rate": 0, "name": "Elo 2 vezes sem juros", "number_of_installments": 2, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Elo", "total_value_plus_interest_rate": 114.99, "value": 57.49 }, { "interest_rate": 1.84, "name": "Elo 3 vezes com juros", "number_of_installments": 3, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Elo", "total_value_plus_interest_rate": 119.22, "value": 39.74 }, { "interest_rate": 1.84, "name": "Elo 4 vezes com juros", "number_of_installments": 4, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Elo", "total_value_plus_interest_rate": 120.32, "value": 30.08 }, { "interest_rate": 1.84, "name": "Elo 5 vezes com juros", "number_of_installments": 5, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Elo", "total_value_plus_interest_rate": 121.4, "value": 24.28 }, { "interest_rate": 1.84, "name": "Elo 6 vezes com juros", "number_of_installments": 6, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Elo", "total_value_plus_interest_rate": 122.46, "value": 20.41 }, { "interest_rate": 1.84, "name": "Elo 7 vezes com juros", "number_of_installments": 7, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Elo", "total_value_plus_interest_rate": 123.55, "value": 17.65 }, { "interest_rate": 1.84, "name": "Elo 8 vezes com juros", "number_of_installments": 8, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Elo", "total_value_plus_interest_rate": 124.64, "value": 15.58 }, { "interest_rate": 1.84, "name": "Elo 9 vezes com juros", "number_of_installments": 9, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Elo", "total_value_plus_interest_rate": 125.82, "value": 13.98 }, { "interest_rate": 1.84, "name": "Elo 10 vezes com juros", "number_of_installments": 10, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Elo", "total_value_plus_interest_rate": 126.9, "value": 12.69 }, { "interest_rate": 1.84, "name": "Elo 11 vezes com juros", "number_of_installments": 11, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Elo", "total_value_plus_interest_rate": 128.04, "value": 11.64 }, { "interest_rate": 1.84, "name": "Elo 12 vezes com juros", "number_of_installments": 12, "payment_system_group_name": "creditCardPaymentGroup", "payment_system_name": "Elo", "total_value_plus_interest_rate": 129.12, "value": 10.76 }, { "interest_rate": 0, "name": "Vale à vista", "number_of_installments": 1, "payment_system_group_name": "giftCardPaymentGroup", "payment_system_name": "Vale", "total_value_plus_interest_rate": 114.99, "value": 114.99 }, { "interest_rate": 0, "name": "Pix à vista", "number_of_installments": 1, "payment_system_group_name": "instantPaymentPaymentGroup", "payment_system_name": "Pix", "total_value_plus_interest_rate": 109.24, "value": 109.24 }, { "interest_rate": 0, "name": "Cartão Cliente A à vista", "number_of_installments": 1, "payment_system_group_name": "customPrivate_501PaymentGroup", "payment_system_name": "Cartão Cliente A", "total_value_plus_interest_rate": 114.99, "value": 114.99 }, { "interest_rate": 0, "name": "Cartão Cliente A 2 vezes sem juros", "number_of_installments": 2, "payment_system_group_name": "customPrivate_501PaymentGroup", "payment_system_name": "Cartão Cliente A", "total_value_plus_interest_rate": 114.99, "value": 57.49 }, { "interest_rate": 0, "name": "WH Google Pay à vista", "number_of_installments": 1, "payment_system_group_name": "WH Google PayPaymentGroup", "payment_system_name": "WH Google Pay", "total_value_plus_interest_rate": 114.99, "value": 114.99 } ], "teasers": [ { "conditions": { "minimum_quantity": 0, "parameters": [ { "name": "PaymentMethodId", "value": "125" } ] }, "effects": { "parameters": [ { "name": "PercentualDiscount", "value": "5" } ] }, "name": "BLACKFRIDAY | Desconto a vista | 5% OFF | PIX | Magalu | Todos os Departamentos" } ] }, "seller_default": true, "seller_id": "magazineluiza", "seller_name": "Magazine Luiza" } ], "tags": [] } ``` **Additional Property:** Custom product attributes specific to certain categories. **Advertisement:** Boolean indicating if listing is a promoted/paid placement. **Use:** Identify sponsored products, analyze advertising investment patterns. **Brand:** Manufacturer or brand name. **Use:** Brand-level analysis, filtering by preferred manufacturers. **Delivery Promise Badges:** Visual indicators of delivery speed (same-day, next-day). **Use:** Competitive shipping analysis, logistics benchmarking. **GTIN:** Global Trade Item Number (barcode). **Use:** Universal product identification, cross-platform matching. **Has Specifications:** Boolean indicating detailed specs availability. **Use:** Data completeness assessment. **Image:** Product image URL. **Use:** Visual display in comparison tools, catalog building. **Is Variant Of:** Parent product ID for variations (sizes, colors). **Use:** Grouping product variants, understanding product families. **Name / Name Complete:** Product title (short and full versions). **Use:** Search indexing, product identification, SEO. **Offers:** Price, seller, and availability object. **Use:** Core pricing data for monitoring and comparison. **ID / SKU / Slug:** Multiple unique identifiers. **Use:** Database keys, URL construction, tracking across scrapes. **Unit Multiplier:** Package quantity (e.g., sold in packs). **Use:** Unit price calculations, bulk vs. single item identification. **Categories / Category ID:** Product classification hierarchy. **Use:** Filtering, category-level trend analysis. **Cluster Highlights:** Featured product attributes. **Use:** Understanding marketing positioning. **Link:** Direct product URL. **Use:** Reference linking, verification. **Properties:** Detailed specifications array. **Use:** Feature comparison, specification-based filtering. **Sellers:** Marketplace seller information. **Use:** Multi-seller analysis, identifying dominant vendors. **Tags:** Product categorization labels. **Use:** Enhanced filtering, trend identification. ### Implementation Guide **1. Build Search URLs:** Perform searches on Americanas.com.br with desired filters (category, brand, price range). Copy URLs for each search query. **2. Handle Pagination:** For large categories, include multiple page URLs (`page=1`, `page=2`, etc.) or set `max_items_per_url` higher than page display count. **3. Configure Input:** Add URLs to input JSON. Set `max_items_per_url` to 50 for complete page coverage. Enable `ignore_url_failures` for robustness. **4. Run Scraper:** Launch via Apify console. Processing 10 search pages typically completes in 3-5 minutes. **5. Export Data:** Download as JSON (for databases), CSV (for Excel analysis), or Excel format. **Error Handling:** Invalid search URLs or changed site structure cause failures. Verify URLs load correctly in browser before scraping. Check activity logs for specific error details. ### Strategic Applications **Dynamic Price Monitoring:** Track competitor pricing daily across product portfolios. Identify price changes, discount patterns, and promotional periods. **Market Entry Research:** Analyze product assortment, pricing tiers, and seller landscape before entering Brazilian market. Identify gaps and opportunities. **Brand Presence Analysis:** Monitor how specific brands are represented—number of SKUs, price positioning, seller distribution. **Seasonal Trend Tracking:** Scrape regularly to identify seasonal demand patterns and pricing fluctuations. **Seller Intelligence:** In marketplace model, track which sellers dominate categories, their pricing strategies, and delivery promises. **Specification Benchmarking:** Compare product features and specifications across competitors to inform product development. ### Best Practices **Schedule Regular Scraping:** Weekly scraping captures price changes and inventory fluctuations. Daily scraping during high-competition periods (Black Friday, holiday seasons). **Segment by Category:** Create separate URLs for different product categories rather than broad searches for cleaner datasets. **Validate Data:** Check for missing prices or images. Filter out promotional/advertisement listings if seeking organic results. **Combine with Historical Data:** Store timestamps with each scrape to build price history databases and trend analysis. **Respect Rate Limits:** Space out large scraping runs. Avoid overwhelming the platform with excessive concurrent requests. **Currency Handling:** Prices are in Brazilian Real (BRL). Apply current exchange rates for international comparisons. ### Conclusion The Americanas Product Search Scraper provides essential e-commerce intelligence from Brazil's major marketplace. Whether monitoring prices, researching market entry, or analyzing competitive positioning, this tool delivers the data needed for informed decisions in South America's largest economy. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://www.americanas.com.br/s?q=shoe&fuzzy=auto&operator=and&facets=fuzzy%2Coperator&sort=score_desc&page=1" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://www.americanas.com.br/s?q=shoe&fuzzy=auto&operator=and&facets=fuzzy%2Coperator&sort=score_desc&page=1" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/americanas-product-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": ["https://www.americanas.com.br/s?q=shoe&fuzzy=auto&operator=and&facets=fuzzy%2Coperator&sort=score_desc&page=1"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/americanas-product-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "https://www.americanas.com.br/s?q=shoe&fuzzy=auto&operator=and&facets=fuzzy%2Coperator&sort=score_desc&page=1" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/americanas-product-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/americanas-product-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Americanas Product Search Scraper", "description": "Scrape product listings from Americanas.com.br, one of Brazil's largest online retailers. Extract prices, images, brands, seller information, and product specifications from search results. Ideal for price monitoring, market research, and competitive analysis in the Brazilian e-commerce market.", "version": "0.0", "x-build-id": "bca3SGgEXot0EOILe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~americanas-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-americanas-product-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/stealth_mode~americanas-product-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-americanas-product-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/stealth_mode~americanas-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-americanas-product-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs of the product search list urls to scrape", "type": "array", "description": "Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```