# Plaza Vea Peru Grocery Products API

> Plaza Vea Peru: grocery and home products with prices, stock, EAN, images and nutrition facts

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

## About

## Plaza Vea Peru Grocery Products API

The product catalog of Plaza Vea, one of Peru's largest supermarket chains: 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, which for food include ingredients, allergens and nutrition per serving (calories, protein, carbohydrates, sugar, fat, sodium).

Data comes from **plazavea.com.pe** (https://www.plazavea.com.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:70757`.

### 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:70757` or `C:/2/` (category id 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 (e.g. `Calorías Por Porción`, `Proteínas Por Porción`, `Alérgenos Declarados`) and `items` (`itemId`, `ean`, `measurementUnit`, `unitMultiplier`, `images`, `sellers` with `commertialOffer`: `Price`, `ListPrice`, `PriceWithoutDiscount`, `AvailableQuantity`, `IsAvailable`, `PromotionTeasers`).

### Caveats

- Prices and stock are for online orders and can differ by store and delivery area.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by plazavea.com.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/plazaveaperugroceryproductsapi/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/plazaveaperugroceryproductsapi/products" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

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