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):

{
  "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 · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• 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.

{
  "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:

{
  "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:

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

Start a run asynchronously:

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

Apify CLI:

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:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&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 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: Liverpool Mexico product catalog and prices.
• Elektra Scraper: Elektra Mexico product listings and prices.
• Mercado Libre Scraper: Mercado Libre product listings across Latin America.
• Coto Argentina Scraper: Coto supermarket grocery prices in Argentina.
• Rappi Scraper: Rappi store products and prices across Latin America.

More scrapers at scrapers.lat

Built and maintained by 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.

---

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