# Lider API — Walmart Chile supermarket and catálogo: shelf prices in CLP, Rebaja and multi-buy deals, unit price, price per kg, stock, brand, seller, full product data

> Search Lider.cl (Walmart Chile): the supermarket (super.lider.cl) or the general catálogo (www.lider.cl, with Marketplace sellers). One page of ~44 products: item_id, name, brand, price in CLP, crossed-out price + saving on a Rebaja, multi-buy deal ('Combina 2 x $3.000'), unit price ($/lt, $/kg, $/un), price per kg for loose produce, stock state, seller, category path, rating, sponsored flag — plus the source's own filter values with counts (brands, categories, campaigns, seals, seller types, price range). Filters: brand, category, campaign, seal, seller_type, min_price, max_price; sort; page. Prices are the site's default store (Vitacura, Santiago). `query` is required.
> ReefAPI engine `lider` · 2 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/lider/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free except verified SHEIN NOT_FOUND on product/detail and price (4 credits).
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Send the key as `Authorization: Bearer <key>`, or put it in the URL (`?key=<key>`) when the client has no header field, as ChatGPT does.

## Endpoints

### POST https://api.reefapi.com/lider/v1/search — 3 credits
Search Lider.cl (Walmart Chile): the supermarket (super.lider.cl) or the general catálogo (www.lider.cl, with Marketplace sellers). One page of ~44 products: item_id, name, brand, price in CLP, crossed-out price + saving on a Rebaja, multi-buy deal ('Combina 2 x $3.000'), unit price ($/lt, $/kg, $/un), price per kg for loose produce, stock state, seller, category path, rating, sponsored flag — plus the source's own filter values with counts (brands, categories, campaigns, seals, seller types, price range). Filters: brand, category, campaign, seal, seller_type, min_price, max_price; sort; page. Prices are the site's default store (Vitacura, Santiago). `query` is required.

**Parameters:**
- `query` (string, required) — What to search for, as typed in the Lider search box (Spanish: leche, arroz, cerveza, televisor).
- `store` (enum, optional, default "supermercado") — Which Lider catalogue: `supermercado` (super.lider.cl, groceries) or `catalogo` (www.lider.cl: electronics, home, toys, incl. Marketplace sellers). They are different catalogues (televisor: 47 vs 6,511 results). [one of: supermercado, catalogo]
- `page` (integer, optional, default 1) — Result page (~44 products each). `max_page` in the answer is the source's last page; deep paging stops near 1,000 results even when the total is larger.
- `sort` (enum, optional, default "best_match") — Order of the results. [one of: best_match, price_low, price_high]
- `brand` (string, optional) — Only this brand, spelled exactly as in `facets.brands` (case-sensitive at the source: 'Soprole' 60 milk products, 'soprole' none). One brand per call.
- `category` (string, optional) — Only this department, spelled exactly as in `facets.categories`.
- `campaign` (string, optional) — Only products in this campaign, spelled exactly as in `facets.campaigns` (e.g. 'Precio Lider').
- `seal` (string, optional) — Chilean front-of-pack warning seals, exactly as in `facets.seals` (e.g. 'alto en azúcares'). Supermarket.
- `seller_type` (enum, optional) — Catálogo only: sold by Lider itself or by a Marketplace seller (televisor: Lider 451, Marketplace 6,006). [one of: lider, marketplace, marketplace_fast]
- `min_price` (integer, optional) — Lowest price in CLP (whole pesos, e.g. 1000).
- `max_price` (integer, optional) — Highest price in CLP (whole pesos, e.g. 2000).

**Returns:** store, store_id, total (the source's count), page, max_page, beyond_last_page, returned, sponsored_count, results[]{item_id, name, brand, url, store, price, price_display, list_price, savings_amount, savings_display, on_sale, multibuy{quantity, total, per_unit, mix_and_match, text}, unit_price{amount, unit, display}, unit_price_display, sold_by_weight, price_per, weight_increment_kg, currency, badges[], availability, in_stock, seller, seller_id, seller_type, category, category_path[], image, rating, review_count, sponsored, rank}, facets{brands[], categories[], campaigns[], seals[], seller_types[], price_min, price_max}

**Example request body:**
```json
{
  "query": "leche"
}
```

### POST https://api.reefapi.com/lider/v1/product — 3 credits
One Lider.cl product by item_id (as search rows return it) or product URL: everything in a search row plus UPC, all images, short and long description, the specification table (ingredients, net content, country of origin, food-condition tags, presentation, ...), nutrition rows, order limits, seller and offer type (1P Lider / 3P Marketplace), pickup / delivery labels and the page's own ld+json price as a second witness (`price_mismatch`). `item_id` or `url` is required.

**Parameters:**
- `item_id` (string, optional) — The 14-digit item_id exactly as a search row returns it (00780290000130).
- `url` (string, optional) — A super.lider.cl or www.lider.cl product URL (/ip/...).
- `store` (enum, optional) — Which catalogue to price the product in. Omitted: supermercado, then catálogo if the supermarket does not sell it (a product URL picks its own host). [one of: supermercado, catalogo]

**Returns:** item{item_id, upc, name, brand, url, store, offered, price, price_display, list_price, savings_amount, savings_display, on_sale, multibuy{}, unit_price{}, unit_price_display, sold_by_weight, price_per, weight_increment_kg, currency, badges[], availability, in_stock, order_limit, order_min, seller, seller_id, seller_type, offer_type, category, category_path[]{name, url}, images[], rating, review_count, short_description, description, specifications[]{name, value}, nutrition[]{name, amount, standard_serving_amount, daily_value_pct}, fulfillment[]{method, message, location}, ld_json{price, availability, brand}, price_mismatch}

**Example request body:**
```json
{
  "item_id": "00780290000130"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=lider
- Human docs page: https://reefapi.com/docs/lider
- Overview page: https://reefapi.com/lider-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt