Metro Peru — product search & price scraper

Search Metro Peru's full online grocery catalog and get clean, structured prices in PEN on every run — names, brands, per-kilo prices, stock and product URLs.

🇵🇪 Peru · storefront: www.metro.pe · prices in PEN (PE)

Every run returns normalized product records — name, brand, current and list price in PEN, per-kilogram price, stock level, product and image URLs — ready for datasets, spreadsheets or dashboards. Fast, structured results: no manual copy-paste.

Use cases

• Grocery price monitoring — track daily and weekly price moves on Peruvian staples (rice, milk, oil, sugar) across Metro's catalog.
• Basket comparison — pair with the sibling chain scrapers (Wong, PlazaVea, Vivanda) and find the cheapest basket item by item; the normalized pricePerKg makes unit-price comparison trivial.
• Promo tracking — price vs listPrice exposes active discounts; inStock and availableQuantity flag availability gaps before promotions go live.
• Assortment and catalog feeds — brand, pack size (unitMultiplier, measurementUnit), image and URL fields for PIM imports, search indexes or price pages.
• Market research — build historical price series for CPG category analysis in the Peruvian market.

What it returns

• productKey — stable unique product ID for this store; join and dedupe on this, never the bare id
• name / brand — product display name and brand
• price / listPrice / currency — current and list price; the currency for this store is always PEN
• unitMultiplier / measurementUnit — pack size (a 5 kg bag → multiplier 5, unit kg)
• pricePerKg — normalized per-kilogram price when the weight is known, null otherwise
• availableQuantity / inStock — stock count (99999 means effectively unlimited) and availability flag
• url / imageUrl — product page and product image
• store / searchQuery / categoryResolved — run provenance: store slug, the query used, and whether the optional category filter resolved

Input

• search — required; free-text product search, e.g. arroz
• category — optional; free-text category to scope the search against the store's own category tree (e.g. huevos)
• maxPages — 1–5 result pages (default 1; 24 products per page)
• maxResults — cap on returned products (default 50, max 200)
• requestDelaySecs — politeness delay between result pages (default 1.0 s)

This record always searches www.metro.pe — no store selection is needed (or offered); every record of this family is fixed to one storefront.

Example queries

{"store": "metro", "search": "arroz", "maxResults": 10} {"store": "metro", "search": "leche gloria", "category": "lácteos", "maxResults": 5} {"store": "metro", "search": "pollo entero", "maxResults": 5} {"store": "metro", "search": "detergente", "maxResults": 20}

Output example

[
  {
    "productKey": "metro.pe:34075",
    "name": "Arroz Extra 5 kg",
    "brand": "Marca Blanca",
    "price": 26.9,
    "listPrice": 29.9,
    "currency": "PEN",
    "unitMultiplier": 5,
    "measurementUnit": "kg",
    "availableQuantity": 147,
    "pricePerKg": 5.38,
    "inStock": true,
    "url": "https://www.metro.pe/arroz-extra-5kg/p",
    "imageUrl": "https://www.metro.pe/arquivos/ids/34075/arroz-extra.jpg",
    "store": "metro",
    "searchQuery": "arroz",
    "categoryResolved": true
  }
]

Quirks

• Metro shares its product catalog with Wong (both are Cencosud chains), so overlapping product IDs are normal — always join and dedupe on productKey, never the bare id.
• Category scoping uses Metro's own category tree: a category name that resolves on another chain may not resolve here. When it doesn't, the run still completes as a plain search and records carry categoryResolved: false.
• Pack sizes dominate pricing on groceries — compare offers on pricePerKg (or price / unitMultiplier), not shelf price.