# Magazineluiza Product Search Scraper (`stealth_mode/magazineluiza-product-search-scraper`) Actor Extract product listings from MagazineLuiza.com.br search pages. Gather prices, ratings, seller information, shipping costs, and product details from Brazil's top e-commerce platform. Ideal for price monitoring, market research, and competitive intelligence. - **URL**: https://apify.com/stealth\_mode/magazineluiza-product-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 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 ## MagazineLuiza Product Search Scraper: Extract E-commerce Data from Brazil's Leading Retailer ### Understanding MagazineLuiza and Its Market Value MagazineLuiza (often called "Magalu") is Brazil's largest retail chain and a leading e-commerce marketplace. The platform hosts thousands of sellers offering electronics, appliances, furniture, and more. For businesses operating in Brazilian e-commerce, MagazineLuiza data provides critical market intelligence. This scraper processes search result pages, not individual product pages. It captures multiple products per page, making it efficient for broad market analysis, competitor monitoring, and price tracking across categories. ### What This Scraper Extracts **Product Identification:** ID, variation ID, title, description, reference, and parent matching UUID enable product tracking and catalog management. **Pricing Data:** Price and installment information reveal payment options. Brazil's market heavily uses installment payments, making this data crucial for competitive pricing. **Seller Information:** Seller name, ads seller ID, and "is buy box" flag identify who's selling and who won the featured placement—critical for marketplace competition analysis. **Availability & Inventory:** Available status, minimum order quantity, and has variations flags show stock levels and product options. **Product Details:** Attributes, brand, dimensions, category, subcategory, and type provide classification data for analysis and filtering. **Customer Engagement:** Rating and badges show product performance and special designations (best seller, top rated, etc.). **Visual Assets:** Image URLs and thumbnails enable product display in applications or databases. **Logistics:** Shipping cost and shipping tag reveal delivery options and costs—key factors in Brazilian e-commerce purchasing decisions. **Positioning:** Position field shows search ranking, and offer tags highlight promotions or special deals. **Marketing Elements:** Ads data, loyalty programs, restrictions, and bundles show promotional strategies and selling tactics. **Target Users:** E-commerce businesses monitor competitor pricing and product offerings. Market researchers analyze category trends and seller performance. Price comparison platforms aggregate data for consumers. Retailers benchmark their products against marketplace competition. ### Input Configuration **Example Configuration:** ```json { "urls": ["https://www.magazineluiza.com.br/busca/laptop/?page=3"], "ignore_url_failures": true, "max_items_per_url": 50 } ```` **urls:** Search result page URLs from MagazineLuiza. Navigate to your target category, apply filters, then copy the URL. Include page parameters for pagination (e.g., `?page=3`). Add multiple URLs to scrape different categories or searches in one run. **ignore\_url\_failures:** Set `true` when scraping multiple URLs. Individual failures won't stop the entire run—essential for large datasets where some pages may be temporarily unavailable. **max\_items\_per\_url:** Maximum products to extract per URL. MagazineLuiza typically shows 20-40 products per page. Set higher (50-100) to ensure complete page capture or limit for testing. Default is 20. **Building URL Lists:** Perform manual searches with desired filters (brand, price range, ratings). Copy resulting URLs. For comprehensive category extraction, systematically increment page numbers: `?page=1`, `?page=2`, etc. ### Complete Output Structure **Sample Output:** ```json { "id": "240066500", "ads_seller_id": "magazineluiza", "variation_id": "240066500", "title": "Notebook ASUS Vivobook Go 15 AMD Ryzen 5 7520U 8GB RAM 512GB SSD 15,6\" Full HD Windows 11 E1504FA-NJ836W", "description": null, "image": "https://a-static.mlcdn.com.br/{w}x{h}/notebook-asus-vivobook-go-15-amd-ryzen-5-7520u-8gb-ram-512gb-ssd-156-full-hd-windows-11-e1504fa-nj836w/magazineluiza/240066500/082a94cd064ff8605beef9057890a3f1.jpg", "available": true, "position": 1, "is_buy_box": false, "url": null, "path": "/notebook-asus-vivobook-go-15-amd-ryzen-5-7520u-8gb-ram-512gb-ssd-156-full-hd-windows-11-e1504fa-nj836w/p/240066500/in/nass/", "reference": null, "offer_tags": [ "magalu_indica" ], "minimum_order_quantity": 1, "attributes": [ { "type": "color", "label": "Cor", "value": "Mixed Black", "current": "Mixed Black", "values": null } ], "seller": { "id": "magazineluiza", "sku": "240066500", "description": "Magalu", "category": "1p", "delivery_id": null, "delivery_description": null, "is_chat_enabled": null, "details": null, "tags": [ { "code": "TECNO200", "discount_type": "absolute", "discount_value": 200, "end_date": "2026-05-31T23:59:00-03:00", "message": "R$ 200,00 OFF com cupom: TECNO200", "start_date": "2026-04-16T00:00:00-03:00", "type": "coupon", "version": "v1", "action": null }, { "code": null, "discount_type": "percentage", "discount_value": 26.31, "end_date": null, "message": null, "start_date": null, "type": "base_price", "version": null, "action": null } ] }, "brand": { "label": "ASUS", "slug": "asus" }, "parent_matching_uuid": "45a78be6-0f8d-4c2a-a013-5b25e573f3d2", "price": { "payment_method_description": "no Pix", "price": "4579.00", "full_price": "3749.00", "best_price": "3374.10", "discount": "10.00", "currency": "BRL", "exchange_rate": null, "id_exchange_rate": null, "original_price_foreign": null }, "installment": { "payment_method_description": "sem juros", "quantity": 10, "amount": "374.90", "total_amount": "3749.00", "payment_method_id": "mastercard", "interest": "0.00" }, "rating": { "count": 577, "score": 4.8 }, "badges": [], "category": { "id": "IN", "name": "Informática" }, "subcategory": { "id": "NASS", "name": "Notebook Asus" }, "loyalty": { "value": null, "type": null, "attributes": null, "label": null, "description": null }, "restrictions": {}, "ads": { "sponsored": true, "id": "240066500", "label": "Patrocinado", "ad_request_id": null, "ad_response_id": null, "ads_match_reason": null, "ads_requested_count": null, "ads_returned_count": null, "brand": "ASUS", "campaign_id": "01989a36-f9b9-7fc0-806b-cce8df65c702", "category": "Informática", "gender": null, "offer_id": "240066500", "navigation_id": "240066500", "sku": "240066500", "sub_category": "Notebook Asus", "track_id": "p7AokwoQBp-xYzEnfR-oBNYUWarZCBIQAZiaNvm5f8CAa8zo32XHAhoQAZJBDo8afQGFHNM5wY9x-iINCgkyNDAwNjY1MDAQATDapVBIAVCF77rm3zNgxAJyEAAAAAAAAAAAAAAAAAAAAAA" }, "thumbnails": [], "shipping_cost": { "cost": null, "cost_description": null }, "shipping_tag": { "error": "", "time": "", "cost": null, "uuid": null, "complement": "", "source": "ironhide" }, "type": "product", "dimensions": { "height": 0.065, "length": 0.288, "weight": 1.63, "width": 0.481 }, "bundles": null, "has_variations": false } ``` **Field Definitions:** **ID/Variation ID:** Unique product identifiers for tracking across systems and detecting variants. **Title/Description:** Product name and summary for display and search functionality. **Price/Installment:** Critical for price monitoring. Installment data shows Brazilian payment culture (e.g., "10x R$299.90"). **Seller/Is Buy Box:** Identifies winning seller for featured "Buy Box" placement—marketplace competition metric. **Rating:** Average score and review count indicate product popularity and quality. **Shipping Cost/Tag:** Delivery pricing and promotions ("Frete Grátis" = Free Shipping)—major purchase decision factors. **Category/Subcategory:** Product classification for organizing and filtering datasets. **Badges/Offer Tags:** Promotional highlights ("Mais Vendido" = Best Seller, "Oferta do Dia" = Deal of the Day). **Loyalty:** Points and cashback rewards in MagazineLuiza's loyalty program. **Position:** Search ranking—tracks visibility and SEO performance. **Attributes:** Specifications (processor, RAM, storage) for technical comparison. **Dimensions:** Physical measurements for logistics and product information. ### Implementation Guide **1. Define Targets:** Identify categories, brands, or searches to monitor. Test searches on MagazineLuiza manually to verify filters work correctly. **2. Build URL List:** Copy search URLs with desired filters. For multi-page extraction, create URLs with page parameters or set high `max_items_per_url`. **3. Configure Input:** Add URLs to configuration. Enable `ignore_url_failures` for robustness. Adjust `max_items_per_url` based on needs (20 for standard, 50+ for comprehensive). **4. Run Scraper:** Launch and monitor progress. Processing 5 search pages typically completes in 2-4 minutes depending on page size and proxy performance. **5. Export Data:** Download as JSON for databases, CSV for spreadsheets. Filter by availability, price ranges, or ratings based on analysis needs. **Error Handling:** Invalid URLs or temporarily unavailable pages cause failures. Activity log shows specific errors. Verify URLs are search pages, not product detail pages. ### Strategic Applications **Price Monitoring:** Track competitor pricing across categories. Identify price changes, promotion patterns, and discount cycles. Monitor installment offerings to match competitive payment terms. **Market Analysis:** Analyze which products dominate search results by category. Track best seller badges and high ratings to identify market leaders. Monitor new product launches through recent additions. **Seller Intelligence:** Identify which sellers win buy box placements most frequently. Analyze seller performance by category. Track marketplace competition dynamics. **Inventory Tracking:** Monitor product availability across competitors. Identify out-of-stock patterns indicating high demand or supply issues. **Shipping Strategy:** Compare shipping costs across sellers and categories. Track free shipping promotions to inform competitive logistics strategies. **Product Research:** Use attributes data to understand market specifications. Analyze feature combinations in top-rated products. Identify gaps in product offerings. ### Best Practices **Schedule Regular Scraping:** Brazilian e-commerce changes rapidly. Daily scraping captures price fluctuations and promotion cycles, especially important around major sales events (Black Friday, Dia do Consumidor). **Segment by Category:** Create separate URLs for different product categories for cleaner datasets and easier analysis. **Monitor Pagination:** MagazineLuiza may limit visible pages. If searching for comprehensive data, use multiple search variations with different filters rather than only pagination. **Handle Currency:** All prices in Brazilian Reais (BRL). Track exchange rates if comparing international markets. **Validate Data Quality:** Check for missing critical fields (price, title, availability). Flag anomalies like unusual prices or shipping costs. **Respect Platform:** Space out large scraping runs to avoid overwhelming servers. Sustainable practices ensure continued access. ### Conclusion The MagazineLuiza Product Search Scraper delivers actionable e-commerce intelligence from Brazil's largest retail marketplace. From real-time pricing to seller competition dynamics, this tool provides the data needed for competitive advantage in Brazilian e-commerce. # 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.magazineluiza.com.br/busca/laptop/?page=3" ], "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.magazineluiza.com.br/busca/laptop/?page=3" ], "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/magazineluiza-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.magazineluiza.com.br/busca/laptop/?page=3"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/magazineluiza-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.magazineluiza.com.br/busca/laptop/?page=3" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/magazineluiza-product-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/magazineluiza-product-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Magazineluiza Product Search Scraper", "description": "Extract product listings from MagazineLuiza.com.br search pages. Gather prices, ratings, seller information, shipping costs, and product details from Brazil's top e-commerce platform. Ideal for price monitoring, market research, and competitive intelligence.", "version": "0.0", "x-build-id": "LFt08ALfDH6e96KtN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~magazineluiza-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-magazineluiza-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~magazineluiza-product-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-magazineluiza-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~magazineluiza-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-magazineluiza-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 } } } } } } } } } } ```