chedraui.com.mx APIchedraui.com.mx ↗
Access Chedraui Mexico's product catalog, prices, category tree, and trending searches via a structured API with 5 endpoints.
curl -X GET 'https://api.parse.bot/scraper/237e52eb-6169-4c6b-a9a6-553d017ba971/search_products?page=1&limit=20&query=leche' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with pagination. Returns matching products sorted by relevance score.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| limit | integer | Number of products per page. |
| queryrequired | string | Search keyword (e.g. 'leche', 'shampoo'). |
{
"type": "object",
"fields": {
"products": "array of product objects with productId, productName, brand, priceRange, categories, items, images, etc.",
"recordsFiltered": "integer total number of matching products"
},
"sample": {
"data": {
"products": [
{
"brand": "Alpura",
"linkText": "leche-alpura-deslactosada-4-piezas-de-1l-cu-3713406",
"productId": "3713406",
"categories": [
"/Supermercado/Lacteos y huevo/Leche/"
],
"priceRange": {
"sellingPrice": {
"lowPrice": 115,
"highPrice": 115
}
},
"productName": "Leche Alpura Deslactosada 4 Piezas de 1L c/u"
}
],
"recordsFiltered": 1283
},
"status": "success"
}
}About the chedraui.com.mx API
The Chedraui.com.mx API exposes 5 endpoints covering product search, product details, category browsing, the full category tree, and trending searches from Mexico's Chedraui online supermarket. The search_products endpoint returns paginated product arrays including brand, priceRange, SKU-level items, and images — making it straightforward to query live grocery and household product data by keyword.
Search and Product Data
The search_products endpoint accepts a required query string (e.g. 'leche' or 'shampoo') along with optional page and limit integers for pagination. It returns an array of product objects — each with productId, productName, brand, priceRange (containing sellingPrice and listPrice ranges), categories, items, and images — plus a recordsFiltered integer showing the total match count. The get_product_details endpoint takes a product_slug (the linkText value from search results, e.g. 'leche-condensada-nestle-la-lechera-original-375g-3388156') and returns the full record including an HTML description field, SKU-level items with seller and pricing detail, and full categories path strings.
Category Browsing
The list_categories endpoint requires no inputs and returns the complete MEGAMENU category tree: an array of category objects with id, name, slug, order, display flags (desktop, mobile, display), and nested children. Category slugs from this response feed directly into get_category_products, which accepts a category_path string (e.g. 'supermercado/frutas-y-verduras') and returns the same product array shape as search_products, with its own recordsFiltered count for that category.
Trending Searches
The get_top_searches endpoint takes no inputs and returns a searches array of objects, each containing a term field representing currently popular search queries on the site. This is useful for surfacing what shoppers are actively looking for without needing to construct queries yourself.
- Track price changes on specific Chedraui products using
priceRange.sellingPriceandpriceRange.listPricefields over time. - Build a Mexico grocery price comparison tool by querying
search_productsacross multiple supermarket APIs. - Populate a product catalog with Chedraui SKU data including brand, images, and category paths from
get_product_details. - Mirror the Chedraui category hierarchy using
list_categoriesto power navigation or taxonomy mapping. - Identify trending consumer packaged goods in Mexico via
get_top_searchesterm data. - Enumerate all products in a department (e.g.
supermercado/despensa) with paginated calls toget_category_products. - Monitor in-stock SKU availability and seller pricing via the
itemsarray returned in product detail responses.
| 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 | 250 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 Chedraui offer an official developer API?+
What does `get_product_details` return that `search_products` does not?+
get_product_details returns an HTML description field and full SKU-level items objects that include seller information and itemized pricing. Search results provide a summary priceRange and image array but do not include the HTML description or per-seller breakdown.How does pagination work across search and category endpoints?+
search_products and get_category_products accept page and limit integer parameters. The recordsFiltered integer in each response indicates the total match count, so you can calculate how many pages exist for a given query or category path.Does the API return customer reviews or product ratings?+
Are promoted or sponsored products distinguished from organic results in `search_products`?+
search_products response does not include a sponsored or promoted flag — results are returned as a flat array sorted by relevance score. The API covers standard catalog fields such as brand, price, and categories. You can fork it on Parse and revise it to add filtering or labeling logic if that distinction matters for your use case.