aldi.de APIaldi.de ↗
Access current and upcoming Aldi Nord offers, product details, category browsing, and weekly flyers via 9 structured JSON endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/3e8a2517-2748-4ad2-809c-d99f0bc32914/get_current_offers' \ -H 'X-API-Key: $PARSE_API_KEY'
Scrape all current week discount offers from Aldi Nord. Returns offer products grouped by action date with pricing, category, and validity information.
No input parameters required.
{
"type": "object",
"fields": {
"week": "string indicating 'current'",
"offers": "array of offer objects with product_id, name, brand, slug, price, original_price, sales_unit, image_url, offer_category, offer_section_title, validity_start, validity_end"
},
"sample": {
"data": {
"week": "current",
"offers": [
{
"name": "Eisbergsalat",
"slug": "eisbergsalat-6276",
"brand": null,
"price": 0.89,
"image_url": "https://s7g10.scene7.com/is/image/aldinord/6276_28_2025_eisbergsalat_02_on_230426_155354",
"product_id": "6276",
"sales_unit": "Stück",
"validity_end": "2026-05-15",
"offer_category": "Aktion Mo. 11.5.",
"original_price": 1.19,
"validity_start": "2026-05-10",
"offer_section_title": "Frische-Aktion: Obst & Gemüse"
}
]
},
"status": "success"
}
}About the aldi.de API
The Aldi Nord API exposes 9 endpoints covering weekly discount offers, product search, category listings, and digital flyer metadata from aldi-nord.de. The get_current_offers endpoint returns this week's deals grouped with fields like price, original_price, offer_category, and validity_start, while get_next_week_offers gives the same structure for upcoming promotions. Search and category endpoints round out full assortment access.
Weekly Offers and Promotions
get_current_offers and get_next_week_offers each return an array of offer objects with product_id, name, brand, slug, price, original_price, sales_unit, image_url, offer_category, and offer_sec. These cover all discount lines Aldi Nord publishes for the current and next week respectively. If you need a narrower slice, get_offers_by_category accepts a category_name string and performs a case-insensitive substring match against the offer_section_title field — useful for filtering to sections like Obst & Gemüse or Fleisch & Fisch. get_offers_by_date filters the same offer pool by validity_start date in YYYY-MM-DD format.
Product Search and Category Browsing
search_products accepts a query string (e.g. Milch, Bananen) and an optional limit integer, returning a total count plus a results array with product_id, name, brand, price, original_price, sales_unit, image_url, and categories. get_product_categories lists all top-level assortment categories with a count of products in each. Pass a category_name from that list to get_products_by_category (with an optional limit) to retrieve the corresponding product array in the same shape.
Product Details and Flyer Metadata
get_offer_details takes a product_id — obtainable from offer or search results — and returns extended fields including base_price (an array of base-price objects), price_unit, slug, brand, and category_ids. get_weekly_flyers retrieves CMS metadata for available Prospekte, including leaflet tile images, banner content, descriptions, and associated dates, structured under a flyers_page_data object reflecting the Magnolia CMS page layout.
- Track weekly price drops by comparing
pricevsoriginal_priceacrossget_current_offersandget_next_week_offers - Build a grocery deal alert that filters
get_offers_by_categoryfor specific sections likeBackwarenorGetränke - Monitor offer availability windows using
validity_startfromget_offers_by_datefor scheduling notifications - Populate a product catalog by combining
get_product_categoriesandget_products_by_categorywith thelimitparameter - Look up base price per unit (e.g. price per 100g) via the
base_pricearray inget_offer_details - Aggregate digital flyer launch dates and cover images from
get_weekly_flyersfor a promotions dashboard - Cross-reference
search_productsresults with offer data using sharedproduct_idvalues to identify discounted search matches
| 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 Aldi Nord provide an official developer API?+
What distinguishes `get_offer_details` from the offer list endpoints?+
get_offer_details targets a single product by product_id and returns fields not present in the list endpoints: a base_price array (useful for per-unit pricing), price_unit, and category_ids. The list endpoints (get_current_offers, get_next_week_offers) return broader arrays but omit those fields.Does the API cover Aldi Süd or international Aldi stores?+
Is offer history or past-week data available?+
get_current_offers and the upcoming week via get_next_week_offers. There are no endpoints for historical offers from previous weeks. You can fork it on Parse and revise to add a persistence layer that archives weekly snapshots as you call the endpoints.How does `get_offers_by_category` matching work, and what category strings are valid?+
get_offers_by_category performs a case-insensitive substring match against the offer_section_title field. There is no fixed enum of valid values — the available sections depend on what Aldi Nord publishes for the current week. Run get_current_offers first to inspect the offer_category and offer_sec fields in the response to identify which section strings are present.