Lider shelf prices, deals and product data for Chile, from the supermarket and the general store
Lider is Walmart's chain in Chile, and its website has two catalogues: the supermarket (super.lider.cl) and the general store (www.lider.cl, electronics, home and toys, with Marketplace sellers).
2 active endpoints. Every call is 3 credits.
- POST/lider/v1/search
- POST/lider/v1/product
What Lider endpoints does ReefAPI ship?
2 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Lider API
4 of 2 endpoints, ready to run
Milk prices in the Lider supermarket
// 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 Lider API works
Lider 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 491 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.
From a search to a priced product sheet
Search a catalogue, narrow it with Lider's own filter values, then read the products that matter in full.
About 44 products with price, Rebaja saving, multi-buy deal, unit price and stock, plus Lider's total and its filter values (brands, categories, campaigns, seals) with counts.
The same search narrowed with a value copied from facets, cheapest first.
UPC, all images, description, specification table, nutrition rows and the pickup and delivery labels.
A dated feed of Lider prices, savings and multi-buy deals in CLP, with the product facts behind each item.
curl -X POST https://api.reefapi.com/lider/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"leche"}'{
"ok": true,
"data": { … },
"meta": {
"api": "lider",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Lider field actually contains
Fields that read differently from how they look. Every row was measured against live Lider pages on 2026-10-14.
| Field | What it holds |
|---|---|
| price, price_display | The shelf price in Chilean pesos as a whole number, and Lider's own text. Lider writes thousands with a dot and no decimals: "$1.299.990" is 1,299,990 CLP. On 51 products the price matched the price Lider renders on the product card 51 times. |
| list_price, savings_amount | The crossed-out price and Lider's own saving on a Rebaja ("Costaba $1.190", "Ahorra $100"). list_price minus price equals the saving. Matched the rendered card on 51 of 51 products. |
| multibuy | Deals that need several units: quantity, total, per_unit and the label. "Combina 2 x $3.000" means two units for 3,000 CLP, mixable across the products carrying the same label (mix_and_match true). Found on 53 of 453 supermarket rows, 29 of 48 on a cookie search. |
| unit_price, unit_price_display | Lider's price per litre, kilo, unit or 10 g, exactly as Lider prints it. Lider's own figure is occasionally wrong ("$99 x lt" on a 1 L carton costing $1.190); it is returned as printed, not corrected. |
| sold_by_weight, price_per, weight_increment_kg | Loose produce and bakery sold by weight: price is per kilo ("$1.990/kg") and weight_increment_kg is the step a shopper adds (0.5). 23 of 453 supermarket rows. |
| store, item_id | The catalogue the row comes from and Lider's 14-digit product id. The supermarket and the general store are different catalogues; pass both to product to stay in the same one. |
| seller, seller_type | Lider itself (INTERNAL) or the Marketplace seller's shop name (EXTERNAL, for example LG Electronics) in the general store. In product, offer_type is 1P or 3P. |
| total, max_page | Lider's own count of matches and its last page. Pages stop near 1,000 results even when the count is larger (televisor: 6,514 matches, 23 pages). |
Prices are the ones Lider shows a visitor who has not picked a store: the site's default store in Santiago (Vitacura) for the supermarket. Read from a Chilean connection and from abroad in the same minutes, 248 products gave identical prices and stock.
Lider coverage, measured
Every number below was read from live Lider responses on 2026-10-14, in two consecutive runs of 63 calls each.
The supermarket (super.lider.cl) and the general store (www.lider.cl, with Marketplace sellers), chosen per call.
"leche" 575 → brand Soprole 60, campaign Precio Lider 125, category Lácteos 340, seal "alto en azúcares" 33, 1,000-2,000 CLP 165. "televisor" 6,514 → sold by Lider 451, Marketplace 6,009, Samsung 80.
On 675 search rows across 15 searches: id, name, brand, price, stock state, seller, category and image 675/675; unit price 382 of 453 supermarket rows; multi-buy deal 53; sold by weight 23; rating on 110 of 222 general-store rows.
Price, crossed-out price and multi-buy label matched Lider's rendered product card on 51 of 51 products; search and product agreed on price for 44 of 44 products.
44 of 44 ids taken from search rows opened in product with the same id and price.
Prices are the site's default store in Santiago; no comuna or store choice yet; no Lider BCI card price; stock is a state, not a count; pages stop near 1,000 results.
What people build with Lider
The jobs this data is most often used for.
endpoints
credits per call
Track Lider shelf prices, Rebaja savings and multi-buy deals for a basket of grocery products every day.
Compare price per litre or per kilo across brands in one Lider search.
Monitor which products carry the Precio Lider campaign or a Chilean warning seal.
Follow Marketplace sellers and their prices on Lider's electronics and home catalogue.
What Lider data costs
The cheapest call here is 3 credits, so $15/mo (Pro) buys 3,333 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 491 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/lider/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"leche"}'import requests
r = requests.post(
"https://api.reefapi.com/lider/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "leche"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Lider.
Get a free key →Do I need a Lider account or a Lider BCI card?▾
No. Everything is read logged out. The Tarjeta Lider BCI discount is applied in Lider's cart, not on product pages, so it is not part of the data.
Supermarket or general store?▾
Both. Pass store=supermercado (default) or store=catalogo. They are separate catalogues: "televisor" matched 47 products in the supermarket and 6,514 in the general store on 2026-10-14.
Which filters are there?▾
brand, category, campaign, seal, seller_type, min_price and max_price, each checked against the unfiltered count in the same run: "leche" 575, brand Soprole 60, campaign Precio Lider 125, category Lácteos 340, seal "alto en azúcares" 33, price 1,000-2,000 CLP 165. Values are exact and case-sensitive; copy them from facets in any search answer.
Can I sort and page?▾
Yes: sort by relevance, price low to high or high to low, and page through about 44 products per page. max_page tells you the last page; asking for a page past it returns no rows and beyond_last_page true.
Can I choose a comuna or a store?▾
Not yet. Prices are the site's default store in Santiago, which is what a visitor sees before choosing a delivery address. The answer names the store it priced.
Do you return stock counts?▾
Lider publishes a stock state (IN_STOCK or OUT_OF_STOCK), not a count, and that is what is returned. Out-of-stock products stay in the results.
How fresh is the data?▾
Every call reads Lider live; nothing is cached. In two runs a search took 2.6 seconds at the median and a product 2.6 to 2.7 seconds.
Are sponsored products marked?▾
Yes. sponsored is true on paid placements Lider mixes into results (0 to 6 per page in our runs), and sponsored_count gives the total per page.
What is the Lider API?▾
Lider API is a ReefAPI endpoint group for walmart chile's supermarket and general store: clp shelf prices, rebaja and multi-buy deals, unit price and full product data. It returns live JSON through POST requests under /lider/v1.
Is the Lider API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Lider calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Lider login or account?▾
No login to Lider 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 Lider 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 Lider API use?▾
Lider actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Lider from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call lider actions with the same key, credit pool and JSON envelope used by normal REST requests.
231 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Lider, 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 490 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-10-14.