Plaza Vea Scraper

Here is one real result, with every field the actor returns (long installmentsTable, productClusters and the HTML in specifications trimmed for readability; the actor returns the full values):

{
  "name": "Arroz Extra COSTEÑO Bolsa 5Kg",
  "brand": "COSTEÑO",
  "category": "Abarrotes > Arroz > Arroz Extra",
  "categories": [
    "Abarrotes > Arroz > Arroz Extra",
    "Abarrotes > Arroz",
    "Abarrotes"
  ],
  "productId": "836",
  "sku": "565",
  "ean": "7755139246890",
  "referenceId": "641425",
  "productReference": "641425",
  "price": 21.9,
  "listPrice": 25.9,
  "priceWithoutDiscount": 25.9,
  "sellingPrice": 21.9,
  "currency": "PEN",
  "availableQuantity": 498,
  "isAvailable": true,
  "seller": "Plaza Vea",
  "measurementUnit": "un",
  "unitMultiplier": 1,
  "rewardValue": 0,
  "tax": 0,
  "releaseDate": "2015-10-19T00:00:00Z",
  "priceValidUntil": "3000-01-02T05:00:00Z",
  "promoTeasers": [
    "Promo Oh-Pay",
    "TARJETA OH - PVEA"
  ],
  "installmentsTable": [
    { "number": 1, "value": 21.9, "interestRate": 0, "total": 21.9, "paymentName": "Safetypay à vista" }
  ],
  "productClusters": [
    "Lo más buscado en el Supermercado",
    "Abarrotes"
  ],
  "description": "¡Compra Online Arroz Extra COSTEÑO Bolsa 5Kg desde donde estés en plazaVea.com.pe!",
  "specifications": {
    "Vendido por": "plazaVea",
    "Contenido Neto": "5Kg",
    "Denominación/Variedad": "Extra Graneadito",
    "Presentación/Empaque": "Bolsa",
    "Descripción del producto": "[HTML trimmed]"
  },
  "imageUrl": "https://plazavea.vteximg.com.br/arquivos/ids/27552451/641425.jpg?v=638313121271170000",
  "images": [
    "https://plazavea.vteximg.com.br/arquivos/ids/27552451/641425.jpg?v=638313121271170000"
  ],
  "url": "https://www.plazavea.com.pe/arroz-extra-costeno-bolsa-5kg/p",
  "observedAt": "2026-08-10T14:39:43.684Z",
  "error": null
}

The most complete Plaza Vea scraper available. It returns every field the Plaza Vea (VTEX) catalog exposes per product offer, including price, list price, EAN, stock, installment plans, promo teasers, product clusters and full specifications, and gives you search, category 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 Plaza Vea (Peru) VTEX catalog by search term, department category or an advanced start URL, paginates the results, and writes one normalized record per product offer to the run's dataset. Each available SKU and seller is one record. Prices, list prices, discounts, stock, EAN, installment plans, promo teasers, product clusters and the full specification block are all captured. Missing source values are returned as null, never invented.

Provide a searchTerm, a categoryId, or a startUrl. You can combine a search term with a category to search within a department, and set sortOrder to control the order the catalog returns products.

Quickstart

Open the actor, paste this into the input, and press Run. It returns up to 10 products matching arroz (rice).

{
  "maxProducts": 10,
  "searchTerm": "arroz",
  "categoryId": "",
  "sortOrder": ""
}

Leave searchTerm empty and set categoryId to browse a whole department, or paste an advanced VTEX catalog URL into startUrl to control every query parameter.

Input reference

Field	Type	Required	Default	Description
searchTerm	string	no	arroz	Full-text query against the Plaza Vea catalog, for example leche gloria, televisor. Maps to the VTEX ft parameter.
categoryId	enum	no	(all)	Restrict to one department. Maps to the VTEX fq=C: filter. Options range across groceries, drinks, dairy, meat, cleaning, technology, home appliances and more. Combine with searchTerm to search within a department.
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.
sortOrder	enum	no	(relevance)	Order the catalog returns products. One of OrderByPriceASC, OrderByPriceDESC, OrderByTopSaleDESC, OrderByReviewRateDESC, OrderByNameASC, OrderByNameDESC, OrderByReleaseDateDESC, OrderByBestDiscountDESC. Maps to the VTEX O parameter.
maxProducts	integer	no	10	Maximum number of product offers to collect. Each available SKU and seller is one record.

Output reference

One dataset item per product offer. Types: string, number, boolean, string[], object, object[], or null when the source value is absent.

Field	Type	Description
name	string	Product name.
brand	string	Brand name.
category	string	Primary category path.
categories	string[]	All category paths the product appears in.
productId	string	VTEX product id.
sku	string	SKU id (unique per variant).
ean	string	EAN barcode, or null.
referenceId	string	Manufacturer or catalog reference id.
productReference	string	VTEX product reference code.
price	number	Current price in currency.
listPrice	number	List price before discount.
priceWithoutDiscount	number	Price without discount.
sellingPrice	number	Selling price.
currency	string	Currency code, always PEN.
availableQuantity	integer	Units available for the offer.
isAvailable	boolean	true when the offer is purchasable.
seller	string	Seller name.
measurementUnit	string	Unit of measure, for example un.
unitMultiplier	number	VTEX unit multiplier.
rewardValue	number	Loyalty reward value.
tax	number	Tax amount.
releaseDate	string	Product release date (ISO 8601).
priceValidUntil	string	Date the price is valid until (ISO 8601).
promoTeasers	string[]	Active promotion teaser names.
installmentsTable	object[]	Installment plans, each with number, value, interestRate, total, paymentName.
productClusters	string[]	VTEX product cluster labels the product belongs to.
description	string	Short product description.
specifications	object	Full specification key/value block, including packaging, net content and the HTML product description.
imageUrl	string	Primary image URL.
images	string[]	All product image URLs.
url	string	Product page URL.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed run, an item with a populated error field is written instead.

Example output record

Real record from a live run (input {"searchTerm": "arroz", "maxProducts": 10}), core offer fields shown:

{
  "name": "Olla Arrocera BLACK+DECKER 22 Tazas RC5225-CL Blanco",
  "brand": "BLACK+DECKER",
  "category": "Electrohogar > Electrodomésticos de Cocina > Ollas Arroceras",
  "productId": "18244",
  "sku": "18164",
  "ean": null,
  "price": 119,
  "listPrice": 149,
  "priceWithoutDiscount": 149,
  "sellingPrice": 119,
  "currency": "PEN",
  "availableQuantity": 614,
  "isAvailable": true,
  "seller": "Plaza Vea",
  "measurementUnit": "un",
  "promoTeasers": [
    "Promo-Tarjeta-Oh-Lurin-Oculto",
    "TARJETA OH - PVEA"
  ],
  "url": "https://www.plazavea.com.pe/olla-arrocera-black-decker-2-2l-rc5225-blanco/p",
  "observedAt": "2026-08-10T14:39:43.979Z",
  "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~plazavea-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerm":"leche gloria","maxProducts":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~plazavea-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"categoryId":"814","sortOrder":"OrderByPriceASC","maxProducts":100}'

Apify CLI:

apify call scrapers_lat/plazavea-scraper \
  --input '{"searchTerm":"televisor","sortOrder":"OrderByBestDiscountDESC"}'

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 offer returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. If a run 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 products per run. Upgrade for higher maxProducts.

FAQ and troubleshooting

A run returned 0 records. Why? The search term or category matched nothing, or the start URL had no results. Try a broader term, or clear categoryId. Zero-result runs are not charged.

How do I browse a whole department? Leave searchTerm empty and set categoryId to the department you want, for example 814 for Meat, Poultry and Fish. Combine both to search within a department.

Can I control the exact catalog query? Yes. Paste a full VTEX catalog search URL into startUrl. Its query parameters (ft, fq, O) are used as-is and take precedence.

Why is ean null on some products? Plaza Vea does not publish a barcode for every item (common for appliances and non-food products). Missing source values are returned as null, never invented.

What currency are prices in? Peruvian Sol (PEN). Plaza Vea operates in Peru.

Is this an official Plaza Vea tool? No. This actor is independent and has no affiliation with Plaza Vea or Intercorp. It reads only data that is publicly available on the Plaza Vea catalog.

Related scrapers

• Cruz Verde Scraper: pharmacy product prices.
• Coto Argentina Scraper: grocery prices in Argentina.
• Chedraui Scraper: supermarket prices in Mexico.
• Exito Scraper: retail product catalog in Colombia.
• Elektra Scraper: electronics and appliance prices.
• Falabella Scraper: department store product catalog.

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 Plaza Vea or Intercorp. Accesses only publicly available catalog data.