Olimpica Scraper: Product Prices, Stock and Catalog API for Colombia

The most complete Olimpica scraper and Olimpica API for Colombia supermarket data. Extract Olimpica precios de productos (product prices), discounts, stock, EAN barcodes, brands, sellers, installment plans, variations and full specifications from the entire olimpica.com catalog, by keyword, category or start URL. Built for grocery price scraping, retail price monitoring, and competitive market research across Colombia. Export to JSON, CSV or Excel.

Use it to track precios de supermercado en Colombia, monitor ofertas y descuentos, build a price comparison feed, feed a pricing dashboard, or enrich a product catalog with barcodes and specifications.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Who it is for
• How it compares
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

This Olimpica product scraper queries the Olimpica Colombia catalog, runs each search term, category or advanced start URL you pass, paginates through the matching products, and writes one normalized record per purchasable offer (SKU and seller) to the run's dataset. Prices are returned in Colombian pesos (COP), missing source values are returned as null and never invented, and when you turn on details each record also carries the full description, a specifications object, and the complete image gallery.

Every record includes the price, list price, discount percentage, price per measurement unit, EAN barcode, brand, category breadcrumb and numeric category ids, stock, seller, whether the offer is first party or a marketplace seller, the best installment plan plus the complete installment table across every card, accepted payment methods, product variations (size and color grid), images and videos.

Data covers products listed on olimpica.com only, including both Olimpica first-party items and marketplace sellers.

Who it is for

• Price monitoring and repricing teams tracking Colombia supermarket and retail prices day to day.
• Consumer goods brands and suppliers checking shelf price, discounts and stock of their products at Olimpica.
• Market researchers and analysts measuring promotions, assortment and price positioning in Colombia.
• Price comparison and cashback sites that need clean, structured grocery and retail data.
• Data teams enriching a product catalog with EAN barcodes, specifications and images.

How it compares

There is no other Olimpica specific scraper on the Apify Store, so the comparison is against generic e-commerce actors and marketplace-locked VTEX actors. This actor is a strict superset of their inputs and outputs.

Capability	This actor (scrapers_lat/olimpica-scraper)	Generic e-commerce scrapers	Marketplace-locked VTEX actors
Olimpica Colombia full catalog	Yes	Partial, manual selectors	No
Keyword search input	Yes	Sometimes	Varies
Category ID filter	Yes	No	Varies
Start URL passthrough	Yes	No	No
Sort order control	8 orders	No	No
Price, list price, discount % (COP)	Yes	Price only	Price only
Price per measurement unit (grocery)	Yes	No	No
EAN barcode	Yes	Rare	Sometimes
Full installment plan table	Yes	No	Rare
Accepted payment methods	Yes	No	No
Variations grid (size and color)	Yes	No	Sometimes
Full image gallery and videos	Yes	Thumbnail only	Sometimes
Technical specifications	Yes	No	Sometimes
First party vs marketplace seller	Yes	No	Sometimes
No charge on failure and spend cap	Yes	Varies	Varies

Quickstart

Open the actor, paste this into the input, and press Run. It returns the first 10 arroz (rice) offers with full details.

{
  "maxProducts": 10,
  "withDetails": true,
  "searchTerms": ["arroz"],
  "sortOrder": ""
}

Provide at least one searchTerms, categories, or startUrl. Leave sortOrder empty for relevance order. Every other input field is optional.

Input reference

Field	Type	Required	Default	Description
searchTerms	string[]	no	["arroz"]	Full-text queries to search the Olimpica catalog, for example arroz, cafe, panales. Each term runs as a separate search.
categories	string[]	no	(none)	Restrict results to one or more Olimpica categories by numeric VTEX category id, for example 900000000 (Supermercado), 6000000 (Electrodomesticos y Tecnologia), 726000000 (Moda).
startUrl	string	no	(empty)	Advanced. A full Olimpica catalog search URL whose query string (ft, fq, O) is used as-is. When set, its parameters take precedence.
maxProducts	integer	no	10	Maximum number of products to collect across all searches and categories. Leave empty for no limit (paid plans).
withDetails	boolean	no	true	When enabled, each record is enriched with the product description, full specifications, and complete image gallery, and is billed as a details add-on event.
sortOrder	enum	no	(relevance)	Order results are returned in. One of OrderByPriceASC, OrderByPriceDESC, OrderByTopSaleDESC, OrderByReviewRateDESC, OrderByNameASC, OrderByNameDESC, OrderByReleaseDateDESC, OrderByBestDiscountDESC.
proxyConfiguration	object	no	(none)	Standard Apify proxy configuration.

If you pass no searchTerms, categories, or startUrl, the actor has nothing to scrape.

Output reference

One dataset item per purchasable offer (SKU and seller). Types: string, integer, number, boolean, string[], object, or null when the source value is absent.

Field	Type	Description
name	string	Product name as listed.
variantName	string	Name of the specific SKU or variant, for example Talla: M.
brand	string	Brand name, or null when not published.
brandId	string	Brand identifier.
category	string	Primary category path (breadcrumb).
categories	string[]	All category paths the product belongs to.
categoryIds	string[]	Numeric category id path, leaf last.
categoryLeafId	string	Numeric id of the deepest (leaf) category.
metaDescription	string	Short marketing description, always present when published.
productTitle	string	SEO product title.
linkText	string	URL slug of the product.
productId	string	Olimpica product ID.
sku	string	SKU identifier of the offer.
ean	string	EAN barcode, or null when not published.
referenceId	string	Manufacturer reference ID when published, else null.
productReference	string	Store product reference.
productReferenceCode	string	Store product reference code.
url	string	Direct link to the product page.
price	number	Current price in COP.
listPrice	number	List (reference) price in COP.
priceWithoutDiscount	number	Price before any discount in COP.
fullSellingPrice	number	Full selling price in COP.
discountPercent	number	Discount percentage off list price, or null.
discountHighlights	string[]	Named discount highlights on the offer, or null.
pricePerUnit	number	Price per measurement unit in COP.
rewardValue	number	Loyalty reward value on the offer.
tax	number	Tax amount on the offer.
currency	string	Currency code. Always COP.
measurementUnit	string	Unit the product is sold in, for example un.
unitMultiplier	number	Multiplier applied to the unit.
variations	object	This SKU's variation axes, for example { "Talla": "M" }, or null.
availableVariations	object	Full run of variation values across the product, for example { "Talla": ["S","M","L","XL"] }.
color	string	Convenience color value pulled from variations, or null.
size	string	Convenience size value pulled from variations, or null.
isKit	boolean	true when the SKU is a kit or bundle.
installments	object	Best installment offer: number, value, interestRate, interestFree, total.
installmentsTable	object[]	Every installment plan across payment methods: number, value, interestRate, total, paymentName.
paymentMethods	string[]	Accepted payment method names (Visa, Mastercard, Amex, PSE, Addi, Tarjeta Olimpica, and more).
priceValidUntil	string	Date the price is valid until (ISO 8601), when published.
promoTeasers	array	Active promotion teasers, or null.
releaseDate	string	Product release date (ISO 8601).
available	boolean	true when the offer is in stock.
stock	integer	Units available to buy.
seller	string	Seller name (Olimpica or a marketplace seller).
sellerId	string	Seller identifier.
isMarketplace	boolean	true when sold by a third-party marketplace seller.
isDefaultSeller	boolean	true when this is the default seller for the SKU.
imageUrl	string	Primary product image URL.
images	string[]	All product image URLs. Full gallery present when withDetails is on.
videos	string[]	Product video URLs, or null.
estimatedArrivalDate	string	Estimated arrival date when published, else null.
description	string	Full product description. Present when withDetails is on.
specifications	object	Technical attributes. Present when withDetails is on.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed query, an item with a populated error field is written instead.

Note: the Olimpica catalog does not publish star ratings or review counts, so those fields are not returned. We never invent them.

Example output record

Real record from a live run (input {"searchTerms":["arroz"],"withDetails":true,"maxProducts":10}). The installmentsTable, images, paymentMethods and specifications collections are trimmed here with a note; all values shown are real:

{
  "name": "Arroz Mi Arroz 3 Kg",
  "variantName": "ARROZ MI ARROZ 3 KG",
  "brand": "Mi Arroz",
  "brandId": "4494",
  "category": "Supermercado > Despensa > Arroces Empacados Y Granel",
  "categories": [
    "Supermercado > Despensa > Arroces Empacados Y Granel",
    "Supermercado > Despensa",
    "Supermercado"
  ],
  "categoryIds": ["900000000", "900020000", "900020400"],
  "categoryLeafId": "900020400",
  "metaDescription": "Descubre el sabor y la calidad de Arroz Mi Arroz 3 Kg. Ideal para tus comidas familiares.",
  "productTitle": "Bolsa de Arroz x3 Kg con Descuento y Envío Rápido",
  "productId": "1635734",
  "sku": "1635734",
  "ean": "7707105814060",
  "productReferenceCode": "1124787",
  "url": "https://www.olimpica.com/arroz-mi-arroz-3-kg-7707105814060-1635734/p",
  "linkText": "arroz-mi-arroz-3-kg-7707105814060-1635734",
  "price": 9650,
  "listPrice": 9650,
  "priceWithoutDiscount": 9650,
  "fullSellingPrice": 9650,
  "discountPercent": null,
  "discountHighlights": null,
  "pricePerUnit": 9650,
  "rewardValue": 0,
  "tax": 0,
  "currency": "COP",
  "measurementUnit": "un",
  "unitMultiplier": 1,
  "variations": null,
  "availableVariations": null,
  "color": null,
  "size": null,
  "isKit": false,
  "installments": { "number": 36, "value": 269, "interestRate": null, "interestFree": true, "total": 9650 },
  "installmentsTable": ["... 250 plans across Visa, Mastercard, Amex, Diners, Codensa, PSE and Tarjeta Olimpica ..."],
  "paymentMethods": ["Visa", "Mastercard", "American Express", "Diners", "PSE", "Tarjeta de Crédito Olímpica Mastercard", "... 12 total"],
  "priceValidUntil": "2027-09-04T00:00:00Z",
  "promoTeasers": null,
  "releaseDate": "2021-04-13T00:00:00Z",
  "available": true,
  "stock": 99999,
  "seller": "Olimpica",
  "sellerId": "1",
  "isMarketplace": false,
  "isDefaultSeller": true,
  "imageUrl": "https://olimpica.vteximg.com.br/arquivos/ids/644097/7707105814060.jpg",
  "images": ["https://olimpica.vteximg.com.br/arquivos/ids/644097/7707105814060.jpg", "... full gallery ..."],
  "videos": null,
  "description": "ARROZ MI ARROZ 3 KG",
  "specifications": { "Tipo de Arroces Empacados Y Granel": "Arroz Blanco", "measurement_unit": "Gramo", "unit_multiplier": "3000" },
  "observedAt": "2026-09-04T08:37:22.172Z",
  "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~olimpica-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms":["cafe"],"withDetails":true,"maxProducts":25,"sortOrder":"OrderByPriceASC"}'

Start a run asynchronously:

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

Apify CLI:

apify call scrapers_lat/olimpica-scraper \
  --input '{"searchTerms":["panales"]}'

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 record returned (result event). When withDetails is on, an additional details add-on event is charged per record. See the pricing tab for current prices.
• No charge on failure. If a query errors, the actor writes an 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 a higher maxProducts.

FAQ and troubleshooting

A run returned 0 records. Why? No searchTerms, categories, or startUrl were provided, or the filter matched nothing. Add a search target or loosen the query. Zero-result runs are not charged.

How do I get technical specifications and descriptions? Turn on withDetails. Every record then carries the product description, a specifications object, and the complete image gallery.

Which currency are prices in? Colombian pesos. Every price field is in COP and each record carries currency: "COP".

Can I read installment plans and payment methods? Yes. installments gives the best single plan, installmentsTable lists every plan across payment methods, and paymentMethods lists the accepted methods (Visa, Mastercard, American Express, PSE, Addi, Tarjeta Olimpica, and more).

How do I get sizes and colors for clothing or shoes? Each SKU record carries its own variations (for example { "Talla": "M" }) plus availableVariations with the full size and color run for the product. The convenience color and size fields hold the single value for that SKU.

Why are some fields null? Fields like brand, ean, referenceId, or discountPercent are only filled when the store publishes them. Missing source values are returned as null, never invented. Star ratings and review counts are not published by the catalog and are not returned.

How do I reuse an exact Olimpica search? Paste the full catalog search URL into startUrl. Its ft, fq, and O parameters are used as-is.

Is this an official Olimpica tool? No. This actor is independent and has no affiliation with Olimpica or Supertiendas y Droguerias Olimpica. It reads only data that is publicly available on the platform. Use it in accordance with Olimpica's terms of service.

Related scrapers

• Exito Colombia Grocery Price Scraper: Exito Colombia product prices, list prices, stock, EAN and brands.
• Chedraui Mexico Grocery Price Scraper: Chedraui Mexico product prices, EAN codes, stock and installments.
• Dia Argentina Grocery Price Scraper: Dia Argentina product prices, list prices, stock, EAN and brand.
• Disco Argentina Grocery Price Scraper: Disco Argentina product prices, list prices, stock and EAN.
• Oechsle Peru Product Price & Stock Scraper: Oechsle Peru product prices, stock, brands and specifications.
• MercadoLibre Product Listings Scraper: Products, prices and seller data from MercadoLibre across LATAM.

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.

---

Olimpica Scraper: Precios de Productos, Stock y API de Catálogo para Colombia

El scraper de Olimpica y la API de Olimpica más completa para obtener datos de supermercado en Colombia. Extrae precios de productos de Olimpica, descuentos, stock, códigos de barras EAN, marcas, vendedores, planes de cuotas, variaciones y especificaciones completas de todo el catálogo de olimpica.com, por palabra clave, categoría o URL. Pensado para monitoreo de precios de supermercado, seguimiento de precios en retail e investigación de mercado competitiva en Colombia. Exporta a JSON, CSV o Excel.

Úsalo para seguir precios de supermercado en Colombia, monitorear ofertas y descuentos, armar un comparador de precios, alimentar un tablero de precios o enriquecer un catálogo de productos con códigos de barras y especificaciones.

📥 Entrada · 📤 Salida · 💰 Precios · ▶️ Ejemplos

Tabla de contenido

• Qué hace
• Para quién es
• Cómo se compara
• Inicio rápido
• Referencia de entrada
• Referencia de salida
• Ejemplo de registro de salida
• Ejecutar por API y CLI
• Obtener resultados
• Facturación y límites
• Preguntas frecuentes

Qué hace

Este scraper de productos de Olimpica consulta el catálogo de Olimpica Colombia, ejecuta cada palabra clave, categoría o URL avanzada que le pases, recorre los productos que coinciden y escribe un registro normalizado por cada oferta comprable (SKU y vendedor) en el dataset de la ejecución. Los precios se devuelven en pesos colombianos (COP), los valores ausentes se devuelven como null y nunca se inventan, y cuando activas los detalles cada registro incluye además la description completa, un objeto specifications y la galería de imágenes completa.

Cada registro incluye el precio, el precio de lista, el porcentaje de descuento, el precio por unidad de medida, el código de barras EAN, la marca, la ruta de categorías y los ids numéricos de categoría, el stock, el vendedor, si la oferta es propia o de un vendedor del marketplace, el mejor plan de cuotas más la tabla completa de cuotas por tarjeta, los medios de pago aceptados, las variaciones del producto (talla y color), las imágenes y los videos.

Los datos cubren solo productos listados en olimpica.com, incluyendo artículos propios de Olimpica y vendedores del marketplace.

Para quién es

• Equipos de monitoreo de precios y repricing que siguen precios de supermercado y retail en Colombia día a día.
• Marcas y proveedores de consumo masivo que revisan el precio en góndola, los descuentos y el stock de sus productos en Olimpica.
• Investigadores y analistas de mercado que miden promociones, surtido y posicionamiento de precios en Colombia.
• Sitios de comparación de precios y cashback que necesitan datos de supermercado y retail limpios y estructurados.
• Equipos de datos que enriquecen un catálogo de productos con códigos de barras EAN, especificaciones e imágenes.

Cómo se compara

No existe otro scraper específico de Olimpica en la Apify Store, así que la comparación es contra actores genéricos de e-commerce y actores VTEX limitados a un solo marketplace. Este actor es un superconjunto estricto de sus entradas y salidas.

Capacidad	Este actor (scrapers_lat/olimpica-scraper)	Scrapers genéricos de e-commerce	Actores VTEX de un solo marketplace
Catálogo completo de Olimpica Colombia	Sí	Parcial, selectores manuales	No
Entrada por palabra clave	Sí	A veces	Varía
Filtro por ID de categoría	Sí	No	Varía
Paso directo de URL de inicio	Sí	No	No
Control de orden	8 órdenes	No	No
Precio, precio de lista, % de descuento (COP)	Sí	Solo precio	Solo precio
Precio por unidad de medida (supermercado)	Sí	No	No
Código de barras EAN	Sí	Raro	A veces
Tabla completa de cuotas	Sí	No	Raro
Medios de pago aceptados	Sí	No	No
Grilla de variaciones (talla y color)	Sí	No	A veces
Galería completa de imágenes y videos	Sí	Solo miniatura	A veces
Especificaciones técnicas	Sí	No	A veces
Vendedor propio vs marketplace	Sí	No	A veces
Sin cobro ante fallo y tope de gasto	Sí	Varía	Varía

Inicio rápido

Abre el actor, pega esto en la entrada y presiona Ejecutar. Devuelve las primeras 10 ofertas de arroz con detalles completos.

{
  "maxProducts": 10,
  "withDetails": true,
  "searchTerms": ["arroz"],
  "sortOrder": ""
}

Provee al menos un searchTerms, categories o startUrl. Deja sortOrder vacío para orden por relevancia. Todos los demás campos son opcionales.

Referencia de entrada

Campo	Tipo	Obligatorio	Predeterminado	Descripción
searchTerms	string[]	no	["arroz"]	Consultas de texto para buscar en el catálogo de Olimpica, por ejemplo arroz, cafe, panales. Cada término se ejecuta como una búsqueda separada.
categories	string[]	no	(ninguno)	Limita los resultados a una o más categorías de Olimpica por su id numérico de categoría, por ejemplo 900000000 (Supermercado), 6000000 (Electrodomesticos y Tecnologia), 726000000 (Moda).
startUrl	string	no	(vacío)	Avanzado. Una URL completa de búsqueda del catálogo de Olimpica cuyo query string (ft, fq, O) se usa tal cual. Cuando se define, sus parámetros tienen prioridad.
maxProducts	integer	no	10	Máximo de productos a recolectar entre todas las búsquedas y categorías. Deja vacío para no poner límite (planes de pago).
withDetails	boolean	no	true	Cuando está activo, cada registro se enriquece con la description del producto, las specifications completas y la galería de imágenes, y se cobra como evento adicional details.
sortOrder	enum	no	(relevancia)	Orden en que se devuelven los resultados. Uno de OrderByPriceASC, OrderByPriceDESC, OrderByTopSaleDESC, OrderByReviewRateDESC, OrderByNameASC, OrderByNameDESC, OrderByReleaseDateDESC, OrderByBestDiscountDESC.
proxyConfiguration	object	no	(ninguno)	Configuración estándar de proxy de Apify.

Si no pasas searchTerms, categories ni startUrl, el actor no tiene nada que extraer.

Referencia de salida

Un item del dataset por cada oferta comprable (SKU y vendedor). Tipos: string, integer, number, boolean, string[], object, o null cuando el valor de origen está ausente.

Campo	Tipo	Descripción
name	string	Nombre del producto tal como aparece listado.
variantName	string	Nombre del SKU o variante específica, por ejemplo Talla: M.
brand	string	Marca, o null cuando no se publica.
brandId	string	Identificador de la marca.
category	string	Ruta de categoría principal (breadcrumb).
categories	string[]	Todas las rutas de categoría del producto.
categoryIds	string[]	Ruta de ids numéricos de categoría, hoja al final.
categoryLeafId	string	Id numérico de la categoría más profunda (hoja).
metaDescription	string	Descripción corta de marketing, presente cuando se publica.
productTitle	string	Título SEO del producto.
linkText	string	Slug de la URL del producto.
productId	string	ID de producto de Olimpica.
sku	string	Identificador SKU de la oferta.
ean	string	Código de barras EAN, o null cuando no se publica.
referenceId	string	ID de referencia del fabricante cuando se publica, si no null.
productReference	string	Referencia de producto de la tienda.
productReferenceCode	string	Código de referencia de producto de la tienda.
url	string	Enlace directo a la página del producto.
price	number	Precio actual en COP.
listPrice	number	Precio de lista (referencia) en COP.
priceWithoutDiscount	number	Precio antes de descuento en COP.
fullSellingPrice	number	Precio de venta completo en COP.
discountPercent	number	Porcentaje de descuento sobre el precio de lista, o null.
discountHighlights	string[]	Destacados de descuento de la oferta, o null.
pricePerUnit	number	Precio por unidad de medida en COP.
rewardValue	number	Valor de recompensa de fidelidad en la oferta.
tax	number	Monto de impuesto en la oferta.
currency	string	Código de moneda. Siempre COP.
measurementUnit	string	Unidad en que se vende el producto, por ejemplo un.
unitMultiplier	number	Multiplicador aplicado a la unidad.
variations	object	Ejes de variación de este SKU, por ejemplo { "Talla": "M" }, o null.
availableVariations	object	Todos los valores de variación del producto, por ejemplo { "Talla": ["S","M","L","XL"] }.
color	string	Valor de color extraído de las variaciones, o null.
size	string	Valor de talla extraído de las variaciones, o null.
isKit	boolean	true cuando el SKU es un kit o combo.
installments	object	Mejor plan de cuotas: number, value, interestRate, interestFree, total.
installmentsTable	object[]	Cada plan de cuotas por medio de pago: number, value, interestRate, total, paymentName.
paymentMethods	string[]	Medios de pago aceptados (Visa, Mastercard, Amex, PSE, Addi, Tarjeta Olimpica y más).
priceValidUntil	string	Fecha hasta la que el precio es válido (ISO 8601), cuando se publica.
promoTeasers	array	Promociones activas, o null.
releaseDate	string	Fecha de lanzamiento del producto (ISO 8601).
available	boolean	true cuando la oferta tiene stock.
stock	integer	Unidades disponibles para comprar.
seller	string	Nombre del vendedor (Olimpica o un vendedor del marketplace).
sellerId	string	Identificador del vendedor.
isMarketplace	boolean	true cuando lo vende un tercero del marketplace.
isDefaultSeller	boolean	true cuando es el vendedor por defecto del SKU.
imageUrl	string	URL de la imagen principal.
images	string[]	Todas las URLs de imagen. Galería completa cuando withDetails está activo.
videos	string[]	URLs de video del producto, o null.
estimatedArrivalDate	string	Fecha estimada de llegada cuando se publica, si no null.
description	string	Descripción completa del producto. Presente cuando withDetails está activo.
specifications	object	Atributos técnicos. Presente cuando withDetails está activo.
observedAt	string	Marca de tiempo ISO 8601 de cuándo se recolectó el registro.
error	string	null en éxito. Ante una consulta fallida se escribe un item con el campo error poblado.

Nota: el catálogo de Olimpica no publica calificaciones ni cantidad de reseñas, por eso esos campos no se devuelven. Nunca los inventamos.

Ejemplo de registro de salida

Registro real de una ejecución en vivo (entrada {"searchTerms":["arroz"],"withDetails":true,"maxProducts":10}). Las colecciones installmentsTable, images, paymentMethods y specifications se recortan aquí con una nota; todos los valores mostrados son reales:

{
  "name": "Arroz Mi Arroz 3 Kg",
  "variantName": "ARROZ MI ARROZ 3 KG",
  "brand": "Mi Arroz",
  "brandId": "4494",
  "category": "Supermercado > Despensa > Arroces Empacados Y Granel",
  "categories": [
    "Supermercado > Despensa > Arroces Empacados Y Granel",
    "Supermercado > Despensa",
    "Supermercado"
  ],
  "categoryIds": ["900000000", "900020000", "900020400"],
  "categoryLeafId": "900020400",
  "metaDescription": "Descubre el sabor y la calidad de Arroz Mi Arroz 3 Kg. Ideal para tus comidas familiares.",
  "productTitle": "Bolsa de Arroz x3 Kg con Descuento y Envío Rápido",
  "productId": "1635734",
  "sku": "1635734",
  "ean": "7707105814060",
  "productReferenceCode": "1124787",
  "url": "https://www.olimpica.com/arroz-mi-arroz-3-kg-7707105814060-1635734/p",
  "linkText": "arroz-mi-arroz-3-kg-7707105814060-1635734",
  "price": 9650,
  "listPrice": 9650,
  "priceWithoutDiscount": 9650,
  "fullSellingPrice": 9650,
  "discountPercent": null,
  "discountHighlights": null,
  "pricePerUnit": 9650,
  "rewardValue": 0,
  "tax": 0,
  "currency": "COP",
  "measurementUnit": "un",
  "unitMultiplier": 1,
  "variations": null,
  "availableVariations": null,
  "color": null,
  "size": null,
  "isKit": false,
  "installments": { "number": 36, "value": 269, "interestRate": null, "interestFree": true, "total": 9650 },
  "installmentsTable": ["... 250 planes en Visa, Mastercard, Amex, Diners, Codensa, PSE y Tarjeta Olimpica ..."],
  "paymentMethods": ["Visa", "Mastercard", "American Express", "Diners", "PSE", "Tarjeta de Crédito Olímpica Mastercard", "... 12 en total"],
  "priceValidUntil": "2027-09-04T00:00:00Z",
  "promoTeasers": null,
  "releaseDate": "2021-04-13T00:00:00Z",
  "available": true,
  "stock": 99999,
  "seller": "Olimpica",
  "sellerId": "1",
  "isMarketplace": false,
  "isDefaultSeller": true,
  "imageUrl": "https://olimpica.vteximg.com.br/arquivos/ids/644097/7707105814060.jpg",
  "images": ["https://olimpica.vteximg.com.br/arquivos/ids/644097/7707105814060.jpg", "... galería completa ..."],
  "videos": null,
  "description": "ARROZ MI ARROZ 3 KG",
  "specifications": { "Tipo de Arroces Empacados Y Granel": "Arroz Blanco", "measurement_unit": "Gramo", "unit_multiplier": "3000" },
  "observedAt": "2026-09-04T08:37:22.172Z",
  "error": null
}

Ejecutar por API y CLI

Inicia una ejecución y espera a que termine, luego lee el dataset. Reemplaza <TOKEN> por tu token de API de Apify.

Ejecución sincrónica que devuelve los items del dataset en una sola llamada:

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

Iniciar una ejecución de forma asíncrona:

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

Apify CLI:

apify call scrapers_lat/olimpica-scraper \
  --input '{"searchTerms":["panales"]}'

Obtener resultados

Cada ejecución escribe en un dataset. Obtén los items como JSON, CSV o Excel cambiando 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"

# Paginar datasets grandes
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> se devuelve como defaultDatasetId en el objeto de la ejecución. Usa offset y limit para paginar grandes conjuntos de resultados. clean=true descarta campos vacíos e internos.

Facturación y límites

• Pago por resultado. Se cobra por cada registro de producto devuelto (evento result). Cuando withDetails está activo, se cobra además un evento adicional details por registro. Consulta la pestaña de precios.
• Sin cobro ante fallo. Si una consulta falla, el actor escribe un item con el campo error poblado y no cobra por él. Las ejecuciones vacías no cuestan nada.
• Tope de gasto respetado. Define maxTotalChargeUsd en la ejecución; al alcanzarlo, el actor deja de emitir y cobrar más resultados.
• Planes gratuitos de Apify están limitados a 10 registros por ejecución. Mejora tu plan para un maxProducts mayor.

Preguntas frecuentes

Una ejecución devolvió 0 registros. ¿Por qué? No se pasó searchTerms, categories ni startUrl, o el filtro no coincidió con nada. Agrega un objetivo de búsqueda o amplía la consulta. Las ejecuciones sin resultados no se cobran.

¿Cómo obtengo especificaciones técnicas y descripciones? Activa withDetails. Cada registro incluirá entonces la description del producto, un objeto specifications y la galería de imágenes completa.

¿En qué moneda están los precios? Pesos colombianos. Cada campo de precio está en COP y cada registro incluye currency: "COP".

¿Puedo leer planes de cuotas y medios de pago? Sí. installments da el mejor plan único, installmentsTable lista cada plan por medio de pago y paymentMethods lista los medios aceptados (Visa, Mastercard, American Express, PSE, Addi, Tarjeta Olimpica y más).

¿Cómo obtengo tallas y colores de ropa o calzado? Cada registro de SKU incluye sus propias variations (por ejemplo { "Talla": "M" }) más availableVariations con toda la grilla de tallas y colores del producto. Los campos de conveniencia color y size traen el valor único de ese SKU.

¿Por qué algunos campos son null? Campos como brand, ean, referenceId o discountPercent solo se completan cuando la tienda los publica. Los valores ausentes se devuelven como null, nunca se inventan. Las calificaciones y reseñas no las publica el catálogo y no se devuelven.

¿Cómo reutilizo una búsqueda exacta de Olimpica? Pega la URL completa de búsqueda del catálogo en startUrl. Sus parámetros ft, fq y O se usan tal cual.

¿Es una herramienta oficial de Olimpica? No. Este actor es independiente y no tiene afiliación con Olimpica ni con Supertiendas y Droguerias Olimpica. Solo lee datos disponibles públicamente en la plataforma. Úsalo de acuerdo con los términos de servicio de Olimpica.

Scrapers relacionados

• Exito Colombia Grocery Price Scraper: precios, precios de lista, stock, EAN y marcas de Exito Colombia.
• Chedraui Mexico Grocery Price Scraper: precios, códigos EAN, stock y cuotas de Chedraui Mexico.
• Dia Argentina Grocery Price Scraper: precios, precios de lista, stock, EAN y marca de Dia Argentina.
• Disco Argentina Grocery Price Scraper: precios, precios de lista, stock y EAN de Disco Argentina.
• Oechsle Peru Product Price & Stock Scraper: precios, stock, marcas y especificaciones de Oechsle Peru.
• MercadoLibre Product Listings Scraper: productos, precios y datos de vendedores de MercadoLibre en LATAM.

Más scrapers en scrapers.lat

Creado y mantenido por scrapers.lat, donde publicamos scrapers para plataformas públicas de EE. UU. y América Latina: registros de empresas, datos gubernamentales, finanzas, e-commerce y más. Explora el catálogo o solicita un scraper a medida en scrapers.lat.

---

Herramienta independiente, sin afiliación con Olimpica ni Supertiendas y Droguerias Olimpica. Accede solo a datos disponibles públicamente. Úsala de acuerdo con los términos de servicio de Olimpica.