Oechsle Peru Product Price & Stock Scraper

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

{
  "imageUrl": "https://oechsle.vteximg.com.br/arquivos/ids/21361078/2899372.jpg?v=638856836316870000",
  "images": [
    "https://oechsle.vteximg.com.br/arquivos/ids/21361078/2899372.jpg?v=638856836316870000",
    "https://oechsle.vteximg.com.br/arquivos/ids/21361079/2899372_1.jpg?v=638856836318900000"
  ],
  "name": "Consola Switch 2 System Solus",
  "brand": "NINTENDO",
  "category": "Tecnologia > Videojuegos > Consolas Nintendo Switch",
  "categories": [
    "Tecnologia > Videojuegos > Consolas Nintendo Switch",
    "Tecnologia > Videojuegos",
    "Tecnologia",
    "Envio express",
    "Tecnologia > Videojuegos > Nintendo Switch 2"
  ],
  "productId": "2899372",
  "sku": "2899372",
  "ean": "2800028993722",
  "productReference": "2899372",
  "url": "https://www.oechsle.pe/consola-switch-2-system-solus-2899372/p",
  "price": 2599,
  "listPrice": 2599,
  "priceWithoutDiscount": 2599,
  "sellingPrice": 2599,
  "discountPercent": null,
  "discountAmount": 0,
  "hasDiscount": false,
  "pricePerUnit": 2599,
  "spotPrice": null,
  "currency": "PEN",
  "installments": null,
  "installmentsTable": [
    { "number": 1, "value": 2599, "interestRate": 0, "total": 2599, "paymentName": "SafetyPay a vista" }
  ],
  "priceValidUntil": "4000-01-02T00:00:00Z",
  "promoTeasers": null,
  "measurementUnit": "un",
  "unitMultiplier": 1,
  "releaseDate": "2025-06-17T00:00:00Z",
  "availableQuantity": 3,
  "isAvailable": true,
  "seller": "oechsle",
  "isMarketplace": false,
  "description": "En Oechsle tenemos para ti lo ultimo en Tecnologia, Consola Switch 2 System Solus. Adquierelo solo en Oechsle.pe. Ingresa aqui!",
  "specifications": {
    "Modelo": "BEE-S-KB5AA",
    "Color principal": "Multicolor",
    "Capacidad de almacenamiento": "256GB",
    "Tipo de consola": "Switch",
    "Garantia": "12 meses",
    "Vendido por": "Oechsle"
  },
  "observedAt": "2026-08-10T14:17:11.015Z",
  "error": null
}

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

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

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• 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.

Quickstart

Open the actor, paste this into the input, and press Run. It returns the 10 first 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.

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.
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.

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

Output reference

One dataset item per product offer. 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.
brand	string	Brand name, or null when not published.
category	string	Primary category path (breadcrumb).
categories	string[]	All category paths the product belongs to.
productId	string	Oechsle (VTEX) product ID.
sku	string	SKU identifier of the offer.
ean	string	EAN barcode, or null when not published.
productReference	string	Manufacturer or store product reference.
url	string	Direct link to the product page.
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.
currency	string	Currency code. Always PEN.
installments	object	Best single installment offer, or null.
installmentsTable	object[]	Every installment plan: number, value, interestRate, total, paymentName.
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.
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).
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.

Example output record

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

{
  "imageUrl": "https://oechsle.vteximg.com.br/arquivos/ids/21361078/2899372.jpg?v=638856836316870000",
  "name": "Consola Switch 2 System Solus",
  "brand": "NINTENDO",
  "category": "Tecnologia > Videojuegos > Consolas Nintendo Switch",
  "productId": "2899372",
  "sku": "2899372",
  "ean": "2800028993722",
  "url": "https://www.oechsle.pe/consola-switch-2-system-solus-2899372/p",
  "price": 2599,
  "listPrice": 2599,
  "sellingPrice": 2599,
  "hasDiscount": false,
  "discountAmount": 0,
  "currency": "PEN",
  "availableQuantity": 3,
  "isAvailable": true,
  "seller": "oechsle",
  "isMarketplace": false,
  "releaseDate": "2025-06-17T00:00:00Z",
  "specifications": {
    "Modelo": "BEE-S-KB5AA",
    "Capacidad de almacenamiento": "256GB",
    "Garantia": "12 meses",
    "Tipo de consola": "Switch"
  },
  "observedAt": "2026-08-10T14:17:11.015Z",
  "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~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. 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.

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.