Oechsle Scraper: Peru Product Prices, Stock & Catalog API

Scrape Oechsle Peru (oechsle.pe) product data at scale: prices in soles (PEN), list prices, discounts, stock, EAN barcodes, brand, seller, size and color variations, installment plans, images and full technical specifications. Use it for retail price monitoring, competitor price tracking, catalog research, MAP compliance and product intelligence across the Oechsle department store. Export to JSON, CSV or Excel.

Here is one real result, with every field the actor returns (the images, installmentsTable, specifications, availableVariations and paymentMethods collections are trimmed here with a note; all values shown are real):

{
  "imageUrl": "https://oechsle.vteximg.com.br/arquivos/ids/26154376/imageUrl_1.jpg",
  "images": ["https://oechsle.vteximg.com.br/arquivos/ids/26154376/imageUrl_1.jpg"],
  "name": "Zapatillas Urbanas para Mujer Nike Court Vintage Premium CW1067-101",
  "variantName": "Zapatillas Urbanas para Mujer Nike Court Vintage Premium CW1067-101 Marfil Talla 38.5",
  "brand": "NIKE",
  "brandId": 925,
  "category": "Zapatillas > Zapatillas Mujer > Zapatillas Urbanas Mujer",
  "categoryLeafId": "1222307",
  "metaDescription": "Las Nike Court Vintage Premium personifican el calzado de tenis de los anos 80...",
  "linkText": "zapatillas-urbanas-para-mujer-nike-court-vintage-premium-cw1067-101-1001891631",
  "productId": "1001891631",
  "sku": "1001838433",
  "skuReferenceId": "TREPSSPORT-1784580805337",
  "ean": "193659037081",
  "variations": { "Color": "Marfil", "Talla": "38.5" },
  "availableVariations": { "Color": ["Marfil"], "Talla": ["36", "36.5", "37.5", "38", "38.5", "40"] },
  "color": "Marfil",
  "size": "38.5",
  "price": 289.9,
  "listPrice": 319.9,
  "priceWithoutDiscount": 289.9,
  "sellingPrice": 289.9,
  "discountPercent": 9,
  "discountAmount": 30,
  "hasDiscount": true,
  "pricePerUnit": 289.9,
  "spotPrice": null,
  "rewardValue": 0,
  "tax": 0,
  "currency": "PEN",
  "installments": null,
  "installmentsTable": [{ "number": 1, "value": 289.9, "interestRate": 0, "total": 289.9, "paymentName": "SafetyPay" }],
  "discountHighlights": null,
  "paymentMethods": ["Tarjeta-Oh-Cuotas", "Tarjetas-Credito-Debito-PROM"],
  "priceValidUntil": "2026-12-31T00:00:00Z",
  "promoTeasers": null,
  "measurementUnit": "un",
  "unitMultiplier": 1,
  "isKit": false,
  "videos": null,
  "estimatedArrivalDate": null,
  "releaseDate": "2026-07-21T00:00:00Z",
  "availableQuantity": 1,
  "isAvailable": true,
  "seller": "TREPS SPORT",
  "sellerId": "TREPSSPORT",
  "isMarketplace": true,
  "url": "https://www.oechsle.pe/zapatillas-urbanas-para-mujer-nike-court-vintage-premium-cw1067-101-1001891631/p",
  "description": "Las Nike Court Vintage Premium personifican el calzado de tenis de los anos 80...",
  "specifications": { "Genero": "Mujer", "Material principal": "Sintetico", "Temporada": "Toda Temporada" },
  "observedAt": "2026-09-04T14:17:11.015Z",
  "error": null
}

The most complete Oechsle product scraper and price API available. It returns every field the Oechsle (VTEX) catalog exposes for each offer, including price, list price, discount, stock, EAN, brand, seller, size and color variants, installment plans and full technical specifications, and gives you keyword, category, price, brand, stock and sort filters to target exactly the products you need.

Keywords: Oechsle scraper, Oechsle API, Oechsle precios, catalogo Oechsle, Peru ecommerce data, product prices scraper, retail price monitoring, precios ofertas Peru, VTEX scraper.

Input · Output · Pricing · Examples: open the tabs on the actor page.

Table of contents

• What it does
• Use cases
• Quickstart
• How it compares
• Input reference
• Output reference
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor queries the Oechsle Peru catalog (a VTEX storefront), runs each search term, category, or advanced start URL you pass, paginates through the matching products, and writes one normalized record per available SKU and seller to the run's dataset. Prices are returned in Peruvian soles (PEN), missing source values are returned as null, and when you turn on product details each record also carries the full description and a specifications object of technical attributes.

Data covers products listed on oechsle.pe only, including both Oechsle first-party items and marketplace sellers. No account, login or API key is required.

Use cases

• Retail price monitoring and repricing. Track Oechsle prices, list prices and discount percentages over time to power dynamic pricing and MAP compliance.
• Competitor price tracking. Compare Oechsle against other Peru retailers on identical EANs and brands.
• Catalog and assortment research. Map departments, brands, size and color runs, and stock depth across the store.
• Promotion and discount monitoring. Catch markdowns with discountPercent, discountAmount, promoTeasers and priceValidUntil.
• Product data enrichment. Pull EAN barcodes, specifications, images and installment plans to enrich your own product database.

Quickstart

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

{
  "maxProducts": 10,
  "withDetails": true,
  "searchTerms": ["televisor"],
  "onlyAvailable": false,
  "sortOrder": ""
}

Provide searchTerms, categories, or an advanced startUrl. Leave sortOrder empty for relevance order. Every field except a scrape target is optional.

How it compares

Oechsle is a Peruvian department store on the VTEX platform. Generic "VTEX scraper" actors can be pointed at any VTEX store but leave you to map raw fields yourself, and generic marketplace scrapers do not cover oechsle.pe at all. This actor is purpose-built for Oechsle and returns a strict superset of what a generic VTEX or Peru retail scraper gives you.

Capability	This actor	Generic VTEX scraper	Generic marketplace scraper
Targets oechsle.pe out of the box	Yes	Manual setup	No
Search terms input	Yes	Sometimes	Yes
Category filter input	Yes	Sometimes	Sometimes
Advanced start URL input	Yes	Sometimes	No
Price range filter (PEN)	Yes	Rarely	Sometimes
Brand and in-stock filters	Yes	Rarely	Rarely
Sort order control	Yes	Rarely	Sometimes
Price, list price, discount %	Yes	Partial	Partial
EAN barcode	Yes	Sometimes	Rarely
Size and color variations	Yes	Rarely	Rarely
Installment plans table	Yes	Rarely	No
Payment methods	Yes	No	No
Marketplace seller detection	Yes	Rarely	Sometimes
Full specifications and description	Yes	Sometimes	Sometimes
Pay per result, no charge on failure	Yes	Varies	Varies

If you already use a general VTEX or Peru retail scraper, this actor accepts the same inputs (search query, category, product/catalog URL, max items, price filters) and returns the same outputs plus size/color variants, installment plans, payment methods, reward value, EAN and marketplace flags.

Input reference

Field	Type	Required	Default	Description
searchTerms	string[]	no	["televisor"]	Full-text queries to search the Oechsle catalog, for example televisor, zapatillas, laptop. Each term runs as a separate VTEX search.
categories	string[]	no	(none)	Restrict results to one or more Oechsle departments (VTEX fq=C: filter), for example 160 (Tecnologia), 161 (Electrohogar), 9 (Deportes).
startUrl	string	no	(empty)	Advanced. A full VTEX catalog search URL whose query string (ft, fq, O) is used as-is. When set, its parameters take precedence.
maxProducts	integer	no	10	Maximum product offers to collect across all searches and categories. Each available SKU and seller is one record.
withDetails	boolean	no	true	When enabled, each record also includes the product description and a specifications object of technical attributes. Charged as the details add-on event for paying users.
sortOrder	enum	no	(relevance)	Order results are returned in (VTEX O param). One of OrderByPriceASC, OrderByPriceDESC, OrderByTopSaleDESC, OrderByReviewRateDESC, OrderByNameASC, OrderByNameDESC, OrderByReleaseDateDESC, OrderByBestDiscountDESC.
minPrice	integer	no	(none)	Only return offers with a selling price at or above this amount in soles (PEN). Applied at the catalog level.
maxPrice	integer	no	(none)	Only return offers with a selling price at or below this amount in soles (PEN). Applied at the catalog level.
brands	string[]	no	(none)	Keep only products whose brand matches one of these names (case-insensitive, partial match), for example Samsung, Nike, Bosch.
onlyAvailable	boolean	no	false	When enabled, only products currently available to buy (with stock) are returned.
proxyConfiguration	object	no	(none)	Standard Apify proxy configuration. Optional; the source is reachable without a proxy.

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

Output reference

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

Field	Type	Description
imageUrl	string	Primary product image URL.
images	string[]	All product image URLs.
name	string	Product name as listed.
variantName	string	Full variant name including color and size.
brand	string	Brand name, or null when not published.
brandId	integer	VTEX brand ID.
category	string	Primary category path (breadcrumb).
categoryLeafId	string	Leaf category ID.
categories	string[]	All category paths the product belongs to.
metaDescription	string	Short marketing description (always available).
linkText	string	Product URL slug.
productId	string	Oechsle (VTEX) product ID.
sku	string	SKU identifier of the offer.
skuReferenceId	string	Seller or manufacturer SKU reference.
ean	string	EAN barcode, or null when not published.
variations	object	This SKU's variation values, for example { "Color": "Marfil", "Talla": "38.5" }.
availableVariations	object	Every variation option offered across the product, for example all sizes and colors.
color	string	Convenience color value pulled from variations.
size	string	Convenience size value pulled from variations.
price	number	Current price in PEN.
listPrice	number	List (reference) price in PEN.
priceWithoutDiscount	number	Price before any discount in PEN.
sellingPrice	number	Selling price actually charged in PEN.
discountPercent	number	Discount percentage off list price, or null.
discountAmount	number	Absolute discount amount in PEN.
hasDiscount	boolean	true when the offer is discounted below list price.
pricePerUnit	number	Price per measurement unit in PEN.
spotPrice	number	Spot (cash) price when published, else null.
rewardValue	number	Loyalty reward value when published.
tax	number	Tax amount when published.
currency	string	Currency code. Always PEN.
installments	object	Best single installment offer, or null.
installmentsTable	object[]	Every installment plan: number, value, interestRate, total, paymentName.
discountHighlights	string[]	Discount badge or highlight names, or null.
paymentMethods	string[]	Payment methods available for the offer (cards, wallets, cash).
priceValidUntil	string	Date the price is valid until (ISO 8601), when published.
promoTeasers	array	Active promotion teasers, or null.
measurementUnit	string	Unit the product is sold in, for example un.
unitMultiplier	number	Multiplier applied to the unit.
isKit	boolean	true when the SKU is a bundle or kit.
videos	array	Product video URLs, or null.
estimatedArrivalDate	string	Estimated arrival date when published.
releaseDate	string	Product release date (ISO 8601).
availableQuantity	integer	Units available to buy.
isAvailable	boolean	true when the offer is in stock.
seller	string	Seller name (Oechsle or a marketplace seller).
sellerId	string	Seller identifier.
isMarketplace	boolean	true when sold by a third-party marketplace seller.
description	string	Full product description. Present when withDetails is on.
specifications	object	Technical attributes (model, color, warranty, dimensions). 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 on ratings: the Oechsle catalog endpoint does not expose star ratings or review counts, so those fields are not returned rather than filled with invented values.

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~oechsle-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms":["televisor"],"withDetails":true,"maxProducts":25,"sortOrder":"OrderByPriceASC"}'

Start a run asynchronously:

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

Apify CLI:

apify call scrapers_lat/oechsle-scraper \
  --input '{"searchTerms":["laptop"],"brands":["HP"]}'

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 and a record carries description or specifications, an additional details add-on event is charged for paying users only. 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 higher maxProducts.
• Per-query ceiling. Each single search or department returns up to roughly 2,500 products. Narrow broad queries with a keyword, department, price range, or sort order for full coverage.

FAQ and troubleshooting

A run returned 0 records. Why? The filter combination matched nothing, or no searchTerms, categories, or startUrl were provided. Loosen filters or add a search target. Zero-result runs are not charged.

How do I get technical specifications and descriptions? Turn on withDetails. Every record then carries the product description plus a specifications object with attributes such as model, color, warranty, and dimensions.

How do I get sizes and colors? Every record carries variations (this SKU's color and size) and availableVariations (every size and color offered for the product), plus convenience color and size fields.

Which currency are prices in? Peruvian soles. Every price field is in PEN and each record carries currency: "PEN".

Can I filter by price or brand? Yes. minPrice and maxPrice are applied at the Oechsle catalog level (in soles). brands keeps only matching brands (case-insensitive, partial match). onlyAvailable keeps only in-stock offers.

Why are some fields null? Fields like brand, ean, discountPercent, or installments are only filled when the store publishes them. Missing source values are returned as null, never invented. Every record always carries price, availability, identifiers, category, seller, and a direct product link.

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

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

Related scrapers

• Chedraui Mexico Grocery Price Scraper: Chedraui Mexico product prices, EAN codes, stock, brands and installments.
• Dia Argentina Grocery Price Scraper: Dia Argentina product prices, list prices, stock, EAN, brand and sellers.
• Disco Argentina Grocery Price Scraper: Disco Argentina product prices, list prices, stock, EAN and sellers.
• Elektra Mexico Product Price & Installment Scraper: Elektra Mexico product prices, installment plans, EAN codes, stock and brands.
• Exito Colombia Grocery Price Scraper: Exito Colombia product prices, list prices, stock, EAN and brands.
• 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.

Independent tool, not affiliated with Oechsle or Tiendas Oechsle. Accesses only publicly available data. Use in accordance with Oechsle's terms of service.

---

Oechsle Scraper: Precios, Stock y API de Catalogo de Peru

Extrae datos de productos de Oechsle Peru (oechsle.pe) a escala: precios en soles (PEN), precios de lista, descuentos, stock, codigos de barras EAN, marca, vendedor, variaciones de talla y color, planes de cuotas, imagenes y especificaciones tecnicas completas. Usalo para monitoreo de precios retail, seguimiento de precios de la competencia, investigacion de catalogo, cumplimiento de precio minimo (MAP) e inteligencia de productos en la tienda por departamento Oechsle. Exporta a JSON, CSV o Excel.

Este es un resultado real, con cada campo que devuelve el actor (las colecciones images, installmentsTable, specifications, availableVariations y paymentMethods estan recortadas aqui con una nota; todos los valores mostrados son reales):

{
  "imageUrl": "https://oechsle.vteximg.com.br/arquivos/ids/26154376/imageUrl_1.jpg",
  "images": ["https://oechsle.vteximg.com.br/arquivos/ids/26154376/imageUrl_1.jpg"],
  "name": "Zapatillas Urbanas para Mujer Nike Court Vintage Premium CW1067-101",
  "variantName": "Zapatillas Urbanas para Mujer Nike Court Vintage Premium CW1067-101 Marfil Talla 38.5",
  "brand": "NIKE",
  "brandId": 925,
  "category": "Zapatillas > Zapatillas Mujer > Zapatillas Urbanas Mujer",
  "categoryLeafId": "1222307",
  "metaDescription": "Las Nike Court Vintage Premium personifican el calzado de tenis de los anos 80...",
  "linkText": "zapatillas-urbanas-para-mujer-nike-court-vintage-premium-cw1067-101-1001891631",
  "productId": "1001891631",
  "sku": "1001838433",
  "skuReferenceId": "TREPSSPORT-1784580805337",
  "ean": "193659037081",
  "variations": { "Color": "Marfil", "Talla": "38.5" },
  "availableVariations": { "Color": ["Marfil"], "Talla": ["36", "36.5", "37.5", "38", "38.5", "40"] },
  "color": "Marfil",
  "size": "38.5",
  "price": 289.9,
  "listPrice": 319.9,
  "priceWithoutDiscount": 289.9,
  "sellingPrice": 289.9,
  "discountPercent": 9,
  "discountAmount": 30,
  "hasDiscount": true,
  "pricePerUnit": 289.9,
  "spotPrice": null,
  "rewardValue": 0,
  "tax": 0,
  "currency": "PEN",
  "installments": null,
  "installmentsTable": [{ "number": 1, "value": 289.9, "interestRate": 0, "total": 289.9, "paymentName": "SafetyPay" }],
  "discountHighlights": null,
  "paymentMethods": ["Tarjeta-Oh-Cuotas", "Tarjetas-Credito-Debito-PROM"],
  "priceValidUntil": "2026-12-31T00:00:00Z",
  "promoTeasers": null,
  "measurementUnit": "un",
  "unitMultiplier": 1,
  "isKit": false,
  "videos": null,
  "estimatedArrivalDate": null,
  "releaseDate": "2026-07-21T00:00:00Z",
  "availableQuantity": 1,
  "isAvailable": true,
  "seller": "TREPS SPORT",
  "sellerId": "TREPSSPORT",
  "isMarketplace": true,
  "url": "https://www.oechsle.pe/zapatillas-urbanas-para-mujer-nike-court-vintage-premium-cw1067-101-1001891631/p",
  "description": "Las Nike Court Vintage Premium personifican el calzado de tenis de los anos 80...",
  "specifications": { "Genero": "Mujer", "Material principal": "Sintetico", "Temporada": "Toda Temporada" },
  "observedAt": "2026-09-04T14:17:11.015Z",
  "error": null
}

El scraper y API de precios de Oechsle mas completo disponible. Devuelve cada campo que el catalogo de Oechsle (VTEX) expone para cada oferta, incluyendo precio, precio de lista, descuento, stock, EAN, marca, vendedor, variantes de talla y color, planes de cuotas y especificaciones tecnicas completas, y te da filtros por palabra clave, categoria, precio, marca, stock y orden para apuntar exactamente a los productos que necesitas.

Palabras clave: Oechsle scraper, Oechsle API, precios Oechsle, catalogo Oechsle, datos ecommerce Peru, scraper de precios de productos, monitoreo de precios retail, precios ofertas Peru, scraper VTEX.

Input · Output · Precios · Ejemplos: abre las pestanas en la pagina del actor.

Tabla de contenidos

• Que hace
• Casos de uso
• Inicio rapido
• Como se compara
• Referencia de entrada
• Referencia de salida
• Ejecutar via API y CLI
• Obtener resultados
• Facturacion y limites
• Preguntas frecuentes

Que hace

El actor consulta el catalogo de Oechsle Peru (una tienda VTEX), ejecuta cada termino de busqueda, categoria o URL de inicio avanzada que le pases, pagina a traves de los productos coincidentes, y escribe un registro normalizado por cada SKU y vendedor disponible en el dataset de la ejecucion. Los precios se devuelven en soles peruanos (PEN), los valores ausentes en la fuente se devuelven como null, y cuando activas los detalles del producto cada registro tambien lleva la description completa y un objeto specifications de atributos tecnicos.

Los datos cubren solo productos listados en oechsle.pe, incluyendo tanto articulos propios de Oechsle como vendedores del marketplace. No se requiere cuenta, inicio de sesion ni clave de API.

Casos de uso

• Monitoreo de precios retail y repricing. Rastrea precios, precios de lista y porcentajes de descuento de Oechsle a lo largo del tiempo para alimentar precios dinamicos y cumplimiento de MAP.
• Seguimiento de precios de la competencia. Compara Oechsle con otros retailers de Peru sobre EAN y marcas identicas.
• Investigacion de catalogo y surtido. Mapea departamentos, marcas, rangos de talla y color, y profundidad de stock en toda la tienda.
• Monitoreo de promociones y descuentos. Detecta rebajas con discountPercent, discountAmount, promoTeasers y priceValidUntil.
• Enriquecimiento de datos de producto. Obten codigos EAN, especificaciones, imagenes y planes de cuotas para enriquecer tu propia base de datos de productos.

Inicio rapido

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

{
  "maxProducts": 10,
  "withDetails": true,
  "searchTerms": ["televisor"],
  "onlyAvailable": false,
  "sortOrder": ""
}

Proporciona searchTerms, categories, o una startUrl avanzada. Deja sortOrder vacio para orden por relevancia. Cada campo excepto un objetivo de scraping es opcional.

Como se compara

Oechsle es una tienda por departamento peruana en la plataforma VTEX. Los actores genericos de "VTEX scraper" pueden apuntarse a cualquier tienda VTEX pero te dejan mapear los campos crudos por tu cuenta, y los scrapers genericos de marketplace no cubren oechsle.pe en absoluto. Este actor esta hecho a medida para Oechsle y devuelve un superconjunto estricto de lo que te da un scraper generico de VTEX o de retail peruano.

Capacidad	Este actor	VTEX scraper generico	Scraper de marketplace generico
Apunta a oechsle.pe de fabrica	Si	Configuracion manual	No
Entrada de terminos de busqueda	Si	A veces	Si
Entrada de filtro de categoria	Si	A veces	A veces
Entrada de URL de inicio avanzada	Si	A veces	No
Filtro de rango de precio (PEN)	Si	Rara vez	A veces
Filtros de marca y en stock	Si	Rara vez	Rara vez
Control de orden	Si	Rara vez	A veces
Precio, precio de lista, descuento %	Si	Parcial	Parcial
Codigo de barras EAN	Si	A veces	Rara vez
Variaciones de talla y color	Si	Rara vez	Rara vez
Tabla de planes de cuotas	Si	Rara vez	No
Metodos de pago	Si	No	No
Deteccion de vendedor de marketplace	Si	Rara vez	A veces
Especificaciones y descripcion completas	Si	A veces	A veces
Pago por resultado, sin cargo en fallo	Si	Varia	Varia

Si ya usas un scraper generico de VTEX o de retail peruano, este actor acepta las mismas entradas (busqueda, categoria, URL de producto/catalogo, maximo de items, filtros de precio) y devuelve las mismas salidas mas variantes de talla/color, planes de cuotas, metodos de pago, valor de recompensa, EAN y banderas de marketplace.

Referencia de entrada

Campo	Tipo	Requerido	Predeterminado	Descripcion
searchTerms	string[]	no	["televisor"]	Consultas de texto completo para buscar en el catalogo de Oechsle, por ejemplo televisor, zapatillas, laptop. Cada termino corre como una busqueda VTEX separada.
categories	string[]	no	(ninguno)	Restringe resultados a uno o mas departamentos de Oechsle (filtro VTEX fq=C:), por ejemplo 160 (Tecnologia), 161 (Electrohogar), 9 (Deportes).
startUrl	string	no	(vacio)	Avanzado. Una URL completa de busqueda del catalogo VTEX cuya cadena de consulta (ft, fq, O) se usa tal cual. Cuando se define, sus parametros tienen prioridad.
maxProducts	integer	no	10	Maximo de ofertas de producto a recolectar en todas las busquedas y categorias. Cada SKU y vendedor disponible es un registro.
withDetails	boolean	no	true	Cuando esta activado, cada registro tambien incluye la description del producto y un objeto specifications de atributos tecnicos. Se cobra como el evento add-on details solo para usuarios de pago.
sortOrder	enum	no	(relevancia)	Orden en que se devuelven los resultados (parametro VTEX O). Uno de OrderByPriceASC, OrderByPriceDESC, OrderByTopSaleDESC, OrderByReviewRateDESC, OrderByNameASC, OrderByNameDESC, OrderByReleaseDateDESC, OrderByBestDiscountDESC.
minPrice	integer	no	(ninguno)	Solo devuelve ofertas con un precio de venta igual o superior a este monto en soles (PEN). Aplicado a nivel de catalogo.
maxPrice	integer	no	(ninguno)	Solo devuelve ofertas con un precio de venta igual o inferior a este monto en soles (PEN). Aplicado a nivel de catalogo.
brands	string[]	no	(ninguno)	Conserva solo productos cuya marca coincida con uno de estos nombres (sin distincion de mayusculas, coincidencia parcial), por ejemplo Samsung, Nike, Bosch.
onlyAvailable	boolean	no	false	Cuando esta activado, solo se devuelven productos actualmente disponibles para comprar (con stock).
proxyConfiguration	object	no	(ninguno)	Configuracion estandar de proxy de Apify. Opcional; la fuente es accesible sin proxy.

Si no pasas searchTerms, categories, ni startUrl, el actor no tiene nada que scrapear y termina.

Referencia de salida

Un item de dataset por oferta de producto (par SKU y vendedor). Tipos: string, integer, number, boolean, string[], object, o null cuando el valor de la fuente esta ausente.

Campo	Tipo	Descripcion
imageUrl	string	URL de la imagen principal del producto.
images	string[]	Todas las URL de imagenes del producto.
name	string	Nombre del producto tal como esta listado.
variantName	string	Nombre completo de la variante incluyendo color y talla.
brand	string	Nombre de marca, o null cuando no se publica.
brandId	integer	ID de marca en VTEX.
category	string	Ruta de categoria principal (breadcrumb).
categoryLeafId	string	ID de la categoria hoja.
categories	string[]	Todas las rutas de categoria a las que pertenece el producto.
metaDescription	string	Descripcion corta de marketing (siempre disponible).
linkText	string	Slug de la URL del producto.
productId	string	ID de producto de Oechsle (VTEX).
sku	string	Identificador SKU de la oferta.
skuReferenceId	string	Referencia SKU del vendedor o fabricante.
ean	string	Codigo de barras EAN, o null cuando no se publica.
variations	object	Valores de variacion de este SKU, por ejemplo { "Color": "Marfil", "Talla": "38.5" }.
availableVariations	object	Cada opcion de variacion ofrecida en el producto, por ejemplo todas las tallas y colores.
color	string	Valor de color de conveniencia extraido de variations.
size	string	Valor de talla de conveniencia extraido de variations.
price	number	Precio actual en PEN.
listPrice	number	Precio de lista (referencia) en PEN.
priceWithoutDiscount	number	Precio antes de cualquier descuento en PEN.
sellingPrice	number	Precio de venta realmente cobrado en PEN.
discountPercent	number	Porcentaje de descuento sobre el precio de lista, o null.
discountAmount	number	Monto absoluto de descuento en PEN.
hasDiscount	boolean	true cuando la oferta esta rebajada por debajo del precio de lista.
pricePerUnit	number	Precio por unidad de medida en PEN.
spotPrice	number	Precio spot (contado) cuando se publica, si no null.
rewardValue	number	Valor de recompensa de fidelidad cuando se publica.
tax	number	Monto de impuesto cuando se publica.
currency	string	Codigo de moneda. Siempre PEN.
installments	object	Mejor oferta de cuota individual, o null.
installmentsTable	object[]	Cada plan de cuotas: number, value, interestRate, total, paymentName.
discountHighlights	string[]	Nombres de badges o destacados de descuento, o null.
paymentMethods	string[]	Metodos de pago disponibles para la oferta (tarjetas, billeteras, efectivo).
priceValidUntil	string	Fecha hasta la que el precio es valido (ISO 8601), cuando se publica.
promoTeasers	array	Teasers de promocion activos, o null.
measurementUnit	string	Unidad en que se vende el producto, por ejemplo un.
unitMultiplier	number	Multiplicador aplicado a la unidad.
isKit	boolean	true cuando el SKU es un paquete o kit.
videos	array	URL de videos del producto, o null.
estimatedArrivalDate	string	Fecha estimada de llegada cuando se publica.
releaseDate	string	Fecha de lanzamiento del producto (ISO 8601).
availableQuantity	integer	Unidades disponibles para comprar.
isAvailable	boolean	true cuando la oferta esta en stock.
seller	string	Nombre del vendedor (Oechsle o un vendedor del marketplace).
sellerId	string	Identificador del vendedor.
isMarketplace	boolean	true cuando lo vende un vendedor tercero del marketplace.
description	string	Descripcion completa del producto. Presente cuando withDetails esta activo.
specifications	object	Atributos tecnicos (modelo, color, garantia, dimensiones). Presente cuando withDetails esta activo.
observedAt	string	Marca de tiempo ISO 8601 de cuando se recolecto el registro.
error	string	null en exito. En una consulta fallida, se escribe un item con el campo error poblado.

Nota sobre calificaciones: el endpoint del catalogo de Oechsle no expone calificaciones por estrellas ni conteos de resenas, asi que esos campos no se devuelven en lugar de rellenarse con valores inventados.

Ejecutar via API y CLI

Inicia una ejecucion y espera a que termine, luego lee el dataset. Reemplaza <TOKEN> con tu token de API de Apify.

Ejecutar sincronicamente y obtener items del dataset en una sola llamada:

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

Iniciar una ejecucion asincronicamente:

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

Apify CLI:

apify call scrapers_lat/oechsle-scraper \
  --input '{"searchTerms":["laptop"],"brands":["HP"]}'

Obtener resultados

Cada ejecucion escribe en un dataset. Obten 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 ejecucion. Usa offset y limit para paginar resultados grandes. clean=true elimina campos vacios e internos.

Facturacion y limites

• Pago por resultado. Se cobra por cada registro de producto devuelto (evento result). Cuando withDetails esta activo y un registro lleva descripcion o especificaciones, se cobra un evento add-on details adicional solo para usuarios de pago. Consulta la pestana de precios para los precios actuales.
• Sin cargo en fallo. Si una consulta falla, el actor escribe un item con el campo error poblado y no cobra por el. Las ejecuciones vacias no cuestan nada.
• Limite de gasto respetado. Define maxTotalChargeUsd en la ejecucion; una vez alcanzado, el actor deja de emitir y cobrar resultados facturables.
• Los planes gratuitos de Apify estan limitados a 10 registros por ejecucion. Actualiza para un maxProducts mayor.
• Techo por consulta. Cada busqueda o departamento individual devuelve hasta aproximadamente 2,500 productos. Acota consultas amplias con una palabra clave, departamento, rango de precio u orden para cobertura completa.

Preguntas frecuentes

Una ejecucion devolvio 0 registros. Por que? La combinacion de filtros no coincidio con nada, o no se proporcionaron searchTerms, categories, ni startUrl. Relaja los filtros o agrega un objetivo de busqueda. Las ejecuciones sin resultados no se cobran.

Como obtengo especificaciones tecnicas y descripciones? Activa withDetails. Cada registro llevara entonces la description del producto mas un objeto specifications con atributos como modelo, color, garantia y dimensiones.

Como obtengo tallas y colores? Cada registro lleva variations (color y talla de este SKU) y availableVariations (cada talla y color ofrecido para el producto), mas campos de conveniencia color y size.

En que moneda estan los precios? Soles peruanos. Cada campo de precio esta en PEN y cada registro lleva currency: "PEN".

Puedo filtrar por precio o marca? Si. minPrice y maxPrice se aplican a nivel del catalogo de Oechsle (en soles). brands conserva solo marcas coincidentes (sin distincion de mayusculas, coincidencia parcial). onlyAvailable conserva solo ofertas en stock.

Por que algunos campos son null? Campos como brand, ean, discountPercent o installments solo se llenan cuando la tienda los publica. Los valores ausentes en la fuente se devuelven como null, nunca inventados. Cada registro siempre lleva precio, disponibilidad, identificadores, categoria, vendedor y un enlace directo al producto.

Como reutilizo una busqueda exacta de Oechsle? Pega la URL completa de busqueda del catalogo en startUrl. Sus parametros ft, fq y O se usan tal cual.

Es esta una herramienta oficial de Oechsle? No. Este actor es independiente y no tiene afiliacion con Oechsle ni Tiendas Oechsle. Lee solo datos que estan disponibles publicamente en la plataforma. Usalo de acuerdo con los terminos de servicio de Oechsle.

Mas scrapers en scrapers.lat

Construido y mantenido por scrapers.lat, donde publicamos scrapers para plataformas publicas de EE.UU. y America Latina: registros de empresas, datos gubernamentales, finanzas, ecommerce y mas. Explora el catalogo o solicita un scraper personalizado en scrapers.lat.

Herramienta independiente, sin afiliacion con Oechsle ni Tiendas Oechsle. Accede solo a datos disponibles publicamente. Usar de acuerdo con los terminos de servicio de Oechsle.