# Chedraui Mexico Products API

> Chedraui Mexico: supermarket products with prices, promotions, stock and EAN, by search or category

- Vendor: `chedrauimexicoproductsapi` · version 1.0 · category Food · tags chedraui api, mexico grocery prices api, supermarket products api, mexico supermarket api, vtex catalog api, grocery catalogue api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/chedrauimexicoproductsapi
- This document: https://apiclay.com/docs/chedrauimexicoproductsapi.md
- OpenAPI 3.1: https://apiclay.com/api/chedrauimexicoproductsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `chedrauimexicoproductsapi`
- Updated: 2026-11-18

## About

## Chedraui Mexico Products API

The product catalogue behind chedraui.com.mx, one of Mexico's largest supermarket chains: products by keyword or category, each with name, brand, categories, description, EAN barcodes, images, the selling price and list price in pesos, the promotion text, available quantity and maximum per order; and the full category tree with ids and URLs.

Data comes from **chedraui.com.mx** (https://www.chedraui.com.mx). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/categories?levels=3` for category ids, then `/products?ft=leche&amp;_from=0&amp;_to=9` or `/products?fq=C:/1/105/&amp;_from=0&amp;_to=9` for a category.

### Routes

#### GET `/products` - Products
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| ft | query | string | no | Keyword, e.g. `leche`. |
| fq | query | string | no | Filter, e.g. `C:/1/105/` (category path from `/categories`) or `B:813` (brand id). |
| _from | query | number | no | First product index, from 0. |
| _to | query | number | no | Last product index; at most 49 more than `_from`. |
| O | query | string | no | Sort: `OrderByPriceASC`, `OrderByPriceDESC`, `OrderByTopSaleDESC`, `OrderByNameASC`. |

Returns: Array of products: `productId`, `productName`, `brand`, `categories`, `description`, `link`, and `items` with `ean`, `images` and `sellers[].commertialOffer` (`Price`, `ListPrice`, `AvailableQuantity`, `DiscountHighLight`). About 15 KB per product.

#### GET `/categories` - Categories
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| levels | path | number | yes | Depth of the tree, 1 to 3. |

Returns: Array of departments with `id`, `name`, `url` and nested `children`.

### Caveats

- Prices are in Mexican pesos for the default online store and can differ in branches; promotions change weekly.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by chedraui.com.mx.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /products — Products
- Gateway: `GET https://api.apiclay.com/v1/api/chedrauimexicoproductsapi/products`
- Public query params: `ft` (string), `fq` (string), `_from` (number), `_to` (number), `O` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories
- Gateway: `GET https://api.apiclay.com/v1/api/chedrauimexicoproductsapi/categories`
- Public query params: `levels` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/chedrauimexicoproductsapi/products" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
