# LatAm Supermarket & Pharmacy Price Scraper (`youthful_colleague/latam-supermarket-prices`) Actor

Scrape grocery and pharmacy prices, discounts, stock and EAN barcodes from 13 stores: Olimpica, La Rebaja, Locatel, Panamericana (Colombia), Jumbo, Disco, Vea, Carrefour (Argentina), Plaza Vea, Wong, Metro (Peru), Chedraui (Mexico) and Pague Menos (Brazil).

- **URL**: https://apify.com/youthful_colleague/latam-supermarket-prices.md
- **Developed by:** [José S](https://apify.com/youthful_colleague) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.10 / 1,000 products

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

## LatAm Supermarket & Pharmacy Price Scraper

Get **prices, discounts, stock status and EAN barcodes** from 13 supermarkets and pharmacies in **Colombia, Argentina, Peru, Mexico and Brazil** in one run. Search by keyword (for example "arroz" or "acetaminofen") or by **barcode**, and compare the same product across stores and countries.

No browser, no login and no cookies. The Actor reads the public product catalog that each store's website already uses to show its shelves, so runs are fast and cheap.

### What you can do with it

- **Price monitoring**: track the price of your products or your competitors' products every day.
- **Promotions and discounts**: sort by "Biggest discount first" to see the deepest deals in a category.
- **Cross-store comparison by EAN**: look up the same barcode in every store and compare price and availability.
- **Consumer price research**: build a basket of basic goods (rice, milk, eggs, oil) and follow it over time, per country.
- **Assortment analysis**: see which brands and presentations each chain sells in a category.
- **AI agents**: the Actor works well as a tool through the Apify MCP server ("what does 1 kg of rice cost at Plaza Vea and Wong today?").

### Supported stores

| Key | Store | Country | Currency | Type |
|---|---|---|---|---|
| `olimpica-co` | Olimpica | Colombia | COP | Supermarket |
| `larebaja-co` | Drogas La Rebaja | Colombia | COP | Pharmacy |
| `locatel-co` | Locatel | Colombia | COP | Pharmacy |
| `panamericana-co` | Panamericana | Colombia | COP | Books, stationery, tech |
| `disco-ar` | Disco | Argentina | ARS | Supermarket |
| `vea-ar` | Vea | Argentina | ARS | Supermarket |
| `jumbo-ar` | Jumbo | Argentina | ARS | Supermarket |
| `carrefour-ar` | Carrefour | Argentina | ARS | Supermarket |
| `plazavea-pe` | Plaza Vea | Peru | PEN | Supermarket |
| `wong-pe` | Wong | Peru | PEN | Supermarket |
| `metro-pe` | Metro | Peru | PEN | Supermarket |
| `chedraui-mx` | Chedraui | Mexico | MXN | Supermarket |
| `paguemenos-br` | Pague Menos | Brazil | BRL | Pharmacy |

**Other stores**: many other Latin American retailers run on the same e-commerce platform (VTEX). Add their domain in **Other VTEX stores (advanced)**. If a store does not expose its catalog or blocks automated requests, the run continues with the other stores and the problem is listed in the `RUN_SUMMARY` record.

This Actor is not affiliated with, endorsed by or sponsored by VTEX or by any of the stores listed. Store names are used only to identify the public websites the data comes from.

### Every store, country and what people search for

Each store also has its own single-store Actor. Use it when you only need one store and want a simpler input.

| Store | Country | What it sells | En español | Single-store Actor |
|---|---|---|---|---|
| Olimpica | Colombia | Supermarket, appliances, home | precios Olimpica, ofertas del supermercado Olimpica | [Olimpica Scraper](https://apify.com/youthful_colleague/olimpica-scraper) |
| Drogas La Rebaja | Colombia | Pharmacy | precios de medicamentos en Drogas La Rebaja | [Drogas La Rebaja Scraper](https://apify.com/youthful_colleague/drogas-la-rebaja-scraper) |
| Locatel | Colombia | Pharmacy, dermocosmetics, medical devices | precios Locatel Colombia, dermocosmética y droguería | [Locatel Colombia Scraper](https://apify.com/youthful_colleague/locatel-colombia-scraper) |
| Panamericana | Colombia | Books, school and office supplies, tech | precios de libros y útiles escolares en Panamericana | [Panamericana Scraper](https://apify.com/youthful_colleague/panamericana-scraper) |
| Disco | Argentina | Supermarket | precios Disco Argentina, promociones del supermercado | [Disco Scraper](https://apify.com/youthful_colleague/disco-argentina-scraper) |
| Vea | Argentina | Supermarket | precios Vea Argentina, canasta básica en pesos | [Vea Scraper](https://apify.com/youthful_colleague/vea-argentina-scraper) |
| Jumbo | Argentina | Hypermarket | precios Jumbo Argentina, ofertas del hipermercado | [Jumbo Argentina Scraper](https://apify.com/youthful_colleague/jumbo-argentina-scraper) |
| Carrefour | Argentina | Hypermarket | precios Carrefour Argentina, promociones y stock | [Carrefour Argentina Scraper](https://apify.com/youthful_colleague/carrefour-argentina-scraper) |
| Plaza Vea | Peru | Supermarket, electrohogar | precios Plaza Vea Perú en soles | [Plaza Vea Scraper](https://apify.com/youthful_colleague/plaza-vea-scraper) |
| Wong | Peru | Premium supermarket | precios Wong Perú, vinos y abarrotes | [Wong Scraper](https://apify.com/youthful_colleague/wong-peru-scraper) |
| Metro | Peru | Supermarket | precios Metro Perú, abarrotes y lácteos | [Metro Peru Scraper](https://apify.com/youthful_colleague/metro-peru-scraper) |
| Chedraui | Mexico | Supermarket, pharmacy, electronics | precios Chedraui México, despensa y farmacia | [Chedraui Scraper](https://apify.com/youthful_colleague/chedraui-scraper) |
| Pague Menos | Brazil | Pharmacy | preços Pague Menos, farmácia online (em português) | [Pague Menos Scraper](https://apify.com/youthful_colleague/pague-menos-scraper) |

Use this multi-store Actor when you want to compare stores or countries in one run, for example the same EAN in Disco, Vea and Jumbo, or a basket of staples in Colombia, Peru and Mexico.

### How to use it

1. Pick one or more **stores**.
2. Add **search terms** in the store's language (Spanish or Portuguese), and/or **EAN barcodes**.
3. Set **Max products per search term** (default 50) and **Max products in total** (default 1,000).
4. Click **Start**. Download the results as JSON, CSV, Excel or use the API.

#### Input example

```json
{
    "stores": ["olimpica-co", "plazavea-pe", "wong-pe", "chedraui-mx"],
    "searchTerms": ["arroz", "aceite de girasol"],
    "eans": ["7790742141101"],
    "maxResultsPerQuery": 50,
    "maxItems": 1000,
    "sort": "bestDiscount",
    "onlyAvailable": true
}
```

### Output

One row per product SKU and store. Example:

```json
{
    "store": "wong-pe",
    "storeName": "Wong",
    "country": "PE",
    "currency": "PEN",
    "currencyGuessed": false,
    "productId": "13559",
    "skuId": "13571",
    "name": "Chocolate con Leche Triangulo 29g",
    "brand": "Triangulo",
    "ean": "8445291904729",
    "price": 2.5,
    "listPrice": 2.5,
    "discountPct": 0,
    "isAvailable": true,
    "sellerName": "WongIO",
    "sellerCount": 1,
    "measurementUnit": "un",
    "unitMultiplier": 1,
    "category": "Abarrotes > Chocolateria > Chocolates de Leche",
    "url": "https://www.wong.pe/chocolate-con-leche-triangulo-29g/p",
    "imageUrl": "https://wongfood.vteximg.com.br/arquivos/ids/500755/222111-01-77506.jpg",
    "matchedBy": "searchTerm",
    "query": "leche",
    "scrapedAt": "2026-11-14T22:37:33.761Z"
}
```

| Field | Meaning |
|---|---|
| `price` | Current selling price of the cheapest available offer, in `currency`. |
| `listPrice` | Regular price before the discount. If a store publishes an obviously broken list price (more than 4 times the price), the selling price is used instead. |
| `discountPct` | Discount versus `listPrice`, in percent. |
| `isAvailable` | Whether the store shows the product as in stock. |
| `ean` | EAN / GTIN barcode as published by the store. Use it to match products across stores. |
| `sellerName`, `sellerCount` | Some stores are marketplaces; the row uses the cheapest available seller. |
| `matchedBy`, `query` | Whether the row came from a search term or a barcode, and which one. |

The `RUN_SUMMARY` record in the key-value store shows, per store, how many products were found, how many requests were made and any errors.

### Pricing

This Actor uses **pay per event**: you pay only for the products you get.

| Event | Price |
|---|---|
| Product (one row in the dataset) | **$1.50 per 1,000 products** ($0.0015 each) |
| Actor start | $0.00005 per run (Apify default) |

Lower prices apply automatically on higher Apify plans (Silver and Gold). There are no extra platform usage charges. Use **Max products in total** or the run's maximum cost setting to cap what you spend: the Actor stops cleanly when either limit is reached, and duplicates are removed before you are charged.

Example: 500 products from 5 stores cost about $0.75.

### Speed and politeness

- About 50 products per request. 1,000 products usually take under a minute.
- The Actor waits at least 1 second between requests to the same store and is limited to 60 requests per minute by default. You can lower this.
- Failed requests are retried up to 4 times with a fresh session.

### Is it legal to scrape these stores?

The Actor only collects **public product information** (names, prices, stock, barcodes, images and categories) that anyone can see on the stores' websites without logging in. It does **not** collect personal data, reviews, customer accounts or anything behind a login. You are responsible for how you use the data and for complying with the terms of the websites and the laws that apply to you. If you are unsure, consult a lawyer.

### FAQ

**Why do I get products that do not match my search exactly?**
The results come from each store's own search engine, in the store's own order. Use more specific terms ("leche entera 1 litro") or search by EAN.

**Can I scrape a whole category?**
Use a broad term (for example "aceite") with a high product limit. The store catalog allows up to 2,550 products per search term.

**A store returned no data.**
Open the `RUN_SUMMARY` record. Stores sometimes block requests from some regions; try enabling Apify Proxy in the input. If it keeps failing, open an issue on the Issues tab and it will be checked.

**Can I schedule it?**
Yes. Create a task with your input and add a daily schedule in Apify Console. Each run returns a fresh snapshot with `scrapedAt`, so you can build a price history.

### Feedback

Missing a store or a field? Open an issue on the **Issues** tab. Requests for new Latin American stores are welcome.

# Actor input Schema

## `stores` (type: `array`):

Supermarkets and pharmacies to search. Each store is searched separately and every product row says which store it came from.

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

Keywords to search, in the store's language, for example "arroz", "leche deslactosada" or "acetaminofen". Each term is searched in every selected store.

## `eans` (type: `array`):

Optional. Barcodes (8 to 14 digits) to look up in every selected store. Use this to compare the exact same product across stores and countries.

## `maxResultsPerQuery` (type: `integer`):

How many products to collect for each search term (or barcode) in each store. The store API allows up to 2,550.

## `maxItems` (type: `integer`):

Hard cap for the whole run. The run stops when it is reached, so you never pay for more than this.

## `sort` (type: `string`):

Order in which the store returns products. Useful with a low product limit, for example to get only the biggest discounts.

## `onlyAvailable` (type: `boolean`):

Skip products the store shows as unavailable.

## `deduplicate` (type: `boolean`):

If the same product appears for two search terms in the same store, keep it only once (you are charged once).

## `includeDescription` (type: `boolean`):

Add the store's product description as plain text (up to 2,000 characters). Makes the dataset larger.

## `customStoreDomains` (type: `array`):

Optional. Domains of other stores built on VTEX, for example "www.example.com.co". Add the currency after a bar to set it, for example "www.example.com|COP". Without it, the currency is guessed from the domain ending and marked with currencyGuessed = true. Stores that block automated requests return no data and are listed in the RUN_SUMMARY record.

## `maxRequestsPerMinute` (type: `integer`):

Speed limit for the whole run, to stay polite with the stores. Each request returns up to 50 products. There is also a 1 second pause between requests to the same store.

## `proxyConfiguration` (type: `object`):

Usually not needed. Turn it on only if a store blocks requests from your region.

## Actor input object example

```json
{
  "stores": [
    "olimpica-co"
  ],
  "searchTerms": [
    "arroz"
  ],
  "maxResultsPerQuery": 10,
  "maxItems": 1000,
  "sort": "relevance",
  "onlyAvailable": false,
  "deduplicate": true,
  "includeDescription": false,
  "maxRequestsPerMinute": 60,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `products` (type: `string`):

One row per product SKU and store, with price, list price, discount, stock and EAN.

## `runSummary` (type: `string`):

Products and failed requests per store, and any errors.

# 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 = {
    "stores": [
        "olimpica-co"
    ],
    "searchTerms": [
        "arroz"
    ],
    "maxResultsPerQuery": 10,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("youthful_colleague/latam-supermarket-prices").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 = {
    "stores": ["olimpica-co"],
    "searchTerms": ["arroz"],
    "maxResultsPerQuery": 10,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("youthful_colleague/latam-supermarket-prices").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 '{
  "stores": [
    "olimpica-co"
  ],
  "searchTerms": [
    "arroz"
  ],
  "maxResultsPerQuery": 10,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call youthful_colleague/latam-supermarket-prices --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,youthful_colleague/latam-supermarket-prices"
        }
    }
}
```

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/LcLcwDGU1gkFpOj5F/builds/K33jrdgeb0TxdmCd6/openapi.json
