Albert APIalbert.cz ↗
Access Albert.cz grocery data via 9 endpoints: recipes with ingredients and steps, promotional leaflet product prices, store locations, and magazine content.
What is the Albert API?
The Albert.cz API exposes 9 endpoints covering Czech grocery chain Albert's recipe catalog, promotional leaflets with OCR-extracted product pricing, store finder, and editorial content. Use get_leaflet_products to pull current weekly deal prices in CZK, or search_recipes to query thousands of recipes by keyword with pagination, ratings, difficulty, and preparation time in a single response.
curl -X GET 'https://api.parse.bot/scraper/1959d942-293a-4889-8d0c-9ecdcfdfa36e/search_recipes?page=0&query=smoothie' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for recipes by keyword with optional pagination. Returns paginated results with recipe IDs, titles, ratings, difficulty, preparation time, and image URLs.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed) |
| query | string | Search keyword (e.g. 'smoothie', 'kuřecí', 'salát') |
{
"type": "object",
"fields": {
"facets": "array of available filter facets",
"results": "array of recipe summaries with id, title, rating, difficultyName, preparationTimeName",
"pagination": "object with currentPage, totalResults, totalPages, pageSize"
},
"sample": {
"data": {
"facets": [
{
"code": "preparationTimeEnumValue",
"name": "Doba přípravy",
"values": [
{
"code": "LESSTHANEQUALS15",
"name": "0-15 minut",
"count": 42
}
]
}
],
"results": [
{
"id": "a1938",
"title": "Kiwimangové Smoothie",
"rating": "4/5",
"difficultyName": "Velmi snadné",
"preparationTimeName": "16-30 minut"
}
],
"pagination": {
"pageSize": 12,
"totalPages": 5,
"currentPage": 0,
"totalResults": 52
}
},
"status": "success"
}
}About the Albert API
Recipes
The search_recipes endpoint accepts a query string (Czech or keyword, e.g. 'kuřecí', 'salát') and an optional zero-indexed page parameter. Results include id, title, rating, difficultyName, and preparationTimeName alongside a pagination object with totalResults and totalPages. Pass any returned id to get_recipe_detail to retrieve full recipeCookingSteps (numbered steps), fractionalRecipeIngredients (with ingredientName, quantity, measureUnit), servings, and structured nutrition data. list_recipe_categories returns filterable facets for preparation time, difficulty, and special diet, each with a count of matching recipes.
Promotional Leaflets and Deals
get_current_leaflets returns active Hypermarket and Supermarket leaflets with validityStartDateFormatted, validityEndDateFormatted, imageUrl, and a viewUrl from which the leaflet slug is extracted. Supply that slug to get_leaflet_detail to retrieve per-page OCR text and image URLs for every spread. For a pre-parsed view, get_leaflet_products merges current general Hypermarket and Supermarket weekly leaflets into one products array, where each row carries name, price (promo price in CZK), original_price (or null), and discount_percent. The leaflets array in the same response includes valid_from, valid_to, slug, and product_count for each source leaflet.
Store Finder
find_stores accepts an optional query (e.g. 'Praha', 'Brno'). With a query, results include address, description, groceryStoreType, storeServices, and geoPoint coordinates, along with filter facets for store type and available services. Without a query, the endpoint returns all store map pins with coordinates, useful for building geographic store maps.
Magazine and Monthly Deals
get_magazine_articles and get_monthly_deals both return CMS page structures keyed by component IDs, containing article text blocks, recipe carousels, promotional images, and banner components. These endpoints return meta objects with product, version, and branch fields alongside the full page component tree.
The Albert API is a managed, monitored endpoint for albert.cz — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when albert.cz 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 albert.cz 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 Czech recipe search app filtering by difficulty and diet type using
search_recipesfacets andget_recipe_detailingredient data - Track weekly Albert grocery promotions and price changes by polling
get_leaflet_productsforprice,original_price, anddiscount_percent - Generate a store locator map for Albert branches across Czech cities using
find_storesgeoPointandstoreServicesfields - Monitor promotional leaflet validity windows using
get_current_leafletsvalidityStartDateFormattedandvalidityEndDateFormatted - Extract full leaflet page text for price intelligence pipelines using
get_leaflet_detailOCR fields - Populate a meal planner with structured ingredients and step-by-step instructions from
get_recipe_detailrecipeCookingStepsandfractionalRecipeIngredients - Aggregate Albert monthly deal content and promotional imagery from
get_monthly_dealsCMS page components
| 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 Albert.cz have an official public developer API?+
What does `get_leaflet_products` return and which leaflets does it cover?+
get_leaflet_products returns a merged products array from the currently valid general Albert Hypermarket and Albert Supermarket weekly leaflets (akční leták). Each row includes name, price (CZK promo price), original_price (CZK or null), and discount_percent. The leaflets array provides leaflet_type, slug, valid_from, valid_to, and product_count for each source. Store-specific variants, wine catalogues, and brand thematic leaflets are not included in this merge.Can I filter `search_recipes` by dietary preference or preparation time?+
search_recipes endpoint returns available facets in each response, and list_recipe_categories provides all filter options with codes and recipe counts for preparation time, difficulty, and special diet. The search inputs currently accept query and page; structured facet filtering as query parameters is not exposed. You can fork the API on Parse and revise it to add facet filter parameters to the endpoint.Does the API cover store-specific or city-specific promotional leaflets?+
get_current_leaflets returns metadata for the active general Hypermarket and Supermarket leaflets, and get_leaflet_detail retrieves any leaflet by slug. However, get_leaflet_products only merges the general weekly leaflets — store- or city-specific variants are excluded from the parsed products output. You can fork the API on Parse and revise it to add an endpoint that parses products from store-specific leaflet slugs.How fresh is the promotional leaflet and deal data?+
validityStartDateFormatted and validityEndDateFormatted fields so you can determine the active window. Validity typically follows Albert's weekly promotional cycle, but the API does not provide historical leaflet archives — only currently active leaflets are returned.