Lider APIlider.cl ↗
Search and browse Lider Supermercado's catalog via API. Get product names, brands, prices, category hierarchy, and stock status from Chile's major supermarket chain.
What is the Lider API?
The Lider.cl API gives programmatic access to Lider Supermercado's product catalog across 2 endpoints, returning fields like product name, brand, price, category path, and stock status. The search_products endpoint accepts a free-text query and returns paginated results with up to ~50 products per page. The browse_category endpoint lets you iterate an entire category by its numeric path ID, with both endpoints sharing the same product object structure.
curl -X GET 'https://api.parse.bot/scraper/69114a03-9d55-466d-9bf1-b0b89ffdac10/search_products?page=1&sort=best_match&query=leche' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace lider-cl-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Lider Supermercado SDK — bounded, re-runnable; every call capped."""
from parse_apis.lider_cl_api import Lider, Sort, ParseError
client = Lider()
# Search for products by keyword, sorted by lowest price
for product in client.products.search(query="leche", sort=Sort.PRICE_LOW, limit=3):
print(product.name, product.brand, product.price, product.category)
# Browse a specific category (Leche under Lácteos)
item = client.products.browse(category_id="45669105_39354732", limit=1).first()
if item:
print(item.name, item.price, item.in_stock)
# Handle errors on a bad category
try:
for p in client.products.browse(category_id="99999999", limit=1):
print(p.name)
except ParseError as e:
print("error:", e)
print("exercised: products.search, products.browse")
Full-text search across all supermarket products. Returns paginated results with product name, brand, price, category hierarchy, and stock status. Results are auto-iterated across pages; each page contains up to ~50 products.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| sort | string | Sort order for results. |
| queryrequired | string | Search term (e.g. 'leche', 'arroz', 'detergente'). |
{
"type": "object",
"fields": {
"page": "current page number",
"max_page": "maximum page number available",
"products": "array of product objects with id, name, brand, price, category, etc.",
"total_count": "total number of matching products"
},
"sample": {
"data": {
"page": 1,
"max_page": 14,
"products": [
{
"id": "00780292001160",
"url": "https://super.lider.cl/ip/leche/00780292001160",
"name": "Leche Origen Chocolate, 200 ml",
"brand": "Colun",
"price": "$560",
"category": "Lácteos, Fiambrería y Huevos > Leche > Saborizadas",
"in_stock": true,
"image_url": "https://i5.walmartimages.cl/asr/f9cb1a6b-3471-4e1b-b547-0423e494732d.jpeg",
"unit_price": "$2.800 x lt",
"original_price": "$610"
}
],
"total_count": 582
},
"status": "success"
}
}About the Lider API
Endpoints and Core Fields
The API exposes two endpoints: search_products and browse_category. Both return the same product object shape, including id, name, brand, price, category, and stock status. Pagination is consistent across both: responses include page (current page), max_page (last available page), total_count (total matching records), and the products array. Each page carries up to approximately 50 product records.
Searching Products
search_products requires a query string — any Spanish-language term like leche, arroz, or detergente works. An optional sort parameter controls result ordering, and an optional page integer (1-based) controls which page of results to retrieve. total_count lets you calculate how many pages to request when iterating a full result set using max_page.
Browsing by Category
browse_category requires a category_id — an underscore-separated numeric path such as 45669105_39354732. These IDs come from the category field returned in product objects from either endpoint, so you can discover valid category paths by running a search first. The same page and sort parameters apply, and the response structure is identical to search results. This makes it straightforward to enumerate all products within a given department like Lácteos or Bebidas.
Coverage and Freshness
The API covers Lider's online supermarket catalog for Chile. Prices and stock status reflect the current state of the Lider.cl storefront. The category hierarchy is multi-level, encoded as numeric segment paths, so drilling into subcategories requires combining parent and child IDs.
The Lider API is a managed, monitored endpoint for lider.cl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when lider.cl changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official lider.cl API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track price changes for specific products like cooking oil or milk across Lider's catalog over time.
- Build a grocery price comparison tool by querying the same product term across multiple Chilean supermarket APIs.
- Enumerate all products in a category using browse_category to feed a product database or feed.
- Monitor stock status fields to alert users when out-of-stock items become available.
- Extract brand and category data to analyze which brands dominate specific Lider product categories.
- Power a Chilean grocery shopping assistant by combining search_products results with category browsing.
- Aggregate total_count data per category to map the relative size of Lider's product assortment by department.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Lider.cl have an official developer API?+
How do I find valid category_id values to use with browse_category?+
category field of product objects returned by search_products. Run a search for a product in the category you want, inspect the category field of any result, and use that underscore-separated numeric string as the category_id parameter for browse_category.Does the API return product images or nutritional information?+
Is the API limited to a specific region within Chile?+
What does the sort parameter accept for both endpoints?+
sort parameter is optional and controls result ordering, but the accepted sort values are determined by what Lider's catalog supports (such as price ascending/descending or relevance). If an unsupported value is passed, results will typically fall back to default ordering.