# Exito Colombia Grocery Price Scraper (`scrapers_lat/exito-scraper`) Actor
Extract product data from Exito Colombia by keyword or category. Scrape prices, list prices, stock, installments, EAN, brand, seller and marketplace flag from the largest Colombian grocery and retail store.
- **URL**: https://apify.com/scrapers\_lat/exito-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** E-commerce, Automation, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars
## Pricing
from $8.00 / 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/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use 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
[](https://console.apify.com/actors/NSqpT3K3tjdxiyOzP/input)
## Exito Scraper
> Extract product prices, stock, installments and seller data from Exito, the largest grocery and retail chain in Colombia, across groceries, technology, home appliances and more.
21 fields per record
Colombia coverage
JSON / CSV / Excel output formats
Updated 2026-06-22
### What you get
Each record is one purchasable product offer with its current price in Colombian pesos, ready to load into any database, spreadsheet, or price-monitoring pipeline:
- **imageUrl**: main product image
- **images**: all image URLs for the SKU (electronics often have several); imageUrl above is the first one
- **releaseDate**: catalog release date of the product, when provided
- **productReference**: manufacturer reference / model code from the catalog
- **installmentsTable**: full installment plan table per offer (number of payments, payment value, interest rate, total, payment method name)
- **priceValidUntil**: date the current price is valid until, when provided
- **promoTeasers**: names of active promotions or discounts applied to the offer
- **measurementUnit**: unit of measure for price-per-unit, when provided
- **unitMultiplier**: unit multiplier for price-per-unit, when provided
- **name**: full product name as listed
- **brand**: product brand, when published
- **category**: most specific category path for the product
- **productId**: unique Exito product id
- **sku**: unique SKU id for the variant
- **ean**: barcode (EAN), when published
- **price**: current price in pesos for this offer
- **listPrice**: reference list price before discount
- **sellingPrice**: full selling price for the offer
- **currency**: currency code for all prices (COP)
- **installments**: highest number of interest-free installments offered, when available
- **available**: whether the product is buyable right now
- **stock**: units in stock for the offer
- **seller**: name of the seller fulfilling the offer
- **isMarketplace**: whether the offer comes from a third-party marketplace seller rather than Exito itself
- **categories**: full category path list from department down to subcategory
- **url**: direct link to the product page
- **description\***: product description text, when published
- **specifications\***: technical specifications as name and value pairs
- **observedAt**: when this product was last seen by the scraper
\* Detail fields, included when Include Details is enabled.
### Who is it for
| Use case | Who benefits |
|---|---|
| Grocery price monitoring | Retail and CPG teams tracking supermarket prices in Colombia |
| Promotion tracking | Analysts comparing list price against current price for discounts |
| Marketplace intelligence | Brands watching third-party sellers on the Exito marketplace |
| Catalog enrichment | Teams matching products by EAN, SKU, and brand |
| Data pipelines | Developers feeding BI tools, dashboards, or repricing engines |
### Frequently Asked Questions
**What can I search on Exito?**
You can search the full catalog by one or more keywords (for example "arroz", "televisor lg", or "pañales"), or restrict results to departments such as Mercado, Tecnologia, or Electrodomesticos. Each keyword and each department is scraped as its own query, so you can collect several searches in a single run.
**How many results can I get per run?**
You set the limit with Max Items. The Exito catalog serves results in pages of fifty and allows paging through roughly the first 2,500 products for any single search or department, so very broad queries are best narrowed with a keyword, department, or sort order.
**Does it work from outside Colombia?**
Exito serves its catalog from Colombia and limits foreign datacenter traffic, so the actor uses Apify Colombian residential proxy by default. This is enabled out of the box and is what keeps runs stable from any location.
**Does it report prices in Colombian pesos?**
Yes. Every price field is in Colombian pesos and each record carries a currency code of COP, so you can load the data without guessing the currency.
**Can I tell Exito offers from marketplace offers?**
Yes. Each offer carries a seller name and an isMarketplace flag, so you can separate first-party Exito offers from third-party marketplace sellers and analyze each channel on its own.
### Example use cases
Ready-to-run example tasks, each preconfigured for a common scenario. Open one and press run, or use it as a template:
- [Exito Electronics TV and Phone Price Tracking Colombia](https://apify.com/scrapers_lat/exito-scraper/examples/exito-electronics-tv-phone-price-tracking-colombia): Monitor Exito Colombia prices for televisions, smartphones and electronics. Export brands, prices, discounts and installment plans for price tracking.
- [Exito Grocery Staples Price Monitoring Colombia](https://apify.com/scrapers_lat/exito-scraper/examples/exito-grocery-staples-price-monitoring-colombia): Track Exito prices for rice, milk and grocery staples in Colombia. Export product names, brands, prices and promos for retail price monitoring.
- [Exito Personal Care Products Price Monitoring Colombia](https://apify.com/scrapers_lat/exito-scraper/examples/exito-personal-care-products-price-monitoring-colombia): Track Exito Colombia prices for shampoo, diapers and personal care products. Export names, brands, prices and promos for retail price monitoring.
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [Chedraui Mexico Grocery Price Scraper](https://apify.com/scrapers_lat/chedraui-scraper): Scrape Chedraui Mexico product prices, EAN codes, stock, brands and installments by keyword or...
- [Dia Argentina Grocery Price Scraper](https://apify.com/scrapers_lat/dia-ar-scraper): Scrape Dia Argentina product prices, list prices, stock, EAN, brand and sellers by keyword or...
- [Disco Argentina Grocery Price Scraper](https://apify.com/scrapers_lat/disco-ar-scraper): Scrape Disco Argentina product prices, list prices, stock, EAN and sellers by keyword or category....
- [Elektra Mexico Product Price & Installment Scraper](https://apify.com/scrapers_lat/elektra-scraper): Scrape Elektra Mexico product prices, installment plans, EAN codes, stock, brands and sellers by...
- [MercadoLibre Product Listings Scraper](https://apify.com/scrapers_lat/mercadolibre-scraper): Extract products, prices and seller data from MercadoLibre across 18 LATAM countries. Scrape...
- [Quince Product Scraper](https://apify.com/scrapers_lat/quince-scraper): Extract Quince.com products with prices, traditional retail price, discounts, variants, images and...
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with Almacenes Exito or Grupo Exito. It only accesses data that is publicly available on the platform. Use it in accordance with Exito's terms of service.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of product offers to collect across all searches and categories. Each available SKU and seller is one record. Optional.
## `withDetails` (type: `boolean`):
When enabled, each record also includes the product description and technical specifications. Disable for a faster, lighter run.
## `searchTerms` (type: `array`):
Full-text queries to search the Exito catalog (e.g. "arroz", "televisor lg", "pañales"). Each term is searched separately. Maps to the VTEX ft parameter.
## `categories` (type: `array`):
Restrict results to one or more Exito departments. Each selected department is scraped separately. Maps to the VTEX fq=C: filter.
## `sortOrder` (type: `string`):
Order in which the catalog returns products. Maps to the VTEX O parameter.
## `proxyConfiguration` (type: `object`):
Proxy settings. Exito serves its catalog from Colombia and rate-limits or blocks foreign datacenter IPs, so Apify Proxy with Colombian residential IPs is enabled by default and recommended.
## Actor input object example
```json
{
"maxItems": 10,
"withDetails": true,
"searchTerms": [
"arroz"
],
"categories": [],
"sortOrder": "",
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "CO"
}
}
````
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 10,
"searchTerms": [
"arroz"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/exito-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxItems": 10,
"searchTerms": ["arroz"],
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/exito-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 10,
"searchTerms": [
"arroz"
]
}' |
apify call scrapers_lat/exito-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/exito-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Exito Colombia Grocery Price Scraper",
"description": "Extract product data from Exito Colombia by keyword or category. Scrape prices, list prices, stock, installments, EAN, brand, seller and marketplace flag from the largest Colombian grocery and retail store.",
"version": "0.1",
"x-build-id": "ISfmG1xNtPhJakfcN"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~exito-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-exito-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapers_lat~exito-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-exito-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapers_lat~exito-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-exito-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of product offers to collect across all searches and categories. Each available SKU and seller is one record. Optional."
},
"withDetails": {
"title": "Include Details",
"type": "boolean",
"description": "When enabled, each record also includes the product description and technical specifications. Disable for a faster, lighter run.",
"default": true
},
"searchTerms": {
"title": "Search Terms",
"type": "array",
"description": "Full-text queries to search the Exito catalog (e.g. \"arroz\", \"televisor lg\", \"pañales\"). Each term is searched separately. Maps to the VTEX ft parameter.",
"items": {
"type": "string"
}
},
"categories": {
"title": "Categories",
"type": "array",
"description": "Restrict results to one or more Exito departments. Each selected department is scraped separately. Maps to the VTEX fq=C: filter.",
"items": {
"type": "string",
"enum": [
"34185082",
"34185083",
"34185084",
"34185085",
"34185087",
"34185088",
"34185089",
"34185090",
"34185091",
"34185093",
"34185086",
"34185095",
"34185096",
"34185780",
"346098589",
"348542968",
"341066070"
],
"enumTitles": [
"Mercado (Groceries)",
"Cuidado personal (Personal Care)",
"Tecnologia (Technology)",
"Moda y accesorios (Fashion & Accessories)",
"Electrodomesticos (Home Appliances)",
"Hogar y decoracion (Home & Decor)",
"Vehiculos (Vehicles)",
"Papeleria y libros (Stationery & Books)",
"Herramientas y ferreteria (Tools & Hardware)",
"Deportes y fitness (Sports & Fitness)",
"Bebes (Babies)",
"Juguetes y juegos (Toys & Games)",
"Instrumentos musicales (Musical Instruments)",
"Vinos y licores (Wine & Spirits)",
"Belleza (Beauty)",
"Jardin y aire libre (Garden & Outdoor)",
"Movilidad electrica (Electric Mobility)"
]
},
"default": []
},
"sortOrder": {
"title": "Sort Order",
"enum": [
"",
"OrderByPriceASC",
"OrderByPriceDESC",
"OrderByTopSaleDESC",
"OrderByReviewRateDESC",
"OrderByNameASC",
"OrderByNameDESC",
"OrderByReleaseDateDESC",
"OrderByBestDiscountDESC"
],
"type": "string",
"description": "Order in which the catalog returns products. Maps to the VTEX O parameter.",
"default": ""
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Proxy settings. Exito serves its catalog from Colombia and rate-limits or blocks foreign datacenter IPs, so Apify Proxy with Colombian residential IPs is enabled by default and recommended.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "CO"
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```