Magalu prices as JSON, with the card, PIX and list price never mixed up
The Magalu API turns magazineluiza.com.br, Brazil's largest retailer and marketplace, into clean JSON in six actions: search, category, product/detail, product/reviews, product/shipping and search/suggest.
6 active endpoints. Every call is 1 credit.
- POST/magalu/v1/search
- POST/magalu/v1/category
- POST/magalu/v1/product/detail
- POST/magalu/v1/product/reviews
- POST/magalu/v1/product/shipping
- POST/magalu/v1/search/suggest
What Magalu endpoints does ReefAPI ship?
6 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Magalu API
3 of 6 endpoints, ready to run
Magalu products for a keyword: card price, PIX price and list price, the best installment plan, any coupon, Magalu or marketplace seller, availability, Magalu's search rating and category.
{ "ok": true, "meta": { "api": "magalu", "endpoint": "search", "mode": "live", "latency_ms": 995.3, "record_count": 40, "cache_hit": false }, "data": { "results": [ { "product_id": "013070701", "type": "product", "title": "Geladeira Electrolux Cycle Defrost 260L Super Freezer Duplex Branca DC35A", "brand": "Electrolux", "url": "https://www.magazineluiza.com.br/geladeira-electrolux-cycle-defrost-260l-super-freezer-duplex-branca-dc35a/p/013070701/ed/ref2/", "image": "https://a-static.mlcdn.com.br/1000x1000/geladeira-electrolux-cycle-defrost-260l-super-freezer-duplex-branca-dc35a/magazineluiza/013070701/02f3faa6d87b2a4161ea70d426e5f99e.jpg", "price": 2314.74, "pix_price": 2199, "pix_discount_pct": 5, "list_price": 2799, "discount_pct": 17, "best_price_other_method": null, "installments": { "count": 10, "amount": 231.47, "total": 2314.74, "interest_free": true, "label": "sem juros" }, "currency": "BRL", "price_source": "offer", "coupon": { "code": null, "discount_type": "amount", "discount_value": 150, "message": null, "valid_from": null, "valid_until": null }, "offer_discounts": null, "seller": { "id": "magazineluiza", "sku": "013070701", "is_magalu": true, "name": null }, "availability": "in_stock", "search_index_rating": 4.67, "search_index_review_count": 10334, "rating_scale": 5, "badges": null, "max_quantity": null, "has_variants": true, "category": { "id": "ED", "name": "Eletrodomésticos" }, "subcategory": { "id": "REF2", "name": "Geladeira Duplex" }, "sponsored": false }, { "product_id": "238975900", "type": "product", "title": "Geladeira/Refrigerador Electrolux Frost Free Duplex Inox Look 480L Efficient TF71S", "brand": "Electrolux", "url": "https://www.magazineluiza.com.br/geladeira-refrigerador-electrolux-frost-free-duplex-inox-look-480l-efficient-tf71s/p/238975900/ed/ref2/", "image": "https://a-static.mlcdn.com.br/1000x1000/geladeira-refrigerador-electrolux-frost-free-duplex-inox-look-480l-efficient-tf71s/magazineluiza/238975900/c18bedf79097270f59476a52b544b6bc.jpg", "price": 3644.79, "pix_price": 3426.1, "pix_discount_pct": 6, "list_price": 4219, "discount_pct": 14, "best_price_other_method": null, "installments": { "count": 10, "amount": 364.48, "total": 3644.79, "interest_free": true, "label": "sem juros" }, "currency": "BRL", "price_source": "offer", "coupon": null, "offer_discounts": null, "seller": { "id": "magazineluiza", "sku": "238975900", "is_magalu": true, "name": null }, "availability": "in_stock", "search_index_rating": 4.77, "search_index_review_count": 2259, "rating_scale": 5, "badges": null, "max_quantity": null, "has_variants": true, "category": { "id": "ED", "name": "Eletrodomésticos" }, "subcategory": { "id": "REF2", "name": "Geladeira Duplex" }, "sponsored": false }, { "product_id": "240972400", "type": "product", "title": "Geladeira/Refrigerador Brastemp Frost Free Duplex 385L BRM46MK", "brand": "Brastemp", "url": "https://www.magazineluiza.com.br/geladeira-refrigerador-brastemp-frost-free-duplex-385l-brm46mk/p/240972400/ed/refr/", "image": "https://a-static.mlcdn.com.br/1000x1000/geladeira-refrigerador-brastemp-frost-free-duplex-385l-brm46mk/magazineluiza/240972400/148cc96df0b4609fd52f0321fca107bb.jpg", "price": 3199, "pix_price": 3039.05, "pix_discount_pct": 5, "list_price": 4409, "discount_pct": 27, "best_price_other_method": null, "installments": { "count": 10, "amount": 319.9, "total": 3199, "interest_free": true, "label": "sem juros" }, "currency": "BRL", "price_source": "offer", "coupon": null, "offer_discounts": null, "seller": { "id": "magazineluiza", "sku": "240972400", "is_magalu": true, "name": null }, "availability": "in_stock", "search_index_rating": 4.81, "search_index_review_count": 989, "rating_scale": 5, "badges": null, "max_quantity": null, "has_variants": true, "category": { "id": "ED", "name": "Eletrodomésticos" }, "subcategory": { "id": "REFR", "name": "Geladeira / Refrigerador" }, "sponsored": false } ], "count": 40, "sponsored_dropped": 0, "sponsored_included": null, "fallback_results_dropped": 0, "total_results": 10000, "total_results_capped": true, "total_pages": 25, "page": 1, "page_size": 40, "has_more": true, "page_notice": null, "matched_query": null, "filters_available": { "attributes": [ { "name": "Cor", "slug": "cor", "values": [ { "value": "bordo", "label": "Bordo", "count": 2 }, { "value": "branco", "label": "Branco", "count": 871 }, { "value": "cinza", "label": "Cinza", "count": 44 } ] }, { "name": "Tipo de Degelo", "slug": "tipo-de-degelo", "values": [ { "value": "frost-free", "label": "Frost Free", "count": 1561 }, { "value": "manual", "label": "Manual", "count": 131 }, { "value": "cycle-defrost", "label": "Cycle Defrost", "count": 75 } ] }, { "name": "Capacidade Líquida Total", "slug": "capacidade-liquida-total", "values": [ { "value": "70l-a-89l", "label": "70l a 89l", "count": 1 }, { "value": "90l-a-99l", "label": "90l a 99l", "count": 1 }, { "value": "100l-a-199l", "label": "100l a 199l", "count": 9 } ] } ] }, "keyword_matches_on_page": 40, "query": "geladeira", "sort": "relevance", "applied_filters": null, "country": "br", "currency": "BRL" } }
How the Magalu API works
Magalu is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 252 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
Compare what one product really costs on Magalu, by payment method and by city
The price on a Magalu card is not the price a card buyer pays, and delivery depends on the CEP. Two calls give the full picture for one product.
{"product_id": "241267100"}6332.22 on card in 10 interest-free installments, 5699.00 by PIX, 7599.00 struck price, coupon LU250 for R$ 250 off, sold and delivered by Magalu, rating 4.86 from 906 reviews.
{"product_id": "241267100", "zipcode": "69005000"}Free standard delivery to Manaus in 15 working days, against 3 working days and 2-hour store pickup for São Paulo 01310-100.
One product priced three ways plus its delivery cost and date for the buyer's city - for one credit per call.
curl -X POST https://api.reefapi.com/magalu/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"geladeira"}'{
"ok": true,
"data": { … },
"meta": {
"api": "magalu",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}Magalu shows three prices for one product - the API returns each in its own field
On a Magalu page the big number is the PIX price, the card price hides in the installment line and the struck price sits above both. Mixing them up is the most common way to store a wrong Magalu price. Values measured on 2026-09-15.
| Magalu product | price (card) | pix_price | list_price | What else the record says |
|---|---|---|---|---|
| Apple iPhone 17 256GB Branco (sold by Magalu) | 6332.22 BRL | 5699.00 BRL | 7599.00 BRL | 10 x 633.22 interest-free; coupon LU250, R$ 250 off, not applied to price |
| Notebook Dell Inspiron 15 I15-I1300-A60P | 5999.00 BRL | 5399.10 BRL | 6999.00 BRL | rating 4.77 from 256 reviews |
| Micro-ondas LG 30L Solo MS3091BC | 714.74 BRL | 679.00 BRL | 899.00 BRL | rating 4.78 from 2074 reviews |
| iPhone 17 Pro Max 256GB (marketplace seller KaBuM!) | 10555.54 BRL | 10555.54 BRL | 14998.89 BRL | no PIX discount (pix_discount_pct null); seller rating 3.5 of 5, 2621761 sales |
| Apple iPhone 17 256GB Lavanda (out of stock) | 6332.22 BRL | null | 7599.00 BRL | availability out_of_stock, price_source last_known, no installments |
Magalu sorts by price and filters by price range on the lower of these numbers (the PIX price when there is one), so a price_asc page is ordered by pix_price, not by price. On 8 of 8 products checked, all three prices matched Magalu's own product page.
Which price, which seller, which CEP, and what Magalu does not publish
Brazil only, prices in BRL. Measured on 2026-09-15 across 30 products in 18 categories, 25 searches, 12 review pages, 12 delivery quotes, 50 controlled checks and a comparison of 8 products with Magalu's own product page. Four of these lines go against us.
price (card, equal to the interest-free installment total), pix_price with pix_discount_pct, and list_price (the struck price, null when none). On 8 of 8 products all three matched Magalu's product page; PIX price was filled on 30 of 30 sampled products, list price on 25 of 30.
seller.is_magalu and marketplace say who sells the item; product/detail adds the seller's rating on a 5 scale, total sales, response and delivery reputation, city and state. Filled on 30 of 30 sampled products.
product/shipping returned delivery options on 12 of 12 quotes to 10 Brazilian capitals: cost, free or not, working days or hours, expected delivery date and who ships it. Unknown CEPs return INVALID_PARAM; out-of-stock items return no options.
availability out_of_stock with the last known price (price_source last_known); PIX price and installments are null because nothing can be bought. A product id that does not exist returns NOT_FOUND.
EAN, brand, description, specifications, images, package dimensions and category breadcrumb were filled on 30 of 30 sampled products; variants on 21 of 30 (the rest have one variant); rating on 29 of 30.
Misspellings are corrected with matched_query; unrelated filler for a nonsense keyword is removed and counted (8 of 8 nonsense keywords returned no unrelated rows, 0 of 30 real keywords were emptied); sponsored rows are removed and counted.
Magalu orders price_asc / price_desc and applies min_price / max_price to the PIX price when there is one, not to the card price, and lets a few rows just outside a price range through (37 of 40 inside in one sample).
A price-sorted page can hold fewer rows than page_size, sometimes none, because Magalu removes rows after paging (geladeira price_asc: 15 of 40 rows on page 1). has_more follows Magalu's page count and an empty page carries page_notice; a larger page_size avoids empty pages.
installments is the best plan only; the per-card table and any Magalu Pay or Cartão Luiza price are not published here. No stock quantity either.
There is no daily-deals action, search/suggest returns search terms but not products, and reviews cannot be filtered by star rating (sort by positive or negative instead). Totals are capped at 10000 and search stops at page 100.
What people build with Magalu
The jobs this data is most often used for.
endpoints
credit per call
Price monitors in Brazil track Magalu's card, PIX and list prices separately, with the coupon that is running.
Brands and distributors see which marketplace sellers list their products on Magalu, at what price and with what seller rating.
Logistics and pricing teams compare delivery cost and time for the same product across Brazilian CEPs.
Catalog teams match Magalu products to other retailers by EAN and pull specifications, images and variants.
What Magalu data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 252 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/magalu/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"geladeira"}'import requests
r = requests.post(
"https://api.reefapi.com/magalu/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "geladeira"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Magalu.
Get a free key →Which Magalu price should I store?▾
All three mean different things. price is what a card buyer pays (it equals the interest-free installment total), pix_price is the lower price for paying by PIX, and list_price is the struck "de" price, null when Magalu shows none (5 of 30 sampled products). discount_pct compares price with list_price; pix_discount_pct is Magalu's own PIX discount. A coupon is returned in coupon and is never subtracted.
Is it sold by Magalu or by a marketplace seller?▾
seller.is_magalu is true for Magalu's own stock and marketplace is true for everyone else. product/detail names the seller and adds its rating on a 5 scale, total sales, how fast it answers, whether it delivers on time and its city and state - KaBuM! read 3.5 of 5 with 2621761 sales. Each marketplace seller's listing has its own product id on Magalu, so one product/detail is one seller's offer.
Can I get the delivery price and date for a CEP?▾
Yes, product/shipping takes a product id and any Brazilian CEP and returns the options Magalu offers there: on 2026-09-15 an iPhone sold by Magalu was free in 3 working days to São Paulo 01310-100 with store pickup in 2 hours, and 15 working days to Manaus; the KaBuM! listing cost 37.78 to São Paulo and 95.23 to Manaus. A CEP that does not exist returns INVALID_PARAM, an out-of-stock product returns no options, and a seller that does not ship to the region says so in shipping_status.
What happens with out-of-stock products?▾
They are still returned. availability is out_of_stock, price is the last price Magalu showed (price_source last_known) and pix_price and installments are null because nothing can be bought. A product id that does not exist returns NOT_FOUND.
Do the sorts and filters really apply?▾
Yes, measured on 2026-09-15: geladeira has more than 10000 results; brand consul cut it to 2124 (every row Consul), seller magazineluiza to 372 (every row sold by Magalu) and a R$ 1500-2500 price range to 2212. Price sorts and the price range use the PIX price when there is one, and Magalu lets a few rows just outside a range through (37 of 40 in one sample). Totals are capped at 10000 and search stops at page 100.
What happens when a search has no match or is misspelled?▾
Misspellings are corrected by Magalu and say so in matched_query (geladera to geladeira, notbook to notebook); 30 of 30 real keywords including misspellings returned products. When a nonsense keyword gets unrelated filler products they are removed and counted in fallback_results_dropped, and include_fallback_results returns them separately. Sponsored rows are removed and counted in sponsored_dropped.
What does Magalu NOT publish here?▾
No stock quantity (availability is a status), no full installment table per card (only the best plan), no Magalu Pay or Cartão Luiza member price, and no daily-deals list. Search suggestions are terms, not products. A price-sorted page can come back shorter than page_size because Magalu removes rows after paging; has_more still tells you whether more pages exist.
What is the Magalu API?▾
Magalu API is a ReefAPI endpoint group for magazine luiza in brazil: card, pix and list prices kept apart, installments, marketplace sellers and delivery by cep. It returns live JSON through POST requests under /magalu/v1.
Is the Magalu API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Magalu calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Magalu login or account?▾
No login to Magalu is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Magalu data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Magalu API use?▾
Magalu actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Magalu from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call magalu actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Magalu API a Magalu scraper?▾
It is the managed alternative to a DIY Magalu scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same magazine luiza in brazil: card, pix and list prices kept apart, installments, marketplace sellers and delivery by cep back as clean JSON.
91 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Magalu, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 251 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-09-15.