albert.cz APIalbert.cz ↗
Access Albert.cz recipes, promotional leaflet OCR data, store locations, and magazine content via 8 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/1959d942-293a-4889-8d0c-9ecdcfdfa36e/search_recipes?page=1&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í') |
{
"type": "object",
"fields": {
"facets": "array of available filter facets (preparation time, difficulty, special diet)",
"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": "a2079",
"title": "Mangovo-jogurtové smoothie",
"rating": "4/5",
"difficultyName": "Velmi snadné",
"preparationTimeName": "0-15 minut"
}
],
"pagination": {
"pageSize": 12,
"totalPages": 5,
"currentPage": 1,
"totalResults": 52
}
},
"status": "success"
}
}About the albert.cz API
The Albert.cz API exposes 8 endpoints covering recipe search and detail, current promotional leaflets with OCR-extracted product and price text, store location lookup, and editorial magazine content. The get_leaflet_detail endpoint returns per-page OCR text and image URLs for active hypermarket and supermarket leaflets, making it the primary source for current product pricing since the Albert e-shop closed in December 2025.
Recipes
The search_recipes endpoint accepts a query string (e.g. 'kuřecí' or 'smoothie') and an optional zero-indexed page parameter. Results include id, title, rating, difficultyName, and preparationTimeName alongside pagination metadata (currentPage, totalResults, totalPages, pageSize) and available filter facets covering preparation time, difficulty, and special diet. Pass any returned id to get_recipe_detail to retrieve the full ingredient list (ingredientName, quantity, measureUnit), ordered cooking steps (stepNumber, description), and nutrition information. list_recipe_categories returns the full set of filter facets with value counts, useful for building filter UIs without first running a search.
Promotional Leaflets
get_current_leaflets returns active leaflets split into hypermarket and supermarket arrays. Each object includes id, title, validity dates (validityStartDateFormatted, validityEndDateFormatted), a cover imageUrl, and a viewUrl. The slug embedded in viewUrl (the path segment after the domain) is the input for get_leaflet_detail, which returns an array of spread objects. Each spread contains a pages array with individual page image URLs, OCR text, and page numbers — this OCR text is the main route to product names and prices from the printed leaflets, since the e-shop catalog is no longer available.
Store Locations
find_stores behaves differently depending on whether a query parameter is provided. With a query such as 'Praha' or 'Brno', it returns a stores array where each entry includes id, geoPoint coordinates, and groceryStoreType. Without a query, it returns all map pin objects with coordinates, suitable for rendering a full store map.
Magazine and Monthly Deals
get_magazine_articles and get_monthly_deals both return CMS-structured page data. Each response includes a meta object (product, version, branch) and a page object containing structured text components, image banners, and editorial models. These endpoints reflect the Albert Magazine and the current Hit měsíce (Monthly Deals) promotional page respectively.
- Build a Czech-language recipe search tool using
search_recipesquery and difficulty facets - Extract current supermarket and hypermarket promotional prices from leaflet OCR text via
get_leaflet_detail - Track weekly deal validity windows using
validityStartDateFormattedandvalidityEndDateFormattedfromget_current_leaflets - Render an interactive Albert store map using coordinates from
find_storeswithout a query - Display full recipe cooking steps and structured ingredient lists from
get_recipe_detailin a meal planning app - Monitor Albert Magazine editorial content and promotional campaign copy via
get_magazine_articles - Aggregate monthly deal descriptions and promotional images from
get_monthly_dealsfor price comparison or trend tracking
| 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 Albert.cz offer an official public developer API?+
How does the leaflet OCR data work, and what can I extract from it?+
get_leaflet_detail returns a data array of spread objects. Each spread contains a pages array where every page has an image URL, a page number, and OCR text extracted from that leaflet page. The OCR text typically contains product names, pack sizes, and prices as they appear in the printed leaflet. Quality depends on the legibility of the original printed page.Is historical leaflet data available, or only current promotions?+
get_current_leaflets returns only the leaflets currently active on albert.cz — there is no archive or date-range parameter for past leaflets. You can fork this API on Parse and revise it to add a historical leaflet endpoint if you identify accessible past-leaflet paths.Does the API return individual product catalog entries or structured pricing tables?+
get_leaflet_detail responses, which is unstructured string content. You can fork this API on Parse and revise it to add a parsing layer that structures the OCR output into product and price fields.Does `find_stores` return opening hours or contact details for each location?+
find_stores returns id, geoPoint, and groceryStoreType per store. Opening hours and contact details are not included in the current response. You can fork this API on Parse and revise it to add a store detail endpoint that retrieves that additional information.