Magazineluiza Product Search Scraper

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

The Actor supports two scraping modes — use only one at a time:

1. Scrape by URLs — scrape data directly from a list of MagazineLuiza product search URLs.

{
  "urls": ["https://www.magazineluiza.com.br/busca/laptop/?page=3"],
  "ignore_url_failures": true,
  "max_items_per_url": 50
}

2. Scrape by search filters — scrape data using a keyword and additional filters (price range, rating, sorting, etc.) instead of providing URLs.

{
  "keyword": "a",
  "sort_by": "shippingTime",
  "price_range": "1000-100000",
  "rating": "4",
  "page": 1,
  "max_items_per_url": 200
}

There is also a General settings group that applies to both modes.

1. Scrape by URLs

Use this mode when you already have specific search result URLs. When this mode is used, all options in the "Scrape by search filters" section will be disabled.

Field	Type	Default	Description
urls	array	(required)	Search result page URLs from MagazineLuiza to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. 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	boolean	true	If true, the scraper continues running even if some URLs fail to be scraped. Individual failures won't stop the entire run — essential for large datasets where some pages may be temporarily unavailable.

Building URL Lists: Perform manual searches with desired filters (brand, price range, ratings). Copy the resulting URLs. For comprehensive category extraction, systematically increment page numbers: ?page=1, ?page=2, etc.

2. Scrape by search filters

Use this mode when you want to search using a keyword and additional filter attributes instead of scraping by URLs. If you use this mode, leave the urls field above empty.

Field	Type	Default	Description
keyword	string	—	The keyword to search for.
sort_by	string (score, shippingTime, price, soldQuantity, review, releaseDate)	—	Sort results by Relevance, Shipping Time, Price, Sold Quantity, Review, or Release Date.
price_range	string (format min-max)	—	Price range to filter by. The value must be the price multiplied by 100 (e.g., R$10 becomes 1000, R$1000 becomes 100000), so a valid input looks like 1000-100000.
rating	string ("", 5, 4, 3, 2, 1)	—	Filter by rating: All (empty), or 5/4/3/2/1 stars.
page	integer	—	The page number to start scraping from.

3. General settings

Applies to both scraping modes above.

Field	Type	Default	Description
max_items_per_url	integer	20	Maximum number of products to extract per URL. MagazineLuiza typically shows 20–40 products per page. Set higher (50–100) for complete page capture, or lower for testing.
proxy	object	{}	Select proxies to be used by your scraper.
include_raw_data	boolean	false	If true, the scraper will include raw data from website before cleaning in the output.

Complete Output Structure

Sample Output:

{
  "id": "abg3h7933j",
  "product_url": "https://www.magazineluiza.com.br//notebook-vaio-fe-16-intel-core-i3-1315u-8gb-256gb-ssd-linux-16/p/abg3h7933j/in/fe15/",
  "title": "Notebook VAIO FE 16 Intel Core i3 1315U 8GB 256GB SSD Linux 16\"",
  "sku": "2064",
  "brand": "Vaio",
  "brand_slug": "vaio",
  "category_id": "IN",
  "category_name": "Informática",
  "subcategory_id": "FE15",
  "subcategory_name": "Notebook Vaio",
  "attributes": {
    "capacidade do armazenamento": "256GB",
    "cor": "Preto"
  },
  "is_available": true,
  "currency": "BRL",
  "list_price": 3899,
  "price": 3599,
  "pix_price": 3239.1,
  "pix_discount_percent": 10,
  "installment_count": 10,
  "installment_amount": 359.9,
  "installment_total": 3599,
  "installment_description": "sem juros",
  "minimum_order_quantity": 1,
  "max_checkout_quantity": null,
  "promo_start_date": null,
  "promo_end_date": null,
  "badges": [],
  "seller_id": "esh0p",
  "seller_name": "Eshop",
  "seller_sku": "2064",
  "review_count": 10,
  "review_rating": 3.4,
  "shipping_cost": null,
  "shipping_time": "",
  "is_sponsored": null,
  "is_buy_box": false,
  "tags": [
    "fulfillment"
  ],
  "image_url": "https://a-static.mlcdn.com.br/800x800/notebook-vaio-fe-16-intel-core-i3-1315u-8gb-256gb-ssd-linux-16/esh0p/2064/974fb6458e5fcbb792fdb9c5c9eebf6f.jpeg",
  "raw_data": null,
  "from_url": "https://www.magazineluiza.com.br/busca/laptop/?page=3"
}

Complete Output Structure and Field Definitions

The scraper returns JSON data with each product as an object containing detailed fields. Understanding field purposes enables effective analysis and application.

Product Identification

ID: Unique identifier of the product variation on Magazine Luiza. Purpose: Database indexing, tracking specific products over time, avoiding duplicates.

Product URL: Direct link to the product page on Magazine Luiza. Purpose: Accessing complete details, sharing products with clients, verification of scraped data.

Title: Full product name as shown on the listing. Purpose: Keyword analysis, product matching, catalog building.

SKU: Seller's stock keeping unit / manufacturer model code. Purpose: Matching the same product across marketplaces and sellers.

Brand and Category

Brand: Brand name of the product. Purpose: Brand-level market share and price analysis.

Brand Slug: URL-friendly brand identifier. Purpose: Building brand-based search URLs and joining datasets.

Category ID: Code of the main product category. Purpose: Filtering and grouping by department.

Category Name: Human-readable name of the main category. Purpose: Display in reports and dashboards.

Subcategory ID: Code of the product subcategory. Purpose: Fine-grained segmentation.

Subcategory Name: Human-readable name of the subcategory. Purpose: Niche market analysis and reporting.

Attributes: Selected product variation attributes (e.g., storage capacity, color) as label-value pairs. Purpose: Comparing variants and filtering by specification.

Pricing and Offers

Is Available: Whether the product is currently in stock. Purpose: Monitoring stock availability and demand.

Currency: Currency of all prices (BRL). Purpose: Correct financial interpretation when merging datasets from multiple markets.

List Price: Original price before discount. Purpose: Calculating discount depth and price positioning.

Price: Current selling price (standard payment). Purpose: Price comparison, competitor monitoring, market valuation.

Pix Price: Discounted price when paying via Pix. Purpose: Identifying the lowest cash price and promotional strategy.

Pix Discount Percent: Discount percentage applied for Pix payment. Purpose: Measuring promotional intensity.

Installment Count: Maximum number of installments in the best plan. Purpose: Analyzing financing options offered to buyers.

Installment Amount: Value of each installment. Purpose: Monthly affordability analysis.

Installment Total: Total amount paid under the best installment plan. Purpose: Comparing the total cost of financing versus cash.

Installment Description: Interest condition of the plan (e.g., "sem juros" = interest-free). Purpose: Distinguishing interest-free from interest-bearing plans.

Minimum Order Quantity: Minimum units per purchase. Purpose: Identifying bulk-only or standard offers.

Max Checkout Quantity: Maximum units allowed per order (may be null). Purpose: Detecting purchase limits on promotional items.

Promo Start Date: Start of the time-limited promotion (may be null). Purpose: Tracking promotion schedules.

Promo End Date: End of the time-limited promotion (may be null). Purpose: Identifying urgency-driven campaigns.

Badges: List of promotional badges attached to the offer (e.g., campaign tags). Purpose: Tracking participation in sales events and campaigns.

Seller

Seller ID: Unique identifier of the seller. Purpose: Grouping products by seller, competitor tracking.

Seller Name: Display name of the seller. Purpose: Lead generation, competitor and marketplace analysis.

Seller SKU: Seller's own product code. Purpose: Cross-referencing with the seller's catalog.

Reviews

Review Count: Number of customer reviews. Purpose: Measuring popularity and review reliability.

Review Rating: Average customer rating. Purpose: Quality assessment, customer satisfaction analysis.

Shipping

Shipping Cost: Shipping cost shown on the listing (may be null). Purpose: Total cost calculation and delivery competitiveness.

Shipping Time: Estimated delivery time shown on the listing (may be empty). Purpose: Comparing delivery speed across sellers.

Listing Flags

Is Sponsored: Whether the listing is a paid advertisement. Purpose: Analyzing advertising investment by brands and sellers.

Is Buy Box: Whether this offer holds the Buy Box (featured offer). Purpose: Identifying winning offers among competing sellers.

Tags: List of platform tags attached to the product. Purpose: Additional segmentation when available.

Image URL: Link to the main product image (800x800). Purpose: Visual inspection, catalog building, computer vision analysis.

Raw Data

Raw Data: Complete original JSON object of the product as scraped, without modification. Purpose: Auditing, debugging, accessing fields not included in the cleaned output, and reprocessing without re-scraping.

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.