pingodoce.pt APIpingodoce.pt ↗
Access Pingo Doce product data, current promotions, store locations, recipes, and digital leaflets via 7 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/dfc0c785-3e6b-4512-92f8-2e52c1ca6c74/get_promotions?limit=12&start=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch current promotional products from the store catalog. Returns paginated results of products currently on promotion.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of products to return per page. |
| start | integer | Offset for pagination (0-based index of the first result). |
| category_id | string | Category ID for promotions filtering. |
{
"type": "object",
"fields": {
"count": "integer, number of products returned",
"products": "array of product objects with id, name, brand, price, original_price, discount, promo_label, unit, category, image, url"
},
"sample": {
"data": {
"count": 12,
"products": [
{
"id": "889026",
"url": "https://www.pingodoce.pt/home/produtos/as-nossas-marcas/pingo-doce/ovos-de-solo-classe-l-pingo-doce-889026.html",
"name": "Ovos de Solo Classe L",
"unit": "12 Un | 0,26 €/Un",
"brand": "Pingo Doce",
"image": "https://www.pingodoce.pt/dw/image/v2/BLJJ_PRD/on/demandware.static/-/Sites-pingo-doce-master/default/dwd3dc090e/images/medium/889026_5131f136a58a804e507b60fc0a1bd02e.jpg?sw=198",
"price": 3.09,
"category": "Pingo Doce",
"discount": null,
"promo_label": "Apenas",
"original_price": 3.29
}
]
},
"status": "success"
}
}About the pingodoce.pt API
The Pingo Doce API covers 7 endpoints that expose product catalog data, live promotions, store locations, digital leaflets, and recipes from Portugal's Pingo Doce supermarket chain. The search_products endpoint accepts a keyword query and returns product objects including price, brand, discount, and category. The get_product_details endpoint goes further, adding nutritional data, country of origin, and a full product description for individual items.
Product Catalog and Promotions
The search_products endpoint takes a query string (e.g. 'leite' or 'azeite') plus optional limit and start parameters for pagination. It returns an array of product objects, each carrying id, name, brand, price, original_price, discount, promo_label, unit, category, image, and url. The get_promotions endpoint returns the same product shape but scoped to currently promoted items; it also accepts an optional category_id to narrow results to a specific department.
Product Detail and Categories
get_product_details accepts a full product url and returns richer fields: current_price, original_price, description, origin (country of origin when the source carries it), and a nutrition array of {name, value} pairs for products that include nutritional data. Fields like origin and nutrition are null or empty when the source does not list them for a given product. get_product_categories requires no inputs and returns every top-level category with its name, url, and cgid identifier, which can then feed the category_id filter in get_promotions.
Stores, Leaflets, and Recipes
get_stores locates physical Pingo Doce stores using lat, lng, and radius (in meters). Each store object in the response includes id, name, address1, city, postalCode, latitude, longitude, services, and structured storeHours. get_folhetos returns the current promotional leaflets and catalogs as an array of objects with title, url, and image—no parameters needed. get_receitas fetches recipes, with an optional query parameter to filter by keyword; each recipe object contains title, url, and image.
- Monitor price changes and discount depth on specific products using
original_priceanddiscountfields fromsearch_products. - Build a Portuguese grocery price comparison tool by querying product categories and paginating through
get_promotions. - Display a store locator map by feeding coordinates into
get_storesand rendering the returnedlatitude,longitude, andstoreHours. - Aggregate weekly deal sheets by fetching
get_folhetoson a schedule and tracking new or changed leaflet URLs. - Generate meal-planning content by combining
get_receitasrecipe results with matching product searches. - Track nutritional information for a product set using the
nutritionarray returned byget_product_details. - Feed a category-browsing UI by using
cgidvalues fromget_product_categoriesas filters in subsequent promotion queries.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Pingo Doce offer an official public developer API?+
What does `get_product_details` return that the search and promotions endpoints do not?+
get_product_details returns description, origin (country of origin), and a nutrition array of name-value pairs. These fields are absent from search_products and get_promotions, which return catalog-level data. Note that origin and nutrition are null or empty for products where Pingo Doce does not list that information.How does pagination work across the catalog endpoints?+
search_products and get_promotions both support limit (results per page) and start (zero-based offset) parameters. The response includes a count field indicating how many results were returned in the current page, not the total catalog size. You increment start by limit to walk through pages.Does the API return product reviews or customer ratings?+
Are recipe details like ingredient lists or step-by-step instructions included in `get_receitas`?+
get_receitas endpoint returns title, url, and image for each recipe—full ingredient lists and preparation steps are not included in the response. You can fork this API on Parse and revise it to build a recipe detail endpoint using the returned url.