continente.pt APIcontinente.pt ↗
Access Continente.pt product data via API: search by keyword, browse categories, fetch product details, promotions, and new arrivals from Portugal's top supermarket.
curl -X GET 'https://api.parse.bot/scraper/a780f8ac-a339-4881-91ad-a7ef7bf1935f/search_products?query=milk&start=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on Continente.pt. Returns paginated results with product listings including price, brand, and unit price information.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'milk', 'bread', 'chicken') |
| start | integer | Pagination offset for results |
{
"type": "object",
"fields": {
"start": "integer pagination offset used",
"products": "array of product objects with id, name, brand, category, price, pvpr, unit_price, quantity, promo_badge, url, image_url",
"total_count": "integer total number of matching products"
},
"sample": {
"data": {
"start": 0,
"products": [
{
"id": "8696608",
"url": "https://www.continente.pt/produto/leite-uht-magro-sem-lactose-continente-continente-8696608.html",
"name": "Leite UHT Magro sem Lactose Continente",
"pvpr": "",
"brand": "Continente",
"price": 1.08,
"category": "Laticínios e Ovos/Leite/Leite sem Lactose",
"quantity": "emb. 1 Lt",
"image_url": "https://www.continente.pt/dw/image/v2/BDVS_PRD/on/demandware.static/-/Sites-col-master-catalog/default/dw9cb5b74c/images/col/869/8696608-frente.jpg?sw=280&sh=280",
"unit_price": "1,08€/lt",
"promo_badge": null
}
],
"total_count": 1182
},
"status": "success"
}
}About the continente.pt API
The Continente.pt API exposes 5 endpoints covering product search, category browsing, product detail pages, active promotions, and new arrivals from Portugal's largest supermarket chain. The search_products endpoint returns paginated results with up to 11 fields per product — including current price, PVPR, unit price, brand, promo badge, and image URL — making it straightforward to build price-tracking or product discovery tools against Continente's full catalog.
Product Search and Category Browsing
The search_products endpoint accepts a query string and an optional start offset for pagination. Each result includes a total_count integer so you can determine how many pages to walk. Product objects in the response carry id, name, brand, category, price (current selling price in euros), pvpr (recommended retail price when it differs), unit_price, quantity, promo_badge, url, and image_url. The get_category_products endpoint works similarly but accepts a category slug corresponding to the URL path on the Continente site — for example, 'frescos/talho/' for the butchery subcategory. Note that not all category slugs are supported; some return a server error, so validate the slug against known working paths before relying on it in production.
Product Details, Promotions, and Novelties
get_product_detail takes a full product URL (typically sourced from the url field of any product object) and returns an expanded record that adds an images array containing multiple image URLs. This endpoint also surfaces nutritional data when the product page includes it. The get_promotions endpoint retrieves the current Oportunidades (deals) listing — all discounted products visible on that page at query time — and returns the same 11-field product shape with pagination support via start. Similarly, get_novelties pulls from Continente's Novidades section, returning newly launched products in the same paginated format.
Pricing Fields Explained
Several endpoints return both price and pvpr. price is the current selling price (a number in euros); pvpr is the recommended retail price as a string and is only meaningful when a discount is active. The unit_price field (e.g. "€1.20/kg") enables comparison across different package sizes. The promo_badge field carries any promotional label text shown on the listing, such as a percentage discount or a campaign name.
- Track price changes on specific products over time by polling
get_product_detailand comparing thepriceandpvprfields. - Build a Portuguese grocery price comparison tool using
search_productsresults across multiple supermarkets. - Monitor active deals by periodically calling
get_promotionsand alerting when new items appear orpromo_badgevalues change. - Populate a recipe cost estimator by querying
search_productsfor ingredients and usingunit_priceto normalize across package sizes. - Catalog new product launches in the Portuguese market using
get_noveltieson a daily schedule. - Build a category-level inventory snapshot for the butchery, bakery, or other departments via
get_category_productswith known slugs. - Aggregate nutritional data from
get_product_detailresponses to analyze supermarket product composition by category.
| 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 Continente.pt have an official developer API?+
What does `get_product_detail` return that the search and category endpoints don't?+
get_product_detail returns an images array with multiple product image URLs rather than a single image_url, and it includes nutritional information when that data is present on the product page. The search and category endpoints return only a single image_url and omit nutritional fields entirely.Are there limitations with the category slug used in `get_category_products`?+
'frescos/talho/'. It's worth testing slugs interactively before building automated pipelines that depend on them.