Deza Calidad APIdezacalidad.es ↗
Access Deza Calidad supermarket store locations and current promotional offers ('Precio naranja') in Córdoba, Spain via a structured JSON API.
What is the Deza Calidad API?
The Deza Calidad API provides 3 endpoints covering store locations and current promotional product data from Deza Calidad supermarkets in Córdoba, Spain. get_stores returns all ~13 store locations with address, phone, and slug. get_current_offers delivers paginated 'Precio naranja' promotions with per-store availability. get_product_detail lets you search the product catalog by name and retrieve matching promotion status and store coverage.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/2bd939af-bb48-45dc-b5c2-6623e94db333/get_stores' \ -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 dezacalidad-es-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.
"""Walkthrough: DezaCalidad SDK — bounded, re-runnable; every call capped."""
from parse_apis.dezacalidad_es_api import DezaCalidad, ParseError
client = DezaCalidad()
# List all store locations
for store in client.stores.list(limit=3):
print(store.name, store.address, store.locality)
# Browse current promotional offers (paginated)
for offer in client.offers.list(limit=3):
print(offer.product_name, offer.is_promotion, offer.available_stores[:2])
# Search for a specific product by name
results = client.products.search(product_name="Fino spritz ALVEAR", limit=1).first()
if results:
print(results.product_name, results.labels, results.observation_timestamp)
# Typed error handling
try:
for p in client.products.search(product_name="nonexistent_xyz_12345", limit=1):
print(p.product_name)
except ParseError as e:
print(f"error: {e}")
print("exercised: stores.list / offers.list / products.search")
Retrieves all Deza Calidad store locations with address, locality, postal code, and phone. Each store is identified by its URL slug. All stores returned in a single response (typically ~13).
No input parameters required.
{
"type": "object",
"fields": {
"total": "total number of stores",
"stores": "array of store objects with name, slug, address, postal_code, locality, phone, and url"
},
"sample": {
"total": 13,
"stores": [
{
"url": "https://www.dezacalidad.es/centros/avda-de-jesus-rescatado/",
"name": "Avda Jesús Rescatado",
"slug": "avda-de-jesus-rescatado",
"phone": "957 076 802",
"address": "Avda. Jesús Rescatado, 15",
"locality": "Córdoba",
"postal_code": "14010"
}
]
}
}About the Deza Calidad API
Store Locations
get_stores takes no parameters and returns all Deza Calidad store locations in a single response. Each store object includes name, slug, address, postal_code, locality, phone, and a url. The slug field serves as the store identifier used elsewhere in the API. Typically ~13 stores are returned.
Current Promotional Offers
get_current_offers retrieves products currently marked as 'Precio naranja' (orange price promotions). Results are paginated — pass page (1-based integer) and limit (1–60) to control which slice you receive. Each offer object includes product_name, labels, is_promotion (boolean), available_stores (list of stores carrying the product), and observation_timestamp. The response also returns total_pages so you can walk the full result set programmatically.
Product Search
get_product_detail accepts a required product_name string — partial names work, e.g. 'Fino spritz ALVEAR'. It searches the Deza Calidad catalog and returns up to 10 matching products. Each result includes product_name, labels, is_promotion, available_stores, source_url, and observation_timestamp. There are no numeric product IDs; products are addressed entirely by name string.
Coverage Notes
This API covers one regional supermarket chain operating in Córdoba, Spain. Data reflects current in-store promotional offers; historical offer archives and loyalty card pricing are not exposed. The observation_timestamp field on offer and product objects indicates when the data was last recorded.
The Deza Calidad API is a managed, monitored endpoint for dezacalidad.es — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when dezacalidad.es 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 dezacalidad.es 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?+
- Track which Deza Calidad stores currently carry a specific product on promotion using
available_stores - Build a price-alert tool that monitors
is_promotionchanges for products returned byget_current_offers - Generate a store directory for Córdoba using address, postal code, and phone from
get_stores - Identify all active 'Precio naranja' deals in a single paginated sweep via
get_current_offers - Search for a product by partial name using
get_product_detailto check promotion status before visiting a store - Map store slugs to promotional product availability across the ~13 locations
| 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 Deza Calidad offer an official developer API?+
What does `get_current_offers` return and how does pagination work?+
get_current_offers returns products currently flagged as 'Precio naranja' promotions. Each response includes a page number, count of items in that page, total_pages, and an offers array. Set limit between 1 and 60 and increment page to walk the full result set. Each offer includes product_name, labels, is_promotion, available_stores, and observation_timestamp.Does the API return product prices or historical offer data?+
is_promotion), product labels, and store availability, but does not expose numeric prices or a history of past offers. You can fork this API on Parse and revise it to add a pricing or history endpoint if that data becomes accessible on the source.Does `get_product_detail` cover the full product catalog, including non-promoted items?+
is_promotion on each result indicates whether a matched product is currently on promotion. However, it returns at most 10 matches per query and products are identified by name string only; there are no numeric IDs or individual product URLs beyond source_url.