Albert Heijn API — Real-Time Netherlands Grocery Data
Access Albert Heijn's Dutch grocery catalog via the Pepesto API — live pricing in EUR, nutritional data, and availability from ah.nl, returned as structured JSON.
What Does the Albert Heijn API Return?
Everything visible in the Albert Heijn app and website, returned as clean JSON via a single REST call.
Albert Heijn-specific: Product names and categories are returned in Dutch as displayed on ah.nl.
Why Use an API Instead of Building Your Own Albert Heijn Integration?
Developers who have tried to build their own Albert Heijn data pipeline know the obstacles. Unofficial workarounds exist, but they come with real costs.
Albert Heijn updates their website regularly — changing markup, adding rate limiting, or restructuring categories. Pepesto absorbs all of that. Your integration keeps working.
The same JSON field names work whether you're calling Albert Heijn, Albert Heijn, Tesco, or any other supported chain. One integration for all of Europe.
Calling a REST API takes hours. Building, maintaining, and scaling your own Albert Heijn data extraction takes months — and requires ongoing engineering resources.
DIY data extraction is fragile: a single layout change can silently break your pipeline. Pepesto monitors and updates integrations continuously so you don't have to.
Fetch Albert Heijn Products in One Request
A single authenticated POST to /api/catalog returns
the full structured product catalog from Albert Heijn.
curl -X POST https://s.pepesto.com/api/catalog \ -H "Authorization: Bearer $PEPESTO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"supermarket_domain": "ah.nl"}'
{
"supermarket_domain": "ah.nl",
"products": [
{
"name": "Barilla Penne Rigate 500g",
"brand": "Barilla",
"pack_size": "500g",
"price": 1.89,
"unit_price": 0.38,
"unit_label": "per 100g",
"promo_price": 1.49,
"availability": "in_stock",
"category": "Pasta & Rice / Pasta / Penne",
"nutrition": {
"energy_kcal": 352,
"protein_g": 12.5,
"carbs_g": 70.5,
"fat_g": 1.5
}
}
]
}What Can You Build?
The Albert Heijn API gives your product a live data layer on top of one of Netherlands's leading grocery retailers.
Compare Albert Heijn prices against other Netherlands retailers in real time. Flag promotions, track price history, and surface the best deal per product.
Let users build a weekly shopping list and see the exact Albert Heijn cost — including any active promotional prices — before they shop.
Match recipe ingredients to real Albert Heijn products and show the true cost of cooking from a given menu. Drive grocery orders directly from your meal planner.
Access structured nutritional data — calories, macros, allergens — for the exact products sold at Albert Heijn. Power food logging and dietary tracking with real supermarket data.
Monitor Albert Heijn's product range, pricing strategy, and promotional cadence at scale. Track SKU introductions, price changes, and out-of-stock events over time.
Give your AI agent the ability to search Albert Heijn's catalog, compare products by price or nutrition, and place grocery orders — all programmatically via REST.
Coverage & Data Freshness
Covers ah.nl — Albert Heijn's Dutch online grocery store. Pricing in EUR. Albert Heijn is the Netherlands' largest supermarket chain. The integration covers the Dutch storefront; Albert Heijn Belgium is not included.
Netherlands — ah.nl. Pricing in EUR.
Daily. Promotional prices and weekly deals are included in every update cycle.
All products listed online at ah.nl — including active promotions and full product details.
All product data and pricing is sourced from publicly listed pages on ah.nl. Pepesto does not access retailer-gated pricing or any data not visible to a regular visitor. Products shown at a lower price due to a promotion or budget-tier range are included because they appear publicly on the site — not through any special retailer agreement.
How to get started
Three steps. No approval process. Your first call can be running within minutes.
Purchase a credit pack via Stripe. Pay-as-you-go from €0.05 per request. No monthly subscription, no minimum spend. Credits don't expire.
After purchase, call /link with your email — your API
key is returned immediately. No waiting, no approval form, no account
setup.
Make your first call to /api/catalog with
chain: "albert-heijn". Full endpoint reference and example
responses are in the API docs.
Purchase via Stripe, then call /link with your email — your
key is returned immediately. No approval process, no waiting.
Frequently Asked Questions about the Albert Heijn API
Albert Heijn does not offer a public developer API. Pepesto provides a maintained, reliable API layer that normalises Albert Heijn's product catalog from ah.nl into consistent JSON, updated daily.
Yes. Product names and categories are returned in Dutch as displayed on ah.nl. All JSON field keys use English for consistent cross-chain programmatic access.
Pepesto returns a unified JSON schema across all 25+ supported chains. Each AH product includes name (in Dutch), price in EUR, unit price, availability, category path, brand, pack size, and nutritional data.
Data from ah.nl is refreshed daily, capturing current online prices and weekly promotions.
Purchase Pepesto API credits, retrieve your key via /link, then call /catalog with chain set to albert-heijn. Full endpoint reference is at pepesto.com/docs/grocery-shopping-api.
Yes. This integration covers ah.nl — the Dutch storefront. Albert Heijn Belgium is a separate entity and is not included in this integration.
The standard catalog is indexed daily — prices, availability, and product details are refreshed every 24 hours. If your use case requires more frequent updates or push notifications on price changes, get in touch and we can discuss what's possible.
Other Supermarkets Available on Pepesto
One API key gives you access to 25+ European grocery chains with a consistent JSON schema.
