# Metro Peru Supermarket Products API

> Metro Peru: hypermarket groceries and home products with prices, offers, stock, EAN and images

- Vendor: `metroperusupermarketproductsap` · version 1.0 · category Food · tags metro peru api, peru grocery api, supermarket prices api, grocery products api, ean products api, cencosud peru api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/metroperusupermarketproductsap
- This document: https://apiclay.com/docs/metroperusupermarketproductsap.md
- OpenAPI 3.1: https://apiclay.com/api/metroperusupermarketproductsap/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `metroperusupermarketproductsap`
- Updated: 2026-11-18

## About

## Metro Peru Supermarket Products API

The product catalog of Metro, Cencosud's supermarket and hypermarket chain across Peru: search groceries and home products by text, category or product id, each with name, brand, categories, link, description, EAN, unit and multiplier, images, price, list price and price without discount, available quantity, promotions and the product's specifications.

Data comes from **metro.pe** (https://www.metro.pe). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/products?ft=leche&amp;_from=0&amp;_to=9`, `/products?fq=productId:`.

### Routes

#### GET `/products` - Products
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| ft | query | string | no | Search text, e.g. `leche`. |
| fq | query | string | no | Filter, e.g. `productId:13559` or `C://` (category path). |
| _from | query | number | no | First result, from 0. |
| _to | query | number | no | Last result; at most 50 per call (`_to` - `_from` &lt; 50). |
| O | query | string | no | Sort: `OrderByPriceASC`, `OrderByPriceDESC`, `OrderByTopSaleDESC`, `OrderByReleaseDateDESC`, `OrderByNameASC`. |

Returns: Array of products: `productId`, `productName`, `brand`, `categories`, `link`, `description`, the specification fields and `items` (`itemId`, `ean`, `measurementUnit`, `unitMultiplier`, `images`, `sellers` with `commertialOffer`: `Price`, `ListPrice`, `PriceWithoutDiscount`, `AvailableQuantity`, `IsAvailable`, `PromotionTeasers`).

### Caveats

- Prices and stock are for online orders in Lima and can differ by store.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by metro.pe.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /products — Products
- Gateway: `GET https://api.apiclay.com/v1/api/metroperusupermarketproductsap/products`
- Public query params: `ft` (string), `fq` (string), `_from` (number), `_to` (number), `O` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/metroperusupermarketproductsap/products" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
