ALDI SÜD (Germany) API

ALDI SÜD Germany prices, offers and Grundpreis as JSON

ALDI SÜD is the discount supermarket chain of southern and western Germany.

no credit card1,000 free credits · instant API key · pay by card or crypto
Missing a ALDI SÜD (Germany) endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
A
/aldi-de/v1

6 active endpoints, on 1, 2 and 3 credit tiers.

  • POST/aldi-de/v1/search
  • POST/aldi-de/v1/offers
  • POST/aldi-de/v1/promotions
  • POST/aldi-de/v1/product/detail
  • POST/aldi-de/v1/categories
  • POST/aldi-de/v1/stores

What ALDI SÜD (Germany) endpoints does ReefAPI ship?

6 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

6 endpoints

search

2 cr

Search products, browse a category, read a dated offer (Angebote) or page the whole online as…

required
—
optional
query, categoryKey, promotionKey, url, brandName, categoryTree, theme, store_id, sort, page, limit

offers

3 cr

List a current offer range Wochenangebote / Frischeprodukte im Angebot / Eigenmarken im Angeb…

required
—
optional
type, brandName, categoryTree, theme, store_id, sort, page, limit

promotions

1 cr

List current and upcoming offer dates (Angebote ab...) and their themes.

required
—
optional
—

product/detail

1 cr

Read one product.

required
id
optional
—

categories

2 cr

Get the live category tree with the offer ranges marked.

required
—
optional
—

stores

1 cr

Find ALDI SÜD stores by town, postcode or coordinates (store ids for search).

required
—
optional
query, latitude, longitude, page, limit

Every parameter, every allowed value →

ALDI SÜD (Germany) API

4 of 6 endpoints, ready to run

View docs ↗

Milk at ALDI SÜD

2 credits0 required · 2 optional
POST/aldi-de/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the ALDI SÜD (Germany) API works

ALDI SÜD (Germany) is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 585 engines.

02
Call
POST /aldi-de/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 or 2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

From this week's offers to a price per kilo

Find the offer dates, list what is on offer, then compare on the unit price.

01promotions
GET/aldi-de/v1/promotions

Offer dates (Angebote ab ...) with their themes.

02search?promotionKey=2026-10-19&limit=30
GET/aldi-de/v1/search?promotionKey=2026-10-19&limit=30

Everything on offer from that date, with old and new price where ALDI SÜD prints both.

03offers?type=weekly&sort=price_asc
GET/aldi-de/v1/offers?type=weekly&sort=price_asc

The current Wochenangebote, cheapest first.

04detail?id=<id>
GET/aldi-de/v1/product/detail?id=<id>

Ingredients, allergens, nutrition and storage for one product.

A weekly offer list with old price, new price, discount and Grundpreis you can refresh every day.

request
curl -X POST https://api.reefapi.com/aldi-de/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"milch","limit":12}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "aldi-de",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}

What an ALDI SÜD field actually contains

Fields that read differently from how they look, measured on live responses on 2026-10-18.

FieldWhat it holds
price, price_displayThe shelf price in euros as the product page prints it ("0,85 €"). It matched the product page on 14 of 14 products checked.
unit_price, unit_price_basisThe Grundpreis and what it is per: 0.85 with basis "1 l", 14.98 with "1 kg", 0.76 with "100 Blatt". The number is never rescaled; compare products only on the same basis. Null when ALDI SÜD prints none (fresh milk has none).
was_price, discount_percent, savings_displayOn offers: the struck-through price, the discount computed from the two prices and the saving ALDI SÜD prints ("21 %"). The printed and computed figures agreed within one point on 85 of 85 offer rows.
deposit, deposit_typeThe Pfand, separate from the price: 0.25 EINWEG on single-use bottles and cans (48 of 360 rows sampled), 6.00 on a 24-can advent calendar.
on_sale_dateThe day a dated offer (Aktion) starts in store. Future dates are announced offers, not stock.
assortment_scope, store_idnational when no store is given: the listing covers every region. With store_id it is that store's range. Prices are the same in every store (0 differences across München, Köln and Nürnberg); the range is not (bread 82 nationally, 70 in a München store).
badgesShelf badges as printed: Kühlung, Vegan, Aktion, Vegetarisch, Regional verfügbar, Tiefkühlung.
idALDI SÜD's 18-digit product id; keep the leading zeros. It is not an EAN: aldi-sued.de publishes no barcode.

A page can hold one or two products fewer than requested while more pages remain: ALDI SÜD sometimes counts products it does not list (one offer date: 84 counted, 82 listed). page_short marks such a page; keep paging by page number.

ALDI SÜD coverage, measured

Every number was read from live responses on 2026-10-18 over two runs: 22 searches, 10 offer lists, 6 product reads, 4 store searches, all answered.

Assortment

3,516 products online; Wochenangebote 74, Dauerhaft günstig 189, under 1 euro 302, Neuheiten 48.

Price check

14 of 14 products: price, old price, Grundpreis and title matched the aldi-sued.de product page; search and product read agreed on all 14.

Filters

milch 33 → brand MILSANI 15; bread 82 nationally → 70 in one München store; one offer date 44 → one theme 1.

Paging

Three pages of 24 (bread, cheapest first): no product repeated, prices rising across all three.

Fill

Across 407 rows: price, title, image on all; brand 398; Grundpreis 377; pack size 377; old price on 119 offer rows; deposit on 23.

Limits

No EAN, no store stock, no online ordering (aldi-sued.de sells in store only). Page sizes 12 to 60.

What people build with ALDI SÜD (Germany)

The jobs this data is most often used for.

6

endpoints

1/2/3

credits per call

01

Track ALDI SÜD's weekly offers and old-versus-new prices for a deals app or newsletter.

02

Compare German discounter prices per kilo or litre using the published Grundpreis.

03

Monitor price changes across the whole ALDI SÜD online assortment with a daily sweep.

04

Build a nutrition or allergen filter on ALDI SÜD products from the label data.

What ALDI SÜD (Germany) data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 585 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/aldi-de/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"milch","limit":12}'
python
import requests

r = requests.post(
    "https://api.reefapi.com/aldi-de/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "milch",
  "limit": 12
},
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up ALDI SÜD (Germany).

Get a free key →
Does ALDI SÜD have a public API?▾

No public one. This API reads what aldi-sued.de shows a logged-out visitor and returns it as JSON. No account is needed.

Does it cover ALDI Nord?▾

No. ALDI Nord (aldi-nord.de) is a separate company with its own website. This API covers ALDI SÜD; our hofer API covers ALDI SÜD's Austrian stores.

Are the prices the same in every store?▾

Yes, in our measurements: three stores in München, Köln and Nürnberg priced every common product identically. Which products a store carries differs, so pass store_id to see one store's range.

How do I get this week's offers?▾

Call offers (type weekly, or weekly_fresh, weekly_own_brands, weekly_brands). For the dated Angebote, call promotions and pass a date to search as promotionKey; add theme to narrow it.

Is the Grundpreis included?▾

Yes, as unit_price with unit_price_basis, exactly as ALDI SÜD prints it. 377 of 407 sampled rows had one.

Can I get EAN barcodes?▾

No. aldi-sued.de does not publish them on its product pages or in its product data; products carry ALDI SÜD's own 18-digit id.

Can I see store stock?▾

No. ALDI SÜD publishes no store stock for the products we tried, so the API does not offer it.

How fresh is the data?▾

Every call reads aldi-sued.de live; nothing is cached.

What is the ALDI SÜD (Germany) API?▾

ALDI SÜD (Germany) API is a ReefAPI endpoint group for aldi süd germany prices as json: weekly offers (angebote), unit prices (grundpreis), deposit, labels and the store finder. It returns live JSON through POST requests under /aldi-de/v1.

Is the ALDI SÜD (Germany) API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. ALDI SÜD (Germany) calls use the same shared credit balance as every other ReefAPI engine.

Do I need an ALDI SÜD (Germany) login or account?▾

No login to ALDI SÜD (Germany) is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the ALDI SÜD (Germany) data?▾

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the ALDI SÜD (Germany) API use?▾

ALDI SÜD (Germany) actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call ALDI SÜD (Germany) from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call aldi-de actions with the same key, credit pool and JSON envelope used by normal REST requests.

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 584 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-18.