ALDI US API & Scraper
This API reads aldi.us, ALDI's US online shop, live and returns it as JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Prices on aldi.us are set per store, so every call is answered for one ALDI store: give a ZIP code or a store_id from `stores` (without either, a fixed default store in St. Charles, IL is used and the response says store_defaulted: true). Each store has three price lists and you choose one with service_type: delivery (the price aldi.us prints on its product pages, the default), pickup, or in_store (the list aldi.us uses for its In-store shopping mode, lower on 31 of 42 products we compared). `search` returns the site's own ranked results (cheese: 287 products), `category` lists a collection such as Milk, All Dairy & Eggs, Specially Selected or Organic, `offers` returns the Weekly Ad, this week's or next Wednesday's ALDI Finds, or Price Drops, `product/detail` adds ingredients, warnings and images, `categories` lists departments and collections, and `stores` lists ALDI stores around a ZIP code with distance and services.
What an ALDI US field actually contains
Fields that read differently from how they look, measured on live responses on 2026-10-18.
| Field | What it holds |
|---|---|
| price, price_display | The price at the chosen store for the chosen service_type. With delivery it matched the price printed on the aldi.us product page for 15 of 15 products. |
| service_type | delivery, pickup or in_store. The same 2% milk at the St. Charles, IL store: delivery and pickup $2.85, in_store $2.55. |
| store, store_defaulted | The ALDI store that priced the response (id, name, street, city). store_defaulted is true when you gave neither postal_code nor store_id. |
| was_price, discount_percent | The struck-through price on reduced items and the discount computed from the two prices; null when the item is not reduced. |
| unit_price_text | The unit price as aldi.us prints it ("$0.02/fl oz", "$3.99 / lb"). For items sold by weight, price is the estimated package price and price_is_estimate is true. |
| stock_level, likely_out_of_stock | many_in_stock, in_stock, likely_out_of_stock or out_of_stock for that store. A "Likely out of stock" item can still show available: true. |
| matches_query | Whether the row shares a word with your search. aldi.us fills a search that matches nothing with unrelated products; such pages are dropped and counted in unmatched_dropped. |
| product_id | ALDI's product id on aldi.us, the same across stores; item_id is store-specific. |
Prices differ between stores: 2% milk (1 gal) delivery price was $2.85 in St. Charles IL, $3.69 in Burbank CA, $2.75 in Dallas and $2.89 in New York on the same day.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/aldi-us/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "milk",
"postal_code": "60174"
}
}{
"ok": true,
"meta": {
"api": "aldi-us",
"endpoint": "search",
"mode": "live",
"latency_ms": 1985.3,
"record_count": 20,
"bytes": 172673,
"cache_hit": false,
"warnings": [
"ignored unknown parameter(s): include_pii"
],
"pagination": {
"page": 1,
"has_more": true,
"total": 63
},
"upstream_requests": 3,
"charged_credits": 3,
"version": "1.0.0",
"request_id": "b6c586795b9f4cf8",
"queue_ms": 1.8,
"fetched_at": "2026-10-18T17:44:57.647Z"
},
"data": {
"products": [
{
"product_id": "16902710",
"item_id": "items_20785-16902710",
"name": "Friendly Farms Whole Milk",
"brand": "friendly farms",
"size": "1 gal",
"url": "https://www.aldi.us/store/aldi/products/16902710-friendly-farms-vitamin-d-milk-1-gal",
"image": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_b4aaab37-66cf-46e3-9638-f37987fca803.jpg",
"available": true,
"stock_level": "many_in_stock",
"stock_label": "Many in stock",
"likely_out_of_stock": false,
"sold_by": "each",
"weight_option": false,
"par_weight": null,
"max_order_quantity": 500,
"on_sale": false,
"buy_one_get_one": false,
"coupon_available": false,
"store_brand": true,
"dietary": [
"Whole"
],
"nutrition_highlights": null,
"variant_values": [],
"retailer_reference_code": null,
"retailer_lookup_code": null,
"currency": "USD",
"price": 2.56,
"price_display": "$2.56",
"original_price": null,
"discount_percent": null,
"savings": null,
"loyalty_price": null,
"loyalty_label": null,
"loyalty_card_offer": false,
"unit_price_text": "$0.02/fl oz",
"size_text": "1 gal",
"price_is_estimate": false,
"estimated_weight_text": null,
"promotions": [],
"deal_terms": null,
"great_price": false,
"badge": null,
"retailer": {
"retailer_id": "12",
"slug": "aldi",
"name": "ALDI",
"shop_id": "5844",
"service_type": "delivery",
"retailer_location_id": "20785"
},
"service_type": "delivery",
"id": "16902710",
"title": "Friendly Farms Whole Milk",
"was_price": null,
"matches_query": true
},
{
"product_id": "20957684",
"item_id": "items_20785-20957684",
"name": "Friendly Farms 2% Reduced Fat Milk",
"brand": "friendly farms",
"size": "1 gal",
"url": "https://www.aldi.us/store/aldi/products/20957684-friendly-farms-2-milk-1-gal",
"image": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_a4e29d62-0127-4e6f-ab85-97d4bc756cff.jpg",
"available": true,
"stock_level": "many_in_stock",
"stock_label": "Many in stock",
"likely_out_of_stock": false,
"sold_by": "each",
"weight_option": false,
"par_weight": null,
"max_order_quantity": 500,
"on_sale": false,
"buy_one_get_one": false,
"coupon_available": false,
"store_brand": true,
"dietary": [
"2%"
],
"nutrition_highlights": null,
"variant_values": [],
"retailer_reference_code": null,
"retailer_lookup_code": null,
"currency": "USD",
"price": 2.85,
"price_display": "$2.85",
"original_price": null,
"discount_percent": null,
"savings": null,
"loyalty_price": null,
"loyalty_label": null,
"loyalty_card_offer": false,
"unit_price_text": "$0.02/fl oz",
"size_text": "1 gal",
"price_is_estimate": false,
"estimated_weight_text": null,
"promotions": [],
"deal_terms": null,
"great_price": false,
"badge": null,
"retailer": {
"retailer_id": "12",
"slug": "aldi",
"name": "ALDI",
"shop_id": "5844",
"service_type": "delivery",
"retailer_location_id": "20785"
},
"service_type": "delivery",
"id": "20957684",
"title": "Friendly Farms 2% Reduced Fat Milk",
"was_price": null,
"matches_query": true
},
{
"product_id": "18647583",
"item_id": "items_20785-18647583",
"name": "Friendly Farms Vitamin D Whole Milk",
"brand": "friendly farms",
"size": "0.5 gal",
"url": "https://www.aldi.us/store/aldi/products/18647583-friendly-farms-whole-milk-0-5-gal",
"image": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_3e06b4ed-686e-4cd2-a478-3245ce04647d.jpg",
"available": true,
"stock_level": "many_in_stock",
"stock_label": "Many in stock",
"likely_out_of_stock": false,
"sold_by": "each",
"weight_option": false,
"par_weight": null,
"max_order_quantity": 500,
"on_sale": false,
"buy_one_get_one": false,
"coupon_available": false,
"store_brand": true,
"dietary": [
"Whole"
],
"nutrition_highlights": null,
"variant_values": [],
"retailer_reference_code": null,
"retailer_lookup_code": null,
"currency": "USD",
"price": 1.69,
"price_display": "$1.69",
"original_price": null,
"discount_percent": null,
"savings": null,
"loyalty_price": null,
"loyalty_label": null,
"loyalty_card_offer": false,
"unit_price_text": "$0.03/fl oz",
"size_text": "0.5 gal",
"price_is_estimate": false,
"estimated_weight_text": null,
"promotions": [],
"deal_terms": null,
"great_price": false,
"badge": null,
"retailer": {
"retailer_id": "12",
"slug": "aldi",
"name": "ALDI",
"shop_id": "5844",
"service_type": "delivery",
"retailer_location_id": "20785"
},
"service_type": "delivery",
"id": "18647583",
"title": "Friendly Farms Vitamin D Whole Milk",
"was_price": null,
"matches_query": true
}
],
"count": 20,
"total": 63,
"page": 1,
"per_page": 20,
"last_page": 4,
"has_more": true,
"unmatched_dropped": 0,
"next_cursor": "ACF7ImsiOiI5Y2M5OTNlNmFhNGIiLCJwIjoyLCJvIjoyMH0BAeo2AT_J9AEcih8BQDr2ARyLowFQ1tMBHI2nAUAk0AFBVfUBQA5JARyQiwFAR_UD1_TkASpBOQFrOTYBQFisATx-CQEcikcEiEyoARyLEQ",
"query": "milk",
"store": {
"store_id": "20785",
"name": "ALDI - BAT 43 - St. Charles",
"street": "2670 W. Main Street",
"city_state_zip": "St. Charles, IL 60174",
"latitude": 41.9136178,
"longitude": -88.3478394
},
"service_type": "delivery",
"postal_code": "60174",
"store_defaulted": false,
"currency": "USD"
}
}What the ALDI US API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search aldi.us at one ALDI store: price (in-store, pickup or delivery), was-price, unit price, stock level, brand, size and badges, in the site's own result order. | Pricing teams call search to search aldi.us at one ALDI store. | query, page, per_page, include_unmatched, cursor, ... |
| category | Every product of an aldi.us collection — a category (Milk, All Dairy & Eggs), an ALDI brand (Specially Selected) or a diet (Organic, Gluten Free) — priced at one store. | Marketplace operators call category to get every product of an aldi.us collection. | slug, page, per_page, cursor, postal_code, ... |
| offers | ALDI's current offer lists at one store: the Weekly Ad, this week's or next week's ALDI Finds, or Price Drops. | Catalog enrichment teams call offers to get aLDI's current offer lists at one store. | type, date, page, per_page, cursor, ... |
| promotions | Which ALDI offer lists are live now: Weekly Ad (with its dates), this week's and next week's ALDI Finds and Price Drops, each with its product count. | Retail analysts call promotions to get which ALDI offer lists are live now. | postal_code, store_id, service_type |
| product/detail | One ALDI product: name, brand, size, category, ingredients, directions, warnings, images, rating — and its price, unit price and stock at one store. | Pricing teams call product/detail to get one ALDI product. | product_id, postal_code, store_id, service_type |
| categories | aldi.us departments (Fresh Produce, Dairy & Eggs …), a department's collections, a collection's sub-collections, and the ALDI brand and diet collections. | Marketplace operators call categories to get aldi.us departments (Fresh Produce, Dairy & Eggs …), a department's collections, a collection…. | department, slug, postal_code, store_id, service_type |
| stores | ALDI stores around a US ZIP code, nearest first, with address, coordinates, distance and which services (in-store, pickup, delivery) aldi.us offers there. | Catalog enrichment teams call stores to get aLDI stores around a US ZIP code, nearest first, with address, coordinates, distance and whic…. | postal_code, page, limit |
Call search from your stack
curl -X POST https://api.reefapi.com/aldi-us/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"milk","postal_code":"60174"}'import requests
r = requests.post(
"https://api.reefapi.com/aldi-us/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "milk",
"postal_code": "60174"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/aldi-us/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "milk",
"postal_code": "60174"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.aldi-us.search with {"query":"milk","postal_code":"60174"}.Who uses this API and why
- Track ALDI US prices per store and ZIP code for a grocery price comparison app.
- Publish the ALDI Weekly Ad and ALDI Finds every Wednesday in a deals feed.
- Compare delivery and in-store prices for the same ALDI products.
- Build an ALDI store finder with services and distance from any US ZIP code.
- Monitor ALDI Price Drops and reduced items across regions.
Questions developers ask before integrating
Does ALDI US have a public API?
No public product API. This API reads what aldi.us shows a logged-out visitor and returns it as JSON. No account is needed.
Why do I need a ZIP code?
ALDI prices on aldi.us are set per store. The same gallon of milk was $2.75 to $3.69 across four stores on one day. Pass postal_code or store_id; without them a fixed default store is used and store_defaulted is true.
Are these the prices in the store?
aldi.us shows three price lists per store. delivery (the default) is what its product pages print, and pickup was the same at the stores we checked. in_store is the list aldi.us uses for its In-store shopping mode; it was lower than delivery on 31 of 42 products, usually by about 10 percent.
Can I get the ALDI Weekly Ad and ALDI Finds?
Yes. offers with type weekly_ad returns the current Weekly Ad ("Weekly Ad Oct 14 - Oct 20", 135 to 185 products depending on the store), aldi_finds returns this week's ALDI Finds, upcoming_aldi_finds next Wednesday's list, and price_drops the Price Drops collection. promotions lists all four with their dates and product counts.
How do I find ALDI stores near a ZIP code?
Call stores with postal_code. Around 10001 (New York) it returned 72 stores, nearest first, with address, coordinates, distance in miles and whether each offers in-store shopping, pickup or delivery. Use a store_id in any other call to price at that store.
How do I browse a category?
Call categories for the departments (Fresh Produce, Dairy & Eggs, Frozen Foods ...) and the ALDI brand and diet collections, categories with department=dairy-and-eggs for that department's collections, then category with a slug such as n-milk-33852.
Does search return everything aldi.us finds?
Yes, in aldi.us's own order, 20 per page by default (up to 40). cheese returned 287 products. The site can re-rank its list between two calls, so reading by page number can repeat or skip a product; follow next_cursor from each answer for a complete scan: it never returns a product twice and fills the page from the rest of the list.
How fresh is the data?
Every call reads aldi.us live; nothing is cached on our side.
What is the ALDI US API?
ALDI US API is a ReefAPI endpoint group for aldi.us prices as json per store: search, categories, the weekly ad, aldi finds, price drops and the store locator, with delivery, pickup or in-store prices. It returns live JSON through POST requests under /aldi-us/v1.
Is the ALDI US API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. ALDI US calls use the same shared credit balance as every other ReefAPI engine.
Do I need an ALDI US login or account?
No login to ALDI US 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 US 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 US API use?
ALDI US actions currently cost 2-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call ALDI US from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call aldi-us actions with the same key, credit pool and JSON envelope used by normal REST requests.