# Brazil Supermarket & Pharmacy Prices — EAN and CEP (`joao_crevellari/supermercados-brasil`) Actor

Brazilian supermarket and pharmacy prices (Atacadão, Prezunic, Supernosso, Savegnago, Pague Menos and more) by keyword or EAN barcode, with regional price by CEP. Price monitoring, promotions, cesta básica and competitor tracking. Pay only per product delivered.

- **URL**: https://apify.com/joao_crevellari/supermercados-brasil.md
- **Developed by:** [João Crevellari](https://apify.com/joao_crevellari) (community)
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 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.

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

## Brazil Grocery & Pharmacy Prices — Atacadão, Supernosso, Prezunic and more

Compare **supermarket and pharmacy prices across Brazilian chains** by keyword or **barcode (EAN)**, with **regional prices by CEP** (Brazilian ZIP code). One run, one clean table: product, brand, EAN, price, list price, discount, availability and link.

🇧🇷 [Leia em português](#português)

### Stores covered

| Store | Type | Main region |
|---|---|---|
| Atacadão | Supermarket (cash & carry) | Nationwide |
| Supernosso | Supermarket | Minas Gerais |
| Prezunic | Supermarket | Rio de Janeiro |
| Savegnago | Supermarket | São Paulo (interior) |
| Covabra | Supermarket | São Paulo (Campinas) |
| Mambo | Supermarket | São Paulo |
| Super Muffato | Supermarket | Paraná |
| Giassi | Supermarket | Santa Catarina |
| Pague Menos | Pharmacy | Nationwide |
| Drogarias Pacheco | Pharmacy | RJ / SP / MG |

All stores are read through their own public product search, only where their `robots.txt` allows it, at a low request rate.

### Why this Actor

- **Many chains in one run**, same columns for all of them.
- **Search by EAN** to compare the *exact same product* across chains: similar products returned by a store search are dropped.
- **Regional prices**: pass a CEP and each store answers with the price for that region. When a store does not serve that CEP (or does not allow regional lookups), you get its default online price and `postalCode` comes back empty, so you always know which is which.
- **Real discounts**: `listPrice` (the "de" price) and `price` (the "por" price), plus `discountPercent`.
- **You pay only for delivered products.**

### Who uses it

- Consumer-goods brands and distributors monitoring shelf price and promotions.
- Price-comparison apps, cashback and coupon sites.
- Market research, inflation and basket-price studies (cesta básica).
- Retail category managers watching competitors.

### Input

| Field | What it does | Default |
|---|---|---|
| `searchTerms` | Keywords such as `arroz 5kg`, `café 500g`. Each term runs in each store. | — |
| `eans` | Barcodes to compare the exact product across stores. | — |
| `stores` | Store ids. Empty = all supermarkets (pharmacies only when selected). | all supermarkets |
| `postalCode` | CEP for regional prices, e.g. `01310-100`. | store default |
| `maxResultsPerSearch` | Max products per term per store. | `20` |
| `onlyAvailable` | Skip out-of-stock products. | `true` |
| `maxResults` | Stop after N products in total. | `100` |

Example:

```json
{
  "searchTerms": ["arroz 5kg", "feijão carioca 1kg", "café 500g"],
  "eans": ["7896006711155"],
  "postalCode": "01310-100",
  "maxResultsPerSearch": 10
}
```

### Output

One row per product variant (SKU) and store (real example):

```json
{
  "store": "supernosso",
  "storeName": "Supernosso",
  "storeType": "supermercado",
  "query": "arroz 5kg",
  "queryType": "term",
  "postalCode": null,
  "productId": "17482",
  "skuId": "17737",
  "name": "Arroz Branco Tipo 1 Prato Fino Pacote 5kg",
  "brand": "Prato Fino",
  "ean": "7896290300011",
  "category": "Mercearia > Arroz > Arroz Tipo 1",
  "unit": "un",
  "unitMultiplier": 1,
  "price": 29.99,
  "listPrice": 29.99,
  "discountPercent": 0,
  "isAvailable": true,
  "seller": "Supernosso.com",
  "url": "https://www.supernosso.com/arroz-branco-tipo-1-prato-fino-pacote-5kg/p",
  "imageUrl": "https://supernossoio.vtexassets.com/arquivos/ids/1567631/7440_0.png",
  "scrapedAt": "2026-11-16T21:21:36.868Z"
}
```

Prices are in BRL, as shown online at the time of the run. In-store prices may differ.

### Pricing

Pay per event:

- **US$ 0.002 per product delivered** (US$ 2 per 1,000).
- **US$ 0.001 per run.**

Comparing 30 products in 8 chains (about 240 rows) costs about US$ 0.48.

### Legal

Public product and price information only. No login, no personal data, low request rate and `robots.txt` respected for every store.

***

### Português

#### Preços de supermercado Brasil — Atacadão, Supernosso, Prezunic e mais

Compare **preços de supermercados e farmácias de várias redes brasileiras** por termo ou **código de barras (EAN)**, com **preço por CEP**. Uma execução, uma tabela: produto, marca, EAN, preço, preço "de", desconto, disponibilidade e link.

**Lojas**: Atacadão, Supernosso, Prezunic, Savegnago, Covabra, Mambo, Super Muffato, Giassi e as farmácias Pague Menos e Drogarias Pacheco. Todas lidas pela busca pública da própria loja, só onde o robots.txt permite, em ritmo baixo.

**Por que usar**

- **Várias redes numa execução**, com as mesmas colunas para todas.
- **Busca por EAN**: compara exatamente o mesmo produto entre redes; produtos parecidos são descartados.
- **Preço por CEP**: com um CEP, cada loja responde com o preço da região. Se a loja não atende aquele CEP, vem o preço padrão do site e o campo `postalCode` fica vazio, para você saber qual é qual.
- **Desconto real**: preço "de" (`listPrice`), preço "por" (`price`) e `discountPercent`.
- **Você paga só pelos produtos entregues.**

**Para quem**: indústria e distribuidores acompanhando preço de gôndola e promoção, apps de comparação de preço e cashback, pesquisa de mercado e cesta básica, gerentes de categoria do varejo.

**Preço**: US$ 0,002 por produto entregue (US$ 2 por mil) + US$ 0,001 por execução. Comparar 30 produtos em 8 redes (cerca de 240 linhas) custa uns US$ 0,48.

**Legal**: só informação pública de produto e preço, sem login, sem dado pessoal, ritmo baixo e robots.txt respeitado em todas as lojas.

# Actor input Schema

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

Product names to search, e.g. "arroz 5kg", "café 500g". Each term is searched in every selected store. / Cada termo é buscado em cada loja.

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

Compare o mesmo produto entre redes. Só entra o SKU com o mesmo código. / Compare the exact same product across chains.

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

Vazio = todos os supermercados. Farmácias só entram se escolhidas. / Empty = all supermarkets.

## `postalCode` (type: `string`):

Opcional. Preço da região do CEP quando a loja atende; senão, preço padrão da loja (o campo postalCode vem vazio). / Optional regional prices; falls back to the store default.

## `maxResultsPerSearch` (type: `integer`):

Maximum products for each search term in each store. / Máximo de produtos por termo em cada loja.

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

Skip products that are out of stock. / Pula produtos sem estoque.

## `maxResults` (type: `integer`):

Stop after N products in total. You only pay for delivered products (US$ 0.002 each). / Máximo total; você só paga pelos produtos entregues.

## Actor input object example

```json
{
  "searchTerms": [
    "arroz 5kg",
    "café 500g"
  ],
  "maxResultsPerSearch": 5,
  "onlyAvailable": true,
  "maxResults": 100
}
```

# Actor output Schema

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

One row per product offer: store, name, EAN, price, list price, availability and link.

# 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 = {
    "searchTerms": [
        "arroz 5kg",
        "café 500g"
    ],
    "maxResultsPerSearch": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("joao_crevellari/supermercados-brasil").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 = {
    "searchTerms": [
        "arroz 5kg",
        "café 500g",
    ],
    "maxResultsPerSearch": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("joao_crevellari/supermercados-brasil").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 '{
  "searchTerms": [
    "arroz 5kg",
    "café 500g"
  ],
  "maxResultsPerSearch": 5
}' |
apify call joao_crevellari/supermercados-brasil --silent --output-dataset

```

## MCP server setup

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

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/9vMMWUi2S1aXY2sxX/builds/moOPhDy2FlyihWbhO/openapi.json
