Conad 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.
What is the Conad 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.
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'
Retrieve all Conad stores operating in a given Italian province, optionally narrowed to one city (comune) within that province. Any of the 88 provinces listed on the site's coverage index is accepted (the Province enum). Each store entry carries the store format name, full street address, the city parsed from that address, and store_id, the numeric store identifier accepted by the product endpoints for store-specific pricing. store_id is resolved by sweeping the site's store lookup (which only returns stores within about 15 km of a point) across a grid around the provincial capital and matching each store by address; the sweep stops as soon as every store is matched, so a call costs one page request plus between 1 and 37 lookup requests. store_id is null when no lookup result shares the store's address (rare; observed on none of the tested provinces after the sweep). The city filter is applied locally to the city segment of each store address with a case-insensitive exact match; a city with no stores in the province returns an empty stores array (success). An unknown province slug returns upstream_error with status 404.
| Param | Type | Description |
|---|---|---|
| city | string | Optional city (comune) name within the province, matched case-insensitively against the city segment of each store address (e.g. 'Arese' or 'ARESE'). Omit to return every store in the province. |
| provincerequired | string | Province slug as the site's coverage pages spell it, lowercase (e.g. 'rimini', 'forli-cesena', 'ascolipiceno'); matched case-insensitively. |
{
"type": "object",
"fields": {
"city": "string or null, the city filter that was applied (null when no city filter was given)",
"stores": "array of store objects each with 'name' (store format), 'address' (full street address), 'city' (city name parsed from the address, uppercase as the site prints it), and 'store_id' (numeric string store identifier usable as store_id on product endpoints; null when the site's store lookup has no address match)",
"province": "string, the province slug that was queried (lowercased)"
},
"sample": {
"data": {
"city": "San Giovanni In Marignano",
"stores": [
{
"city": "SAN GIOVANNI IN MARIGNANO",
"name": "Conad City",
"address": "VIA GIUSEPPE GARIBALDI, 71, SAN GIOVANNI IN MARIGNANO, 47842",
"store_id": "003653"
}
],
"province": "rimini"
},
"status": "success"
}
}About the Conad API
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.
The Conad API is a managed, monitored endpoint for spesaonline.conad.it — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when spesaonline.conad.it changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official spesaonline.conad.it API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. 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.