🇳🇱 Albert Heijn Netherlands REST API JSON

Albert Heijn API — Real-Time Netherlands Grocery Data

Access Albert Heijn's Dutch grocery catalog via the Pepesto API — live pricing in EUR and details from ah.nl, returned as structured JSON.

Daily Catalog indexed
Simple pricing See plans →
25+ Chains on one schema

What Does the Albert Heijn API Return?

Everything visible and related to food, cooking, and recipes in the Albert Heijn mobile web application, returned as clean JSON via a single REST call. The indexed product list typically contains 1,000–2,000 SKUs, focused on the most common ingredients used for cooking.

Product name
Current price (EUR)
Unit price (per 100g / per litre)
Promotional / sale price
Product images
Additonal Pepesto tags

Built with this API

Comparing pasta prices at Albert Heijn, Jumbo, and Plus

Real working code. See what's possible, then adapt it for your use case.


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.

🔧
No maintenance burden

Albert Heijn updates their website regularly — changing markup, adding rate limiting, or restructuring categories. Pepesto absorbs all of that. Your integration keeps working.

📐
Consistent schema across all 25+ chains

The same JSON field names work whether you're calling Albert Heijn, Jumbo, Tesco, or any other supported chain. One integration for all of Europe.

Faster time to market

Calling a REST API takes hours. Building, maintaining, and scaling your own Albert Heijn data extraction takes months — and requires ongoing engineering resources.

🛡️
Reliable uptime

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 all products available in Pepesto for Albert Heijn.

Request — cURL
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"}'
Response — JSON (URL key varies by product)
{
  "https://ah.nl/spaghetti/barilla-spaghettoni-nr-7-1kg/p/4934814e0251": {
    "entity_name":             "Spaghetti",
    "kg_verified":             true,
    "names": {
      "nl":                   "Barilla Spaghettoni nr. 7 1kg",
      "en":                   "Barilla Spaghettoni No. 7 1kg"
    },
    "price":                   340,
    "currency":               "EUR",
    "price_per_meausure_unit": "0.34 / 100g",
    "quantity_str":           "1kg",
    "quantity": {
      "Unit": {
        "HundredGrams": 10
      },
      "accurate_grams": 1000
    }
  }
}
Full API Reference →

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.

Use case
AI grocery agents

Give your AI agent the ability to search Albert Heijn's products, compare products, and place grocery orders — all programmatically via REST.

Use case
Grocery price comparison

Compare Albert Heijn prices against other Netherlands retailers in real time. Flag promotions, track price history, and surface the best deal per product.

Use case
Grocery budget tracker

Let users build a weekly shopping list and see the exact Albert Heijn cost — including any active promotional prices — before they shop.

Use case
Meal planning with live prices

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.

Use case
Nutrition & diet apps

Bridge meal planning and shopping: match recipe ingredients to real Albert Heijn supermarket products and power dietary-aware grocery lists with live pricing.

Use case
Retail shelf analytics

Monitor Albert Heijn's product range, pricing strategy, and promotional cadence at scale. Analyse SKU composition, spot price movements, and benchmark against competitors.


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.

🌍
Country coverage

Netherlands — ah.nl. Pricing in EUR.

🔄
Refresh cadence

Daily. Promotional prices and weekly deals are included in every update cycle.

📦
What's included

All products listed online at ah.nl — including active promotions and 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.

💳
1. Buy credits

Start pay-as-you-go — all 27 chains included, no per-chain pricing. Move to a monthly plan when you grow. See pricing →

🔑
2. Get your API key

After purchase, call /link with your email — your API key is returned immediately. No waiting, no approval form, no account setup.

3. Start building

Make your first call to /api/catalog with chain: "albert-heijn". Full endpoint reference and example responses are in the API reference.

Buy Credits & Get Your API Key   Full API Reference →

Purchase via Stripe, then call /link with your email — your key is returned immediately.


Frequently Asked Questions about the Albert Heijn API

Does Albert Heijn have an official public API for developers?

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.

Are Albert Heijn product names returned in Dutch?

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.

What format does the Albert Heijn API response use?

Pepesto returns a unified JSON schema across all 25+ supported chains. Each AH product includes name (in Dutch), price in EUR, unit price, and quantity (e.g., kg).

How current is Albert Heijn product and pricing data?

Data from ah.nl is refreshed daily, capturing current online prices and weekly promotions.

How do I start using the Albert Heijn API?

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.

Does this cover Albert Heijn Netherlands only?

Yes. This integration covers ah.nl — the Dutch storefront. Albert Heijn Belgium is a separate entity and is not included in this integration.

Heeft Albert Heijn een gratis publieke API?

Nee, Albert Heijn biedt geen officiële publieke API voor ontwikkelaars. Pepesto biedt een onderhouden REST API die live productdata van ah.nl retourneert — inclusief EUR-prijzen, Bonus-aanbiedingen en voedingsinformatie — dagelijks vernieuwd.

What does the Albert Heijn API return?

Everything visible and related to food, cooking, and recipes in the Albert Heijn mobile web application, returned as clean JSON via a single REST call. The indexed product list typically contains 1,000–2,000 SKUs, focused on the most common ingredients used for cooking.

Is the Albert Heijn data available in real time?

The standard catalog is indexed daily — product prices 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.


Start fetching Albert Heijn data today

Live pricing and product catalog for food, cooking, and recipes from ah.nl — clean JSON, one API key.

Buy credits via Stripe → call /link with your email → API key returned immediately.

Questions? Email support@pepesto.com or book a call.