Americanas API & Scraper
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.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Brazilian retail quotes more than one price for the same product, and this API never merges them: price_brl is the card price (it 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, and list_price_brl is the struck price with discount_pct. On a Samsung Galaxy A07 256GB that reads 943.33, 849.00 (10 percent off) and 1399.00, paid as 8 x 117.91 interest-free. That split matters: on 5 of 10 products checked against Americanas' own product page the card price and the headline price differed by 5 to 11 percent, so storing one number would have been wrong half the time. seller names who is selling, is_americanas separates Americanas' own stock from its marketplace, and offer_count says how many sellers list the item; product/detail returns every competing offer with its own prices, plus the EAN, description, specifications, images, variants with their own ids and the category breadcrumb. seller/products lists a named marketplace seller's whole catalogue, product/batch reads up to 10 products in one call, and filters returns the brands, sellers, price range and per-category attributes Americanas itself offers so you can feed them straight back into search. Verification on 2026-09-23: 20 of 20 searches, 6 of 6 category browses, 24 of 24 product reads, 4 of 4 seller listings and 3 of 3 batch calls succeeded, all 47 controlled checks passed, and on 10 of 10 products the price, SKU and EAN matched Americanas' own product page. Two things this API deliberately does not return, because Americanas does not publish them: customer reviews and ratings (checked on 72 products across six categories, all empty) and a stock count (the source reports the same placeholder number for every product, so only in_stock is returned). No Americanas account needed - one ReefAPI key and the standard { ok, data, meta, error } envelope.
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.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/americanas/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "cafeteira eletrica"
}
}{
"ok": true,
"meta": {
"api": "americanas",
"endpoint": "search",
"mode": "live",
"latency_ms": 1177.4,
"record_count": 20,
"bytes": 888480,
"cache_hit": false,
"upstream_requests": 1,
"charged_credits": 3,
"version": "0.1.0"
},
"data": {
"results": [
{
"product_id": "723966",
"sku_id": "770584",
"title": "Cafeteira Elétrica Mondial Dolce Arome C-30-18X-FB 18 Xícaras 550W Preta",
"brand": "Mondial",
"url": "https://www.americanas.com.br/cafeteira-eletrica-mondial-dolce-arome-black-c-30-18x-fb-3042404708/p",
"image": "https://americanas.vtexassets.com/arquivos/ids/578511/3042404724_1SZ.jpg?v=638848124851200000",
"price_brl": 119.99,
"pix_price_brl": 119.99,
"pix_discount_pct": null,
"list_price_brl": 129.9,
"currency": "BRL",
"discount_pct": 7.63,
"installments": {
"count": 2,
"amount_brl": 59.99,
"total_brl": 119.99,
"interest_free": true,
"label": "American Express 2 vezes sem juros"
},
"seller": {
"id": "1",
"name": "AMERICANAS SA",
"is_americanas": true
},
"in_stock": true,
"offer_count": 2,
"ean": "7899882312911",
"reference": "3042404708",
"category": "Cafeteira elétrica",
"category_path": [
"Eletroportáteis",
"Cafeteira",
"Cafeteira elétrica"
],
"promotions": [],
"marketplace": false
},
{
"product_id": "1819251",
"sku_id": "1937482",
"title": "Cafeteira Elétrica Britânia CP15 15 xícaras Preto Jarra de Vidro Filtro Permanente Mantém Aquecida",
"brand": "Britânia",
"url": "https://www.americanas.com.br/cafeteira-eletrica-britania-cp15-15-xicaras-com-jarra-de-vidro-preto-113106282/p",
"image": "https://americanas.vtexassets.com/arquivos/ids/605195/113106291_1SZ.jpg?v=639106601477470000",
"price_brl": 109.99,
"pix_price_brl": 109.99,
"pix_discount_pct": null,
"list_price_brl": 129.99,
"currency": "BRL",
"discount_pct": 15.39,
"installments": {
"count": 2,
"amount_brl": 54.99,
"total_brl": 109.99,
"interest_free": true,
"label": "American Express 2 vezes sem juros"
},
"seller": {
"id": "1",
"name": "AMERICANAS SA",
"is_americanas": true
},
"in_stock": true,
"offer_count": 2,
"ean": "7891356048098",
"reference": "113106282",
"category": "Cafeteira elétrica",
"category_path": [
"Eletroportáteis",
"Cafeteira",
"Cafeteira elétrica"
],
"promotions": [],
"marketplace": false
},
{
"product_id": "6414261",
"sku_id": "6915171",
"title": "Cafeteira Elétrica Philco 720ml 650W Preto Inox Base Aquecedora Filtro Permanente Corta-Pingos",
"brand": "Philco",
"url": "https://www.americanas.com.br/cafeteira-eletrica-philco-20-xicaras-720ml-pcf20-110v-7510900393/p",
"image": "https://americanas.vtexassets.com/arquivos/ids/35951267/7510900394_1SZ.jpg?v=638920096877130000",
"price_brl": 139.99,
"pix_price_brl": 139.99,
"pix_discount_pct": null,
"list_price_brl": null,
"currency": "BRL",
"discount_pct": null,
"installments": {
"count": 2,
"amount_brl": 69.99,
"total_brl": 139.99,
"interest_free": true,
"label": "American Express 2 vezes sem juros"
},
"seller": {
"id": "1",
"name": "AMERICANAS SA",
"is_americanas": true
},
"in_stock": true,
"offer_count": 2,
"ean": "7891356116261",
"reference": "7510900393",
"category": "Cafeteira elétrica",
"category_path": [
"Eletroportáteis",
"Cafeteira",
"Cafeteira elétrica"
],
"promotions": [],
"marketplace": false
}
],
"count": 20,
"total_results": 213,
"page": 1,
"page_size": 20,
"has_more": true,
"stop_reason": null,
"max_reachable_results": 213,
"unparsable_rows_dropped": 0,
"sort": "relevance",
"applied_filters": {},
"country": "br",
"currency": "BRL",
"query": "cafeteira eletrica"
}
}What the Americanas API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Americanas by keyword. Every product comes with the card price, the PIX price and its discount, the struck list price, the best interest-free instalment plan, the seller (Americanas itself or a marketplace seller), how many sellers offer it, availability, EAN and category. Sort by price, best sellers, newest, discount or name; filter by brand, seller, price range, category path or any facet the site publishes. | Pricing teams call search to search Americanas by keyword. | query, country, page, page_size, sort, ... |
| category | Every product in an Americanas category, by category path or category URL, paged, with the same rows, sorts and filters as search. | Marketplace operators call category to get every product in an Americanas category, by category path or category URL, paged, with the sa…. | category, country, page, page_size, sort, ... |
| seller/products | Everything a named Americanas marketplace seller lists, paged, with the same rows, sorts and filters as search. Seller names come from the `filters` action's sellername facet. | Catalog enrichment teams call seller/products to get everything a named Americanas marketplace seller lists, paged, with the same rows, sorts and…. | seller, country, query, page, page_size, ... |
| product/detail | The full Americanas product record by id or URL: title, brand, EAN, reference, the card price, the PIX price and its discount, the struck list price, the best interest-free instalment plan, the seller, EVERY competing seller offer with its own prices, availability, description, specifications, images, variants with their own ids and prices, category breadcrumb and release date. | Retail analysts call product/detail to get the full Americanas product record by id or URL. | product_id, country, max_rotations |
| product/batch | Up to 10 Americanas products in one call, each the same full record as product/detail. Ids that do not resolve are reported in not_found[] instead of failing the whole call. | Pricing teams call product/batch to get up to 10 Americanas products in one call, each the same full record as product/detail. | product_ids, country, max_rotations |
| filters | The filters Americanas itself offers for a keyword or a category — brands, sellers, price range, category tree and the per-category attributes (size, colour, gender…). Feed any of them back into search as `facets`. | Marketplace operators call filters to get the filters Americanas itself offers for a keyword or a category. | query, category, country, max_rotations |
| search/suggest | Americanas' own search-box completions for what a shopper has typed, with how often each term is searched and the department it belongs to. | Catalog enrichment teams call search/suggest to get americanas' own search-box completions for what a shopper has typed, with how often each term…. | query, country, max_rotations |
Call search from your stack
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"])const res = await fetch("https://api.reefapi.com/americanas/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "cafeteira eletrica"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.americanas.search with {"query":"cafeteira eletrica"}.Who uses this API and why
- 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.
- Discover a category's real filter vocabulary with the filters action - brands, sellers, price range and per-category attributes such as size and gender - then drill into it with search.
Questions developers ask before integrating
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.