Americanas prices as JSON, with the card price and the PIX price never mixed up
The Americanas API turns americanas.com.br, one of Brazil's largest retailers and marketplaces, into clean JSON in seven actions: search, category, seller/products, product/detail, product/batch, filters and search/suggest.
7 active endpoints, on 0, 1, 3 and 5 credit tiers.
- POST/americanas/v1/search
- POST/americanas/v1/category
- POST/americanas/v1/seller/products
- POST/americanas/v1/product/detail
- POST/americanas/v1/product/batch
- POST/americanas/v1/filters
- POST/americanas/v1/search/suggest
What Americanas endpoints does ReefAPI ship?
7 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Americanas API
4 of 7 endpoints, ready to run
Americanas products for a keyword: the card price, the PIX price and its discount, the struck list price, the best interest-free instalment plan, the seller and whether it is Americanas itself or its marketplace, availability and how many sellers offer the item.
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
How the Americanas API works
Americanas 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 280 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.
Find out what an Americanas product really costs, and who is actually selling it
The big number on an Americanas page is the PIX price, the card price hides in the instalment line, and the first seller listed on a product is usually a placeholder with no price at all. Two calls settle all three.
{"query": "smartphone samsung", "sort": "price_asc"}Each row carries price_brl and pix_price_brl side by side, so a repricer can tell a 10 percent PIX discount from a real price cut instead of storing one number and guessing.
{"product_id": "8296864"}943.33 on card as 8 interest-free instalments of 117.91, 849.00 by PIX with pix_discount_pct 10, 1399.00 struck — sold by Magazine Luiza on Americanas' marketplace, with the EAN, specifications and every competing offer.
{"product_ids": ["8296864", "8380814", "723966"]}Refresh a whole watchlist in one call rather than ten, for less than ten single reads.
One product priced the way Brazil actually quotes it - by card and by PIX - with the seller who really ships it, and a batch call to keep a catalogue current.
curl -X POST https://api.reefapi.com/americanas/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"cafeteira eletrica"}'{
"ok": true,
"data": { … },
"meta": {
"api": "americanas",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}One Americanas product, three prices - each returned in its own field
The big number on an Americanas page is the PIX price, the card price hides in the instalment line and the struck price sits above both. Mixing them up is the most common way to store a wrong Brazilian price. Values measured on 2026-09-23.
| Americanas product | price_brl (card) | pix_price_brl | list_price_brl | What else the record says |
|---|---|---|---|---|
| Smartphone Samsung Galaxy A07 256GB (8296864) | 943.33 BRL | 849.00 BRL | 1399.00 BRL | PIX discount 10%, discount 32.57% off list, 8 x 117.91 interest-free, sold by Magazine Luiza |
| Monitor Gamer HQ Ultra 24" IPS 200Hz (8380814) | 709.00 BRL | 638.10 BRL | null | PIX discount 10%; no struck price, so list_price_brl is null, never 0 |
| Perfume Banderas The Golden Secret Masculino (8363979) | 194.99 BRL | 185.24 BRL | 289.00 BRL | PIX discount 5%, discount 32.53% off list, 3 x 64.99, sold by Magazine Luiza |
| AirPods 5 (8409232) | 1618.80 BRL | 1537.86 BRL | null | PIX discount 5%, 8 x 202.35 interest-free, sold by Loja iPlace |
| Cafeteira Mondial Dolce Arome C-30-18X-FB (723966) | 119.99 BRL | 119.99 BRL | 129.90 BRL | no PIX discount, so pix equals price and pix_discount_pct is null; sold by Americanas itself, 2 sellers offer it |
Americanas' own product page headlines the PIX price. On 10 of 10 products checked against that page, pix_price_brl, the SKU and the EAN all matched. price_asc and price_desc order by the card price. list_price_brl is null when Americanas shows no struck price - it was present on 14 of 30 sampled products and on 0 of 5 smartphones, so check it rather than assume it.
Which price, which seller, and what Americanas does not publish
Brazil only, prices in BRL. Measured on 2026-09-23 across 30 products in 6 categories, 20 keyword searches, 6 category browses, 4 seller listings, 47 controlled checks, and a field-by-field comparison of 10 products against Americanas' own product page. Five of these lines go against us.
price_brl is the card price and equals the interest-free instalment total; pix_price_brl is the lower a-vista price you pay by PIX, with pix_discount_pct beside it; list_price_brl is the struck price, with discount_pct. On 10 of 10 products checked, pix_price_brl, the SKU and the EAN all matched Americanas' own product page.
This is the trap the split exists for: on 5 of those 10 products the card price and the headline PIX price differed by 5 to 11 percent. A feed that stores a single 'price' is wrong on roughly half of Americanas' discounted stock, with nothing in the response to warn it.
Americanas lists a zero-priced, out-of-stock 'AMERICANAS SA' entry ahead of the real offer on most products - it appeared on every multi-seller product sampled, and Americanas' own product page publishes it too. The API always returns the seller that actually sells the item, so no row comes back priced 0.
seller.is_americanas and marketplace say who is selling; offer_count says how many sellers list the product, and product/detail returns each of those offers with its own card price, PIX price, instalment plan and availability, cheapest PIX price first. seller/products pages through one named seller's whole catalogue.
Title, brand, images, description, specifications, variants, the seller and both prices were filled on 30 of 30 sampled products, and the EAN on 29 of 30 - enough to key a price feed on EAN. A product id that does not exist returns NOT_FOUND, never an empty success.
Americanas does not pad a no-match keyword with unrelated stock: 10 of 10 nonsense keywords returned nothing at all. So zero results means zero results, and no filler has to be detected or stripped.
brand, seller, min_price, max_price, category_path, in_stock_only and any facet the filters action publishes were each measured to change the result total in the same run. The filters action returns the brands, sellers, price range and per-category attributes Americanas itself offers, ready to pass back into search.
Americanas does not publish review text or star ratings anonymously - 72 products across six categories all came back with empty rating counters, and the product pages carry no rating markup. Rather than invent the field, this API returns none. The Magalu API on ReefAPI does return Brazilian marketplace reviews.
in_stock is a true or false and there is no unit count. Americanas reports an identical placeholder quantity for essentially every product - 150 of 150 offers sampled across three categories carried the same number - so a stock figure taken from it would look precise and mean nothing.
list_price_brl exists only where Americanas shows a struck price: 14 of 30 sampled products, and 0 of 5 smartphones. discount_pct is null with it. reference was present on 19 of 30 and a promotion on 22 of 30, so check these rather than assume them.
Americanas serves only the first 2500 products of any result set. total_results still reports the full count, and a result set larger than that window comes back with has_more false and stop_reason 'offset_cap' so you can tell the source's ceiling from a real end of results. Asking for a deeper page returns INVALID_PARAM explaining the limit.
There is no delivery-cost or delivery-date action for a CEP, and the offer carries only the seller's id and name - Americanas publishes no seller rating, sales total or location. Its best-sellers ordering is not offered either, because the source accepts it and returns the relevance order unchanged.
What people build with Americanas
The jobs this data is most often used for.
endpoints
credits per call
Track card, PIX and struck prices per SKU over time and alert when the PIX discount changes, using pix_discount_pct and discount_pct instead of recomputing them.
Monitor a marketplace seller's whole Americanas catalogue with seller/products, and watch competitors appear on your own listings through product/detail's full offer list.
Build a Brazilian price-comparison or repricing feed keyed on EAN, which was present on 29 of 30 sampled products.
Feed product/batch a list of ids from your own catalogue to refresh prices, availability and instalment terms in one call per 10 products.
What Americanas data costs
The cheapest call here is 0 credits, 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 280 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/americanas/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"cafeteira eletrica"}'import requests
r = requests.post(
"https://api.reefapi.com/americanas/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "cafeteira eletrica"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Americanas.
Get a free key →Which Americanas price should I store?▾
It depends what you are comparing. price_brl is what a card buyer pays and equals the interest-free instalment total. pix_price_brl is the lower a-vista price for paying by PIX and is the number Americanas headlines on the product page; pix_discount_pct is the discount the store itself states. list_price_brl is the struck price, null when there is none (14 of 30 sampled products had one), and discount_pct compares the card price with it. On 5 of 10 products checked the card and PIX prices differed by 5 to 11 percent, so the two are not interchangeable.
Is it sold by Americanas or by a marketplace seller?▾
seller.is_americanas is true for Americanas' own stock and marketplace is true for everyone else. The seller block gives the seller's id and name - Magazine Luiza, Loja iPlace, Belmicro and AMERICANAS SA all appeared in the measured sample. offer_count tells you how many sellers list the product, and product/detail returns every one of those offers with its own card price, PIX price, instalment plan and availability, cheapest PIX price first.
Can I list everything one marketplace seller sells?▾
Yes. seller/products takes a seller name and pages through that seller's catalogue with the same fields, sorts and filters as search; magazine-luiza returned 13734 products and americanas-sa 19889 in the measured run. Use the filters action to get the exact seller names Americanas recognises. A seller name that does not exist returns NOT_FOUND rather than a silently empty page.
Does the API return reviews or ratings?▾
No, and that is a property of the source rather than a gap in the API. Americanas does not publish review content or star ratings anonymously: 72 products across six categories all returned empty rating counters, and the product pages carry no rating markup. Rather than invent a field, the API returns none. If you need Brazilian marketplace reviews, the Magalu API on ReefAPI does return them.
Does it tell me how many units are in stock?▾
No - it returns in_stock as a true or false, and no stock count. Americanas reports the same placeholder quantity for essentially every product (150 of 150 offers sampled across three categories carried an identical number), so a stock figure taken from it would look precise and mean nothing. in_stock_only=true on search and browse drops the products Americanas lists as unavailable.
Which filters and sorts actually work?▾
Filters: brand, seller, min_price and max_price, category_path, in_stock_only, and any facet the filters action publishes passed through the facets parameter - for example genero/feminino or tamanho/41. All were measured to change the result total in the same run. Sorts: relevance, price_asc, price_desc, newest, discount and name_asc, each verified to reorder on its own dimension. Americanas' 'mais vendidos' ordering is deliberately not offered, because the source accepts it and returns the relevance order unchanged - an option that can never do anything is worse than no option.
How deep can I page?▾
Americanas serves the first 2500 products of any result set, so (page - 1) x page_size must be below 2500 - for example 50 pages of 50. Past that the API returns INVALID_PARAM explaining the limit rather than an empty page. When a result set is larger than that window, the response says has_more false with stop_reason 'offset_cap' and max_reachable_results, so you can tell a real end-of-results from the source's ceiling. total_results always reports the full count.
How do I look up many products at once?▾
product/batch takes up to 10 product ids or product URLs and returns the same full record as product/detail for each, with any id that does not resolve listed in not_found[] instead of failing the whole call. It is priced well below 10 single reads. Ids from search resolve to the same record in detail - measured on 7 of 7 - and batch records matched single reads on 3 of 3 prices checked.
What is the Americanas API?▾
Americanas API is a ReefAPI endpoint group for americanas in brazil: card price, pix price and struck list price kept apart, instalments, marketplace sellers and every competing offer. It returns live JSON through POST requests under /americanas/v1.
Is the Americanas API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Americanas calls use the same shared credit balance as every other ReefAPI engine.
Do I need an Americanas login or account?▾
No login to Americanas 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 Americanas 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 Americanas API use?▾
Americanas actions currently cost 1-5 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Americanas from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call americanas actions with the same key, credit pool and JSON envelope used by normal REST requests.
116 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Americanas, 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 279 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-23.