# Chedraui Mexico Grocery Price Scraper (`scrapers_lat/chedraui-scraper`) Actor

Scrape Chedraui product prices from Mexico's supermarket catalog. Extract name, brand, price and list price in MXN, EAN barcode, stock, seller and installment plans by keyword or category. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/scrapers\_lat/chedraui-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** E-commerce, Automation, Business
- **Stats:** 7 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 4.69 out of 5 stars

## Pricing

from $6.15 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![Chedraui Mexico Grocery Price Scraper](https://scrapers.lat/banners/chedraui-scraper.png)](https://console.apify.com/actors/mlNThX5bU2X8SCWJZ/input)

## Chedraui Mexico Grocery Price Scraper

Here is one real result, with every field the actor returns (the `installmentsTable` array is trimmed for length; the values shown are real):

```json
{
  "imageUrl": "https://chedrauimx.vteximg.com.br/arquivos/ids/75312012/7501639313538_00.jpg?v=639222424308270000",
  "images": [
    "https://chedrauimx.vteximg.com.br/arquivos/ids/75312012/7501639313538_00.jpg?v=639222424308270000",
    "https://chedrauimx.vteximg.com.br/arquivos/ids/75312013/7501639313538_01.jpg?v=639222424309200000"
  ],
  "releaseDate": "2025-04-10T00:00:00Z",
  "productReference": "3855683",
  "installmentsTable": [
    {"number": 1, "value": 25.5, "interestRate": 0, "total": 25.5, "paymentName": "American Express à vista"},
    {"number": 1, "value": 25.5, "interestRate": 0, "total": 25.5, "paymentName": "Visa à vista"}
  ],
  "priceValidUntil": "2027-08-14T00:00:00Z",
  "promoTeasers": null,
  "measurementUnit": "un",
  "unitMultiplier": 1,
  "name": "Leche Bové Leche con Café Orgánica 330ml",
  "url": "https://www.chedraui.com.mx/leche-bove-leche-con-cafe-organica-330ml-3855683/p",
  "productId": "3855683",
  "sku": "3855683",
  "ean": "7501639313538",
  "referenceId": "3855683",
  "brand": "Bové",
  "categories": ["Supermercado > Lacteos y huevo > Leche", "Supermercado > Lacteos y huevo", "Supermercado"],
  "price": 25.5,
  "listPrice": 30,
  "priceWithoutDiscount": 30,
  "sellingPrice": 25.5,
  "currency": "MXN",
  "installments": {"number": 1, "value": 25.5, "interestRate": 0, "interestFree": true, "total": 25.5},
  "availableQuantity": 99999,
  "isAvailable": true,
  "sellerName": "Chedraui",
  "sellerId": "1",
  "isMarketplace": false,
  "description": "La combinación perfecta de leche orgánica y café. Las imágenes del producto son únicamente de referencia, el diseño de etiquetas y el contenido (ml, L, Kg, g, piezas, etc) pueden cambiar y/o variar sin previo aviso.",
  "specifications": {
    "Contenido del empaque": "1 pz de 330ml",
    "Benefits 3": "Hecho con ingredientes orgánicos de alta calidad.",
    "Máximo de venta": "12",
    "MultiEan": "7501639313538"
  },
  "aiDescriptionEn": "Bové Organic Milk with Coffee is a perfect blend of high-quality organic milk and coffee, packaged in a convenient 330ml container.",
  "aiSourceLanguage": "Spanish",
  "aiAttributes": {
    "productType": "Leche con Café",
    "sizeOrWeight": "330ml",
    "flavorOrVariant": "",
    "packCount": "1",
    "dietary": ["Orgánico"],
    "keyFeatures": ["Hecho con ingredientes orgánicos de alta calidad."]
  },
  "observedAt": "2026-08-14T07:20:18.946Z",
  "error": null
}
```

The most complete Chedraui Mexico grocery scraper available. It returns every field the Chedraui VTEX catalog exposes for each product offer, including price, list price, discount, EAN, brand, categories, installment plans, seller and stock, plus optional AI-cleaned English descriptions and structured attributes, and gives you full-text search, category and sort filters to target exactly the products you need.

**📥 [Input](https://apify.com/scrapers_lat/chedraui-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/chedraui-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/chedraui-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/chedraui-scraper/examples)**

![Apify](https://img.shields.io/badge/Platform-Apify-1CE1CE?logo=apify\&logoColor=white)
![Coverage](https://img.shields.io/badge/Coverage-Mexico-blue)
![Output](https://img.shields.io/badge/Output-JSON%20%7C%20CSV%20%7C%20Excel-orange)
![Billing](https://img.shields.io/badge/Billing-Pay%20per%20result-brightgreen)

### Table of contents

- [What it does](#what-it-does)
- [Quickstart](#quickstart)
- [Input reference](#input-reference)
- [Output reference](#output-reference)
- [Example output record](#example-output-record)
- [Run via API and CLI](#run-via-api-and-cli)
- [Fetch results](#fetch-results)
- [Billing and limits](#billing-and-limits)
- [FAQ and troubleshooting](#faq-and-troubleshooting)

### What it does

The actor searches the Chedraui Mexico online catalog for each term or category you pass, paginates through the matching products, and writes one normalized record per available SKU and seller to the run's dataset. Each record carries the product name and URL, product ID, SKU, EAN, brand, category path, current price, list price and price without discount, currency, installment plans, available quantity and stock flag, seller name and ID, marketplace flag, and (when `withDetails` is on) the product description and specification attributes. Missing source values are returned as `null`.

Optional AI add-ons (paid Apify plans only) add a cleaned English product description with detected source language, and a set of structured attributes (product type, size/weight, variant, pack count, dietary flags, key features).

### Quickstart

Open the actor, paste this into the input, and press Run. It returns 3 milk products with details and AI enrichment enabled.

```json
{
  "searchTerms": ["leche"],
  "maxProducts": 3,
  "withDetails": true,
  "withAiDescription": true,
  "withAiAttributes": true
}
```

Provide at least one search term or one category (you can combine both). Every filter is otherwise optional. AI add-ons are off by default and require a paid plan.

### Input reference

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `searchTerms` | string\[] | conditional | `["coca cola"]` | Full-text queries against the Chedraui catalog, for example `coca cola`, `leche`, `pañales`. Each term is searched separately. |
| `categories` | string\[] | conditional | (none) | Restrict to one or more Chedraui categories, by numeric VTEX category id or path (for example `Supermercado/Bebidas`). Provide at least one search term or one category. |
| `maxProducts` | integer | no | `10` | Maximum number of product offers to collect across all terms and categories. Each available SKU and seller is one record. |
| `withDetails` | boolean | no | `true` | When on, each record also includes the product description and specification attributes from the catalog. |
| `sortOrder` | enum | no | (relevance) | Catalog order. One of `OrderByPriceASC`, `OrderByPriceDESC`, `OrderByTopSaleDESC`, `OrderByNameASC`, `OrderByNameDESC`, `OrderByReleaseDateDESC`, `OrderByBestDiscountDESC`. Empty keeps relevance order. |
| `withAiDescription` | boolean | no | `false` | Paid add-on. Generate a clean English description (cleans and translates the Spanish listing). Requires a paid plan. Billed only when a description is produced. |
| `withAiAttributes` | boolean | no | `false` | Paid add-on. Extract structured attributes (type, size/weight, variant, pack count, dietary, features). Requires a paid plan. Billed only when attributes are produced. |

### Output reference

One dataset item per product offer. Types: `string`, `integer`, `number`, `boolean`, `string[]`, `object[]`, `object`, or `null` when the source value is absent.

| Field | Type | Description |
|---|---|---|
| `imageUrl` | string | Primary product image URL. |
| `images` | string\[] | All product image URLs. |
| `releaseDate` | string | Product release date (ISO 8601). |
| `productReference` | string | VTEX product reference code. |
| `installmentsTable` | object\[] | Full installment plans by payment method (number, value, interest rate, total, payment name). |
| `priceValidUntil` | string | Date the current price is valid until (ISO 8601). |
| `promoTeasers` | string\[] | Active promotion teasers, or `null` if none. |
| `measurementUnit` | string | Sale unit, for example `un`. |
| `unitMultiplier` | number | Unit multiplier for the price. |
| `name` | string | Product name. |
| `url` | string | Product page URL on chedraui.com.mx. |
| `productId` | string | Chedraui product ID. |
| `sku` | string | SKU identifier. |
| `ean` | string | EAN barcode. |
| `referenceId` | string | Reference ID. |
| `brand` | string | Brand name. |
| `categories` | string\[] | Category paths the product belongs to. |
| `price` | number | Current price. |
| `listPrice` | number | List price. |
| `priceWithoutDiscount` | number | Price before discount. |
| `sellingPrice` | number | Selling price. |
| `currency` | string | Currency code, for example `MXN`. |
| `installments` | object | Best available installment plan (number, value, interest rate, interest free flag, total). |
| `availableQuantity` | integer | Quantity available. |
| `isAvailable` | boolean | `true` when the product is in stock. |
| `sellerName` | string | Seller name. |
| `sellerId` | string | Seller ID. |
| `isMarketplace` | boolean | `true` when sold by a marketplace seller rather than Chedraui. |
| `description` | string | Product description (when `withDetails` is on), else `null`. |
| `specifications` | object | Specification attributes from the catalog (when `withDetails` is on), else `null`. |
| `aiDescriptionEn` | string | AI-cleaned English description (paid add-on), else `null`. |
| `aiSourceLanguage` | string | Detected source language (paid add-on), else `null`. |
| `aiAttributes` | object | AI-extracted structured attributes (paid add-on), else `null`. |
| `observedAt` | string | ISO 8601 timestamp of when the record was collected. |
| `error` | string | `null` on success. On a failed run, a single item with a populated `error` field is written instead. |

### Example output record

Real record from a live run (input `{"searchTerms":["leche"],"maxProducts":3,"withDetails":true,"withAiDescription":true,"withAiAttributes":true}`). The `installmentsTable` array is trimmed for length; the values shown are real:

```json
{
  "name": "Leche Bové Leche con Café Orgánica 330ml",
  "url": "https://www.chedraui.com.mx/leche-bove-leche-con-cafe-organica-330ml-3855683/p",
  "productId": "3855683",
  "sku": "3855683",
  "ean": "7501639313538",
  "brand": "Bové",
  "categories": ["Supermercado > Lacteos y huevo > Leche", "Supermercado > Lacteos y huevo", "Supermercado"],
  "price": 25.5,
  "listPrice": 30,
  "priceWithoutDiscount": 30,
  "sellingPrice": 25.5,
  "currency": "MXN",
  "installments": {"number": 1, "value": 25.5, "interestRate": 0, "interestFree": true, "total": 25.5},
  "availableQuantity": 99999,
  "isAvailable": true,
  "sellerName": "Chedraui",
  "sellerId": "1",
  "isMarketplace": false,
  "description": "La combinación perfecta de leche orgánica y café. Las imágenes del producto son únicamente de referencia...",
  "specifications": {"Contenido del empaque": "1 pz de 330ml", "Máximo de venta": "12", "MultiEan": "7501639313538"},
  "aiDescriptionEn": "Bové Organic Milk with Coffee is a perfect blend of high-quality organic milk and coffee, packaged in a convenient 330ml container.",
  "aiSourceLanguage": "Spanish",
  "aiAttributes": {"productType": "Leche con Café", "sizeOrWeight": "330ml", "packCount": "1", "dietary": ["Orgánico"]},
  "observedAt": "2026-08-14T07:20:18.946Z",
  "error": null
}
```

### Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace `<TOKEN>` with your Apify API token.

Run synchronously and get dataset items in one call:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~chedraui-scraper/run-sync-get-dataset-items?token=%3CTOKEN%3E" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms":["coca cola"],"maxProducts":25,"sortOrder":"OrderByPriceASC"}'
```

Start a run asynchronously:

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~chedraui-scraper/runs?token=%3CTOKEN%3E" \
  -H "Content-Type: application/json" \
  -d '{"categories":["Supermercado/Bebidas"],"maxProducts":100}'
```

Apify CLI:

```bash
apify call scrapers_lat/chedraui-scraper \
  --input '{"searchTerms":["leche"],"maxProducts":10}'
```

### Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing `format`:

```bash
## JSON
curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&clean=true&format=json"

## CSV
curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&clean=true&format=csv"

## Paginate large datasets
curl "https://api.apify.com/v2/datasets/%3CDATASET_ID%3E/items?token=%3CTOKEN%3E&offset=1000&limit=1000"
```

`<DATASET_ID>` is returned as `defaultDatasetId` in the run object. Use `offset` and `limit` to page through large result sets. `clean=true` drops empty and internal fields.

### Billing and limits

- **Pay per result.** You are charged per product offer returned (`result` event). See the [pricing tab](https://apify.com/scrapers_lat/chedraui-scraper/pricing) for the current per-result price.
- **Paid AI add-ons.** `withAiDescription` and `withAiAttributes` are optional, require a paid Apify plan, and are billed per record only when they return usable output.
- **No charge on failure.** If a run errors, the actor writes a single item with a populated `error` field and does not charge for it. Empty runs cost nothing.
- **Spend cap respected.** Set `maxTotalChargeUsd` on the run; once reached, the actor stops emitting and charging further billable results.
- **Free Apify plans** are capped at 10 records per run. Upgrade for higher `maxProducts`.

### FAQ and troubleshooting

**A run returned 0 records. Why?**
No product matched that term or category. Try a broader term or a valid category id/path. Zero-result runs are not charged.

**How do I get the cheapest products first?**
Set `sortOrder` to `OrderByPriceASC`. Use `OrderByBestDiscountDESC` for the biggest discounts.

**Why are the AI fields null?**
The matching add-on was off, you are on a free account, or the AI produced no usable output for that record. AI fields are never invented.

**Why is `description` or `specifications` null?**
`withDetails` was off, or the catalog listing has no such data. Missing source values are returned as `null`.

**What does one record represent?**
One available SKU and seller. A product sold by multiple sellers can produce multiple records.

**Is this an official Chedraui tool?**
No. This actor is independent and has no affiliation with Chedraui. It reads only data that is publicly available in the online catalog. Use it in accordance with the site terms.

### Related scrapers

- [Liverpool Mexico Scraper](https://apify.com/scrapers_lat/liverpool-mexico-scraper): Liverpool Mexico product catalog and prices.
- [Elektra Scraper](https://apify.com/scrapers_lat/elektra-scraper): Elektra Mexico product listings and prices.
- [Mercado Libre Scraper](https://apify.com/scrapers_lat/mercadolibre-scraper): Mercado Libre product listings across Latin America.
- [Coto Argentina Scraper](https://apify.com/scrapers_lat/coto-argentina-scraper): Coto supermarket grocery prices in Argentina.
- [Rappi Scraper](https://apify.com/scrapers_lat/rappi-scraper): Rappi store products and prices across Latin America.

### More scrapers at scrapers.lat

Built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at [scrapers.lat](https://scrapers.lat).

***

> Independent tool, not affiliated with Chedraui. Accesses only publicly available catalog data. Use in accordance with the site terms of service.

# Actor input Schema

## `maxProducts` (type: `integer`):

Maximum number of product offers to collect across all search terms and categories. Each available SKU and seller is one record. Optional.

## `withDetails` (type: `boolean`):

When enabled, each record also includes the product description and specification attributes (content, product type, package size, etc.) from the Chedraui catalog.

## `searchTerms` (type: `array`):

Full-text queries to search the Chedraui catalog (e.g. "coca cola", "leche", "pañales"). Each term is searched separately. Maps to the VTEX ft parameter.

## `categories` (type: `array`):

Restrict results to one or more Chedraui categories. Use either a numeric VTEX category id or a category path. Top-level department ids: 1 Supermercado, 2 Vinos y licores, 3 Bebes, 4 Farmacia, 5 Moda y belleza, 6 Mascotas, 7 Hogar y jardin, 8 Tecnologia, 10 Jugueteria, 11 Cuidado e higiene personal, 13 Electrodomesticos y linea blanca, 15 Deportes. Paths look like "Supermercado/Bebidas". Maps to the VTEX fq=C: filter.

## `sortOrder` (type: `string`):

Order in which the catalog returns products. Maps to the VTEX O parameter.

## `withAiDescription` (type: `boolean`):

Off by default. When on, generates a clean English product description (cleans and translates the Spanish listing). Requires a paid Apify plan. Billed only when a description is produced.

## `withAiAttributes` (type: `boolean`):

Off by default. When on, extracts structured product attributes (type, size/weight, variant, pack count, dietary, features). Requires a paid Apify plan. Billed only when attributes are produced.

## Actor input object example

```json
{
  "maxProducts": 10,
  "withDetails": true,
  "searchTerms": [
    "coca cola"
  ],
  "sortOrder": "",
  "withAiDescription": false,
  "withAiAttributes": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxProducts": 10,
    "searchTerms": [
        "coca cola"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/chedraui-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxProducts": 10,
    "searchTerms": ["coca cola"],
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/chedraui-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxProducts": 10,
  "searchTerms": [
    "coca cola"
  ]
}' |
apify call scrapers_lat/chedraui-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/chedraui-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/mlNThX5bU2X8SCWJZ/builds/wB6AwhyAkHNxGPHuQ/openapi.json