# Magazine Luiza (Magalu) Product, Price & Seller Scraper (`dami_studio/magazine-luiza-scraper`) Actor Scrape magazineluiza.com.br by keyword, subcategory or product URL. Every row carries the card price, the Pix price, the best interest-free instalment plan, the seller, stock, star rating and review count. No login and no API key. You are only charged for products actually returned. - **URL**: https://apify.com/dami\_studio/magazine-luiza-scraper.md - **Developed by:** [Dami's Studio](https://apify.com/dami_studio) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.80 / 1,000 product returneds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Magazine Luiza Scraper (Magalu): products, prices, sellers Pulls product data off **magazineluiza.com.br**: what it costs, what it costs in Pix, how many interest-free instalments Magalu is offering, who is actually selling it, whether it is in stock, and what buyers rated it. Give it a search term like `geladeira`, or paste Magalu URLs. You get one row per product. No login. No Magalu account. No API key. *** ### Why this exists Magalu is a marketplace, so the price you see is only half the story. The same fridge can sit on three different sellers at three different prices, and the number on the card is not the number most Brazilians pay. Pix knocks another 5-10% off, and the instalment plan is what people actually compare. A scraper that returns one `price` field and stops is not much use to anyone pricing against Magalu. So every row carries all four numbers: the sticker price, the crossed-out price it is discounted from, the Pix/cash price, and the best interest-free instalment plan. Plus the seller, because "sold by Magalu" and "sold by some marketplace seller" are different products commercially even when they are the same SKU. *** ### What you get One row per product. From the listing, every row has: | Field | What it is | |---|---| | `productId` | Magalu's own product id (the code in the URL after `/p/`) | | `sku` | the seller's SKU for that product | | `title` | product name as Magalu shows it | | `brand` | e.g. `LG`, `Samsung`, `Electrolux` | | `url` | canonical product page | | `price` | the price on the card, in BRL | | `listPrice` | the crossed-out "de" price, when there is one | | `discountPercent` | worked out from those two | | `cashPrice` | what you pay settling in one go, usually Pix | | `cashPaymentMethod` | which method that price belongs to, e.g. `no Pix` | | `installmentCount` / `installmentAmount` | the best plan Magalu advertises, e.g. 10 × R$399.90 | | `installmentTotal` / `installmentTerms` | plan total, and whether it is `sem juros` | | `sellerId` / `sellerName` | who is selling it | | `soldByMagalu` | `true` when Magalu itself is the seller, not a marketplace seller | | `available` | in stock | | `rating` / `reviewCount` | stars out of 5, and how many reviews | | `category` / `subcategory` | plus their Magalu ids | | `image` | main photo, at a usable resolution | | `sponsored` | `true` if Magalu placed it as a paid result | | `searchQuery` / `position` / `page` | where in the listing it came from | Turn on **Open each product page for full detail** and each row also gets `description`, the full `images` array, `modelReference` (the manufacturer's model code, when the seller filled it in), `weightKg`, `dimensionsMeters`, `commentCount` and `variations` (the colour and capacity options, with which one this row is). That second mode costs one extra request per product, so a 200-product run goes from seconds to a couple of minutes. The price per product is the same either way. #### A real row ```json { "productId": "238058800", "sku": "238058800", "title": "Geladeira/Refrigerador LG Frost Free Smart Inverse", "brand": "LG", "url": "https://www.magazineluiza.com.br/geladeira-refrigerador-lg-frost-free-smart-inverse-prata-451l-inox-look-gc-b569nllm-apzfsbs/p/238058800/ed/rinv/", "price": 3999, "listPrice": 5999, "discountPercent": 33.3, "cashPrice": 3759.06, "cashPaymentMethod": "no Pix", "installmentCount": 10, "installmentAmount": 399.9, "installmentTotal": 3999, "installmentTerms": "sem juros", "currency": "BRL", "sellerId": "magazineluiza", "sellerName": "magazineluiza", "soldByMagalu": true, "available": true, "rating": 4.78, "reviewCount": 1084, "categoryId": "ED", "category": "Eletrodomésticos", "subcategoryId": "RINV", "subcategory": "Refrigerador Inverse", "sponsored": false, "searchQuery": "geladeira", "position": 1, "page": 1 } ``` *** ### Input ```json { "searchTerms": ["geladeira", "smart tv 50"], "maxItems": 200, "sortBy": "price_asc", "minPrice": 1000, "maxPrice": 4000, "includeSponsored": false, "fetchFullDetail": false } ``` Or paste URLs instead: ```json { "startUrls": [ "https://www.magazineluiza.com.br/busca/cafeteira/", "https://www.magazineluiza.com.br/notebook/informatica/s/in/note/", "https://www.magazineluiza.com.br/notebook-samsung-galaxy-book-go-windows-11-home-snapdragon/p/bf5b6ak0gg/in/nsbo/" ], "maxItems": 100 } ``` Three kinds of URL work: a search page (`/busca//`), a subcategory list (the ones with `/s/` in the path), and a single product page (`/p//...`). A product URL always comes back with the full detail fields, since that is the only way to serve it. **Search in Portuguese.** Magalu's search is Portuguese-first and it is not close: `geladeira` returns a full catalogue, `refrigerator` returns almost nothing. Accents are optional: `cafe` and `café` both work. *** ### What this does not do Worth reading before you buy, because these are the things people ask about afterwards. - **Department pages ending in `/l//` are not supported.** Magalu's own data feed behind those URLs returns a server error on their side, not ours. Use the subcategory list underneath it. Open the department, click a subcategory, and paste that URL, or just use a search term. The actor tells you this in a free diagnostic row rather than failing the run. - **One search term tops out at about 1,000 products.** Magalu stops paginating at page 25 and then quietly starts returning empty pages. The actor stops there rather than spinning. If you need more than that, split the job across narrower terms. - **The price range is applied here, not at Magalu's end.** Their own price filter is unreliable. Asking it for R$1,000-3,000 came back with products priced R$10 to R$33, so the range is enforced after the fact. Everything outside it is dropped and you are not charged for it, but the run still has to read past those products to fill your row count. - **A term Magalu cannot match comes back as nothing, not as padding.** Search their site for a typo and it does not say "no results" — it quietly fills the page with 1,000 unrelated products, televisions and dog shampoo and mattresses, at a normal HTTP 200. The actor spots that on the first page, drops the lot, and writes a free diagnostic row telling you the term found nothing. You are not charged for any of it. The trade-off is that a very loose term might occasionally be called a miss; if that happens, use a more specific word. - **No reviews.** You get the star rating and the review count, not the review text. - **No price history.** One row is one moment. Schedule the run if you want a series. - **No stock quantity**, just in stock or not. Magalu does not publish the number. - **`sellerName` is often the seller's store handle** (`magazineluiza`, `samsung`) rather than a tidy display name. That is what Magalu returns on the listing. - **Sponsored results are kept by default**, flagged `sponsored: true`. They are real products that Magalu paid-placed into your results. Set `includeSponsored` to false and they are dropped before they are charged for. - **Prices are what Magalu shows a logged-out visitor in Brazil.** Members and card holders see their own prices; those are not visible here. *** ### Pricing and what actually bills You are charged **per product row returned**. The current figure is on the Pricing tab. Free, every time: - The **sample row** you get from a run with no input. - Every **diagnostic row**: a URL that could not be read, a search that found nothing, a product page that has been retired, a refusal from Magalu. - Products dropped by your own filters, so anything outside `minPrice`/`maxPrice`, and sponsored placements when you have those turned off. So a run that finds nothing costs you nothing beyond starting it, and you never pay for a row you filtered out yourself. `maxItems` is a hard cap across every term and URL in the run, which makes it your spend cap too. *** ### Speed Measured on real runs: 12 products across two search terms took **5.6 seconds**. Listing mode reads 40 products per request, so a 200-product job is a handful of requests, not two hundred. Full-detail mode is a different shape, one extra request per product, so budget roughly a second per product on top. *** ### FAQ **Does this need a Magazine Luiza account or an API key?** No. Nothing is logged in and no key is used. You only need your Apify account. **Can I scrape a whole category?** Yes, through a subcategory URL (one with `/s/` in the path) or a search term. The department pages ending in `/l/` do not work. See the limitations above; that one is on Magalu's side. **How do I get the Pix price rather than the card price?** It is already there, as `cashPrice`, with `cashPaymentMethod` naming which method it belongs to. **Why is the price different from what I see in my browser?** Most often because you are signed in. Magalu shows members and card holders their own prices. This returns what a logged-out visitor in Brazil sees. **Can I track a handful of specific products over time?** Paste their product URLs into `startUrls` and schedule the run. Each run writes a fresh row per product with a `scrapedAt` timestamp. **What happens if Magalu blocks a request?** The actor retries from a different address. If it still cannot get through it writes a diagnostic row saying so and finishes normally. You are not charged for it, and you do not get a failed run that ate your start fee. **Can I use my own proxies?** Yes. Put them in `proxyConfiguration.proxyUrls` and they are used exactly as given. **Is the data sorted the way Magalu sorts it?** By default yes, Magalu's own relevance order, with `position` recording where each product sat. `sortBy` switches to price, best-selling, best-rated or newest. **Can I filter to only products Magalu sells itself?** Not as an input, but every row carries `soldByMagalu`, so filter on that afterwards. *** ### Notes Prices are BRL. `scrapedAt` is UTC. Rows are deduplicated by `productId` within a run, so the same product appearing under two of your search terms is charged once. # Actor input Schema ## `searchTerms` (type: `array`): What to search for on magazineluiza.com.br, one per line. Magalu's search is Portuguese-first, so "geladeira" returns far more than "refrigerator". Accents are optional. ## `startUrls` (type: `array`): Optional. Paste search pages (https://www.magazineluiza.com.br/busca/geladeira/), single product pages (.../p////) or subcategory lists (the ones with /s/ in the path). Department pages ending in /l// are not supported — Magalu's own data feed errors on those. Works alongside the search terms above. ## `maxItems` (type: `integer`): Hard cap on rows across every term and URL in this run. You are charged per product returned, so this is also your spend cap. Magalu stops paginating a single search at 1,000 products. ## `sortBy` (type: `string`): The order Magalu returns the listing in. Relevance is their default. Sorting does not change what you are charged. ## `fetchFullDetail` (type: `boolean`): Off, every row comes from the listing: title, id, prices, instalments, seller, rating, review count, stock, one image. On, the actor also opens each product page for the description, every photo, the manufacturer's model code, weight, box dimensions and the colour/size variations. That is one extra request per product, so a run takes noticeably longer. The price per product is the same either way. ## `minPrice` (type: `integer`): Optional. Products under this price are dropped and you are not charged for them. Magalu's own price filter is unreliable — asking it for R$1,000-3,000 came back with R$10 items — so the range is applied here instead, which means the run still reads past them to fill your row count. ## `maxPrice` (type: `integer`): Optional. Same idea, the other way round. Also applied here rather than at Magalu's end. ## `includeSponsored` (type: `boolean`): Magalu mixes paid placements into its results. They are real products and are kept by default, flagged with "sponsored": true so you can filter them later. Turn this off to drop them before they are charged for. ## `proxyConfiguration` (type: `object`): Optional. The actor already picks its own addresses; leave this alone unless you need to exit from a specific network. Residential is not used here and will be ignored if you select it. ## Actor input object example ```json { "searchTerms": [ "geladeira" ], "startUrls": [], "maxItems": 50, "sortBy": "relevance", "includeSponsored": true, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): One row per product: title, product id and seller SKU, brand, sticker price, Pix/cash price, the discount against the crossed-out price, the best interest-free instalment plan, seller name and whether Magalu itself is selling, stock, star rating, review count, category and subcategory, image and product URL. Turn on full detail and each row also carries the description, every product photo, the manufacturer's model code, weight, box dimensions and the colour/size variations. Runs with no input, a URL that cannot be read or a search that finds nothing write an uncharged sample or diagnostic row instead. # 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 = { "searchTerms": [ "geladeira" ], "startUrls": [], "maxItems": 50, "sortBy": "relevance", "fetchFullDetail": false, "includeSponsored": true, "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("dami_studio/magazine-luiza-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 = { "searchTerms": ["geladeira"], "startUrls": [], "maxItems": 50, "sortBy": "relevance", "fetchFullDetail": False, "includeSponsored": True, "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("dami_studio/magazine-luiza-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "geladeira" ], "startUrls": [], "maxItems": 50, "sortBy": "relevance", "fetchFullDetail": false, "includeSponsored": true, "proxyConfiguration": { "useApifyProxy": false } }' | apify call dami_studio/magazine-luiza-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,dami_studio/magazine-luiza-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/41vC7dKw7SAlt36ol/builds/YST0XEAqiddmba84d/openapi.json