Lider APIlider.cl ↗
Search and browse products from Lider Supermercado's catalog to compare prices, explore categories, and check real-time availability across Chile. Get detailed product information including pricing and category organization to help you shop efficiently online or in-store.
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
The Lider API on Parse exposes 2 endpoints for the publicly available data on lider.cl. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.