# 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
- **Features:** Limited permissions
- **Stats:** 8 total users, 0 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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# 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

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.

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
}
```

The example above shows the first 25 of 35 fields.

### 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`.

### 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
}
```

### 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.

**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.

# 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/NLwpD0ZWdF3RjPsuN/openapi.json