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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace spesaonline-conad-it-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Conad grocery catalog: browse categories, search products, fetch details."""
from parse_apis.conad_spesa_online_api import Conad, Province, ProductNotFound
client = Conad()
# List stores available in Milano
for store in client.stores.list(province=Province.MILANO, limit=3):
print(store.name, store.address)
# Browse categories and drill into one
category = client.categories.list(limit=1).first()
if category:
for product in category.products.list(limit=3):
print(product.name, product.brand, product.price_per_unit)
# Search products by keyword
item = client.productsummaries.search(query="latte", limit=1).first()
if item:
# Navigate from summary to full detail
detail = item.details()
print(detail.title, detail.base_price, detail.net_quantity_um)
# Direct product lookup by slug with error handling
try:
product = client.products.get(slug="percorso-qualita-banane-cat-i-conad--50010977")
print(product.title, product.brand, product.bassi_fissi)
except ProductNotFound as exc:
print(f"Product gone: {exc.slug}")
print("exercised: stores.list / categories.list / category.products.list / productsummaries.search / details / products.get")
Retrieve all Conad stores operating in a given Italian province. Each store entry carries the store format name and full street address. The province slug corresponds to the Italian city/province name in lowercase.
| Param | Type | Description |
|---|---|---|
| provincerequired | string | Province slug in lowercase Italian (e.g., 'milano', 'roma', 'torino', 'firenze') |
{
"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 FRANCESCO GONIN, 71, MILANO, 20147"
},
{
"name": "Conad City",
"address": "CORSO SAN GOTTARDO, 29, MILANO, 20136"
}
],
"province": "milano"
},
"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 | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 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.