la comer.com.mx APIla comer.com.mx ↗
Access La Comer Mexico's product catalog, store list, category hierarchy, pricing, and nutrition data via 4 structured API endpoints.
What is the la comer.com.mx API?
The La Comer Mexico API covers 4 endpoints for searching and browsing the full La Comer grocery catalog, including store-level pricing, department hierarchies, and individual product detail pages. The get_product_detail endpoint returns EAN-level data including nutrition info, technical specs, and multiple image URLs, while search_products lets you query by keyword across any store with paginated results.
curl -X GET 'https://api.parse.bot/scraper/e4a6d721-8255-4962-87ed-68e0e784ff04/get_departments_and_stores?store_id=287' \ -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 la-comer-com-mx-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.
from parse_apis.la_comer_mexico_product_api import LaComer, Product, ProductSummary, CategoryProduct, Catalog
client = LaComer()
# Fetch the store catalog (departments + stores)
catalog = client.catalogs.get(store_id="287")
for dept in catalog.departments:
print(dept.description, dept.article_count)
# Search products by keyword with automatic pagination
for product in client.products.search(query="leche", store_id="287", limit=5):
print(product.ean, product.name, product.brand, product.sale_price)
# Navigate from search result to full detail
first_result = list(client.products.search(query="pan", limit=1))[0]
detail = first_result.details()
print(detail.name, detail.brand, detail.sale_price, detail.in_stock)
for spec in detail.specs:
print(spec.concept, spec.value)
# Browse products by category
for item in client.products.by_category(dept_id="57", subcat_id="59", limit=10):
print(item.ean, item.name, item.brand, item.sale_price, item.in_stock)
Fetch the complete department/aisle hierarchy and the list of available stores. Departments contain nested subcategories (subagrupaciones) with article counts. Use store IDs and subcategory IDs from this response in other endpoints. A single round-trip returns the full tree for one store context.
| Param | Type | Description |
|---|---|---|
| store_id | string | ID of the store to fetch context for. |
{
"type": "object",
"fields": {
"stores": "array of Store objects with id, sucursal, key, keyText, cerrada",
"departments": "array of Department objects with nested subcategories"
},
"sample": {
"data": {
"stores": [
{
"id": 408,
"key": 200,
"cerrada": 0,
"keyText": "Market",
"sucursal": "City Market Antea Qro"
}
],
"departments": [
{
"id": 57,
"raiz": true,
"final": false,
"orden": 1,
"virtual": false,
"descripcion": "Despensa",
"conteoArticulos": 0,
"subagrupaciones": [
{
"id": 72,
"raiz": false,
"final": true,
"orden": 1,
"virtual": false,
"descripcion": "Salsas chiles y moles",
"conteoArticulos": 487,
"idAgrupacionPadre": 57
}
]
}
]
},
"status": "success"
}
}About the la comer.com.mx API
Store and Category Discovery
Start with get_departments_and_stores to retrieve the full list of available La Comer store locations — each with a sucursal name, id, key, and keyText — alongside the complete department and subcategory hierarchy. Departments include nested subagrupaciones arrays with article counts, giving you the padreId values needed to query any leaf category. Pass an optional store_id to scope the response to a specific branch.
Product Search and Category Browsing
search_products accepts a required query string (e.g., 'leche' or 'pan') and returns up to 20 products per page, with total and numpages fields for pagination. Each result object includes artEan, artDes (description), artPrven (price), marDes (brand), and inveCant (inventory count). For structured catalog browsing, get_products_by_category takes a dept_id and a leaf subcat_id from the hierarchy and returns vecArticulo product arrays along with noHojas for page count. This endpoint also surfaces promotional metadata such as clearance status and original pre-discount price.
Product Detail
get_product_detail takes a single EAN barcode string (e.g., '7501639313538') and an optional store_id. It returns an estrucArti object with full pricing, textual description, fichaTecnica (technical/nutrition data), and availability status. The estrucArtiImg field is a dictionary of image URLs keyed by size identifier, useful for building product displays or data pipelines that require visual assets.
The la comer.com.mx API is a managed, monitored endpoint for la comer.com.mx — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when la comer.com.mx 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 la comer.com.mx 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 across multiple La Comer store locations using
get_product_detailwith differentstore_idvalues. - Build a grocery comparison tool by pulling
artPrvenandmarDesfields fromsearch_productsresults for competing brands. - Extract nutrition and ingredient data from
fichaTecnicainget_product_detailfor dietary or health-focused applications. - Map the full La Comer category tree from
get_departments_and_storesto index all subcategories and their article counts. - Monitor clearance and promotional pricing using the promotional metadata returned by
get_products_by_category. - Collect product image assets at multiple sizes via
estrucArtiImgfor catalog digitization or price comparison UIs. - Build store-specific inventory snapshots using
inveCantfromsearch_productsacross known store IDs.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does La Comer have an official public developer API?+
How does pagination work in `search_products` and `get_products_by_category`?+
search_products returns 20 products per page and includes total (total matching products) and numpages (total pages) so you can iterate through results. get_products_by_category returns a noHojas field for the total page count; pass an incrementing page integer to walk through all products in a subcategory.Does the API return customer reviews or ratings for products?+
Are all La Comer store locations covered, or only certain regions?+
get_departments_and_stores endpoint returns whatever store list La Comer exposes through its catalog system. Coverage reflects La Comer's own store network, which operates primarily in Mexico City, Estado de Mexico, and select other states. Stores outside that network, or any affiliated banners not served by the same catalog, will not appear in results.