Promart Peru Hardware Price Scraper

Here is one real result, with every field the actor returns:

{
  "imageUrl": "https://promart.vteximg.com.br/arquivos/ids/9682736/155192.jpg?v=639190335621000000",
  "images": [
    "https://promart.vteximg.com.br/arquivos/ids/9682736/155192.jpg?v=639190335621000000",
    "https://promart.vteximg.com.br/arquivos/ids/9682737/155192_10.jpg?v=639190335621270000"
  ],
  "name": "Taladro Percutor Werken KF-CD2110-34PZ-BMC 20V 1.5 Ah + 37 Accesorios",
  "url": "https://www.promart.pe/taladro-percutor-werken-kf-cd2110-34pz-bmc-20v-1-5-ah-37-accesorios-155192/p",
  "productId": "155192",
  "sku": "155192",
  "productReference": "155192",
  "brand": "Werken",
  "category": "Herramientas > Herramientas eléctricas portátiles > Taladros",
  "ean": "2000001551929",
  "price": 149,
  "listPrice": 179,
  "discountPercent": 17,
  "discountAmount": 30,
  "hasDiscount": true,
  "pricePerUnit": 149,
  "spotPrice": null,
  "currency": "PEN",
  "available": true,
  "stock": 311,
  "seller": "Promart",
  "sellerId": "1",
  "isMarketplace": false,
  "measurementUnit": "un",
  "unitMultiplier": 1,
  "releaseDate": "2024-08-14T00:00:00Z",
  "priceValidUntil": "2027-08-10T14:17:09Z",
  "promoTeasers": ["OH- TP531"],
  "installmentsTable": [
    { "number": 1, "value": 149, "interestRate": 0, "total": 149, "paymentName": "AGORAWEB à vista" }
  ],
  "description": "Taladro Percutor Werken KF-CD2110-34PZ-BMC 20V 1.5 Ah + 37 Accesorios. Disfruta de lo más nuevo que Promart.pe trae para ti.",
  "specifications": {
    "Color principal": "Negro",
    "Garantía": "3 Años",
    "Modelo": "KF-CD2110-34PZ-BMC",
    "Voltaje": "20 V",
    "Material": "Acero",
    "Inalámbrico": "Sí"
  },
  "observedAt": "2026-08-10T14:17:09.000Z",
  "error": null
}

The most complete Promart Peru scraper available. It returns every price and catalog field the store exposes, including selling price and list price in soles, discount, EAN, SKU, brand, stock, seller, installment plans and a full specifications object, and gives you keyword search, 30 department filters, price and brand filters, sort order and an in-stock toggle to target exactly the offers 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 searches the Promart Peru catalog (VTEX) by the keywords and departments you pass, applies your price, brand, stock and sort filters, paginates through the matches, and writes one normalized record per available SKU and seller to the run's dataset. Every record carries the price fields in soles (PEN), discount, identifiers (productId, SKU, EAN, reference), brand, category, seller and availability. When withDetails is on (the default), each record also includes the long description and a structured specifications object (material, model, warranty, dimensions and more). Missing source values are returned as null.

Data covers Peru only. Results from multiple search terms and categories are merged and de-duplicated in a single run.

Quickstart

Open the actor, paste this into the input, and press Run. It returns up to 10 "taladro" (drill) offers with details.

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

Every input field is optional. Combine several searchTerms and categories in one run, narrow with minPrice/maxPrice or brands, set onlyAvailable to skip out-of-stock items, and sortOrder to control the catalog order.

Input reference

Field	Type	Required	Default	Description
searchTerms	string[]	no	["taladro"]	Full-text queries against the Promart catalog, for example taladro, pintura, cemento. Each term is searched separately (VTEX ft).
categories	string[]	no	(all)	Restrict to one or more Promart departments by ID (VTEX fq=C:). 30 departments are available, for example 17 Herramientas (Tools), 16 Ferreteria (Hardware), 19 Pinturas (Paint), 15 Construccion.
maxProducts	integer	no	10	Maximum product offers to collect across all searches and categories. Each available SKU and seller is one record. Free Apify plans are capped at 10 per run.
withDetails	boolean	no	true	When on, each record also includes the product description and a specifications object.
sortOrder	enum	no	(relevance)	Catalog order (VTEX O). One of OrderByPriceASC, OrderByPriceDESC, OrderByTopSaleDESC, OrderByReviewRateDESC, OrderByNameASC, OrderByNameDESC, OrderByReleaseDateDESC, OrderByBestDiscountDESC. Empty keeps relevance.
minPrice	integer	no	(none)	Only return offers with a selling price at or above this amount in soles.
maxPrice	integer	no	(none)	Only return offers with a selling price at or below this amount in soles.
brands	string[]	no	(all)	Keep only products whose brand matches one of these names (case-insensitive, partial), for example Bosch, Stanley, Truper.
onlyAvailable	boolean	no	false	When on, only products currently in stock are returned.

Output reference

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

Field	Type	Description
imageUrl	string	Main product image URL.
images	string[]	All product image URLs.
name	string	Product name.
url	string	Direct product page URL.
productId	string	Promart product ID.
sku	string	SKU identifier.
productReference	string	Manufacturer / catalog reference code.
brand	string	Brand name.
category	string	Category breadcrumb.
ean	string	EAN barcode.
price	number	Current selling price (PEN).
listPrice	number	List / reference price (PEN).
discountPercent	integer	Discount percentage off list price.
discountAmount	number	Discount amount in soles.
hasDiscount	boolean	true when the price is below list price.
pricePerUnit	number	Price per measurement unit (PEN).
spotPrice	number	Spot / cash price when published, else null.
currency	string	Currency code. Always PEN.
available	boolean	true when the SKU is buyable.
stock	integer	Available stock quantity.
seller	string	Seller name.
sellerId	string	Seller ID (1 for Promart first-party).
isMarketplace	boolean	true for a third-party marketplace seller.
measurementUnit	string	Selling unit, for example un.
unitMultiplier	number	Unit multiplier for the price.
releaseDate	string	Catalog release date (ISO 8601).
priceValidUntil	string	Price validity timestamp (ISO 8601).
promoTeasers	string[]	Active promotion labels.
installmentsTable	object[]	Installment plans, each with number, value, interestRate, total, paymentName.
description	string	Long product description (when withDetails is on).
specifications	object	Attribute map (material, model, warranty, dimensions and more) when withDetails is on.
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 {"searchTerms":["taladro"],"withDetails":true}). The images, installmentsTable and specifications are trimmed here to keep the sample short; every value shown is unchanged from the live record:

{
  "imageUrl": "https://promart.vteximg.com.br/arquivos/ids/9682736/155192.jpg?v=639190335621000000",
  "name": "Taladro Percutor Werken KF-CD2110-34PZ-BMC 20V 1.5 Ah + 37 Accesorios",
  "url": "https://www.promart.pe/taladro-percutor-werken-kf-cd2110-34pz-bmc-20v-1-5-ah-37-accesorios-155192/p",
  "productId": "155192",
  "sku": "155192",
  "brand": "Werken",
  "category": "Herramientas > Herramientas eléctricas portátiles > Taladros",
  "ean": "2000001551929",
  "price": 149,
  "listPrice": 179,
  "discountPercent": 17,
  "discountAmount": 30,
  "hasDiscount": true,
  "currency": "PEN",
  "available": true,
  "stock": 311,
  "seller": "Promart",
  "sellerId": "1",
  "isMarketplace": false,
  "releaseDate": "2024-08-14T00:00:00Z",
  "promoTeasers": ["OH- TP531"],
  "specifications": {
    "Color principal": "Negro",
    "Garantía": "3 Años",
    "Modelo": "KF-CD2110-34PZ-BMC",
    "Voltaje": "20 V"
  },
  "observedAt": "2026-08-10T14:17:09.000Z",
  "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~promart-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms":["taladro"],"maxProducts":25,"withDetails":true}'

Start a run asynchronously:

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

Apify CLI:

apify call scrapers_lat/promart-scraper \
  --input '{"searchTerms":["pintura","cemento"],"sortOrder":"OrderByPriceASC"}'

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 finds nothing or errors, the actor writes a single item with an 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.
• Source ceiling. The catalog returns up to roughly the first 2,500 products per search or department. Narrow very broad queries with a keyword, department or sort order.

FAQ and troubleshooting

What can I search on Promart? Search the full catalog by keyword (for example taladro, pintura, cemento), or restrict results to departments like Herramientas, Ferreteria, Pinturas y Acabados or Construccion. Combine several terms and departments in one run; results are merged and de-duplicated.

Does it include product descriptions and specifications? Yes. Keep withDetails on and every record carries the long description and a structured specifications object with attributes such as material, model, color and warranty.

Are prices in soles? Yes. Every price field is in Peruvian soles and each record carries currency PEN.

What happens to products with missing data? Fields like brand or EAN are only filled when the store publishes them, so they may be null on some products. Every record always includes price, availability, identifiers, category and a direct product link.

Can I compare first-party and marketplace offers? Yes. seller, sellerId and isMarketplace identify whether an offer is sold by Promart or a third-party marketplace seller.

Is this an official Promart tool? No. This actor is independent and has no affiliation with Promart or InRetail. It accesses only data that is publicly available on the platform.

Example tasks

Preconfigured templates for common scenarios. Open one and press Run, or use it as a starting point:

• Aire Acondicionado Price Peru
• Cemento Sol Price Peru
• Ceramico Piso Price Peru
• Cocina a Gas Price Peru
• Escalera Aluminio Price Peru
• Herramientas Stanley Price Peru
• Inodoro Trebol Price Peru
• Pintura Latex Price Peru
• Taladro Bosch Price Peru
• Terma Electrica Price Peru

Related scrapers

• Chedraui Mexico Grocery Price Scraper: Chedraui Mexico prices, EAN, stock and installments.
• Dia Argentina Grocery Price Scraper: Dia Argentina prices, stock, EAN and sellers.
• Elektra Mexico Product Price Scraper: Elektra Mexico prices, installments and sellers.
• Exito Colombia Grocery Price Scraper: Exito Colombia product prices and stock.
• MercadoLibre Product Listings Scraper: products, prices and sellers 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 Promart or InRetail. Accesses only data that is publicly available on the platform. Use it in accordance with Promart's terms of service.