spesaonline.conad.it APIspesaonline.conad.it ↗
Access Conad's online grocery catalog, store locations by province, and category data via 5 structured endpoints. Products, prices, brands, and images included.
curl -X GET 'https://api.parse.bot/scraper/06ee45ae-1dba-4ce9-ae30-5a07b6011c0e/get_stores_by_province?province=milano' \ -H 'X-API-Key: $PARSE_API_KEY'
Get stores in a specific province. Returns store names and addresses parsed from the coverage area page.
| Param | Type | Description |
|---|---|---|
| provincerequired | string | Province slug (e.g., 'milano', 'roma', 'torino') |
{
"type": "object",
"fields": {
"stores": "array of store objects each with 'name' and 'address' strings",
"province": "string, the province slug that was queried"
},
"sample": {
"data": {
"stores": [
{
"name": "Conad",
"address": "VIA CEFALONIA, 10, MILANO, 20156"
},
{
"name": "Conad",
"address": "VIA UMBERTO CEVA, 2, MILANO, 20157"
}
],
"province": "milano"
},
"status": "success"
}
}About the spesaonline.conad.it API
The Conad Spesa Online API exposes 5 endpoints covering the full product catalog, store locations, and category structure from spesaonline.conad.it. get_products_by_category returns product code, name, brand, price, unit quantity, and image URL for every item in a given category. get_stores_by_province lists store names and addresses for any Italian province. Together these endpoints give structured access to Conad's grocery inventory and physical store network.
Product Catalog
get_products_by_category accepts a category_slug (e.g., frutta-e-verdura--01) and an optional 0-based page integer. Each product object in the response includes code, name, brand, base_price, price_per_unit, net_quantity, net_quantity_um, image_url, and category_le (the category hierarchy label). The response also surfaces subcategories — an array of child category names and URLs — making it straightforward to traverse the full category tree. Total result count is returned when available. Note that base_price may be 0.00 if no store session context is active.
Product Search and Detail
search_products accepts a query string and returns up to 40 products per page with the same product fields as the category endpoint, plus a displayed_title field showing the page heading the site returns. Without a store session, results are returned alphabetically across the full catalog regardless of the query string. get_product_detail accepts a slug in the format product-name--product-code (e.g., percorso-qualita-banane-cat-i-conad--50010977) and returns full product detail including multiple images, a bassi_fissi boolean flag indicating participation in the "bassi e fissi" fixed-low-price promotion, and a formatted price string alongside the numeric base_price.
Categories and Store Coverage
get_categories requires no input and returns the complete category list from the site's sitemap — each entry includes a full url and a slug for use in downstream category or product queries. get_stores_by_province accepts a province slug such as milano or roma and returns an array of store objects, each with name and address strings. Province coverage maps to Conad's physical store network across Italy.
- Build a grocery price tracker comparing
base_priceandprice_per_unitacross Conad product categories. - Populate a product database with Conad SKUs, brand names, and images using
get_products_by_categoryacross all slugs fromget_categories. - Map Conad store locations in a given Italian province using
get_stores_by_provincewith name and address data. - Flag products participating in the 'bassi e fissi' promotion using the
bassi_fissifield fromget_product_detail. - Traverse the full category hierarchy by combining
get_categoriesresults with thesubcategoriesarray returned per category. - Index Conad product images and metadata for a grocery comparison or meal-planning application.
- Monitor catalog breadth by querying total product counts across categories using the
totalfield in paginated responses.
| 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 Conad offer an official public developer API for spesaonline.conad.it?+
Why do some products show a price of 0.00?+
base_price and price_per_unit fields may return 0.00 even though the product record itself — name, brand, image, unit quantity — is fully populated. get_product_detail may return a non-null formatted price string in some cases even when the numeric base_price is zero.How does `search_products` behave without a store session?+
query string supplied. The displayed_title field reflects what the site returns as the page heading, which can help confirm what context the response was rendered under. Filtered, query-relevant results require a store session that is not currently supported by the API.Does the API return stock availability or inventory levels?+
Is store hours data available from `get_stores_by_province`?+
name and address per store. Opening hours are not included in the response. You can fork this API on Parse and revise it to add a detail endpoint that retrieves hours for individual store pages.