ALDI

ALDI Search API

Search ALDI US products at one store and get that store's price and was-price in dollars, sale label, unit price, stock level, category, in-store aisle location, ALDI exclusive brand flag, dietary labels, image and product URL. Prices are per store and per shopping mode (in-store shelf price by default). Pass store_id, or zip for the nearest store. Costs 1 credit per request.

POST/api/v1/aldi/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

Search keywords.

Example: milk

store_idstring

ALDI store id (store_id from /api/v1/aldi/stores). Prices and stock are that store's. Pass this, or zip to use the nearest store.

Example: 151248

zipstring

US ZIP code. Without store_id, the nearest ALDI store to this ZIP is used.

Example: 33133

service_typestring

Which price to return: instore (default, the shelf price in the store), pickup or delivery (the online prices for ordering from that store, often higher than the shelf price).

Example: instore

sortstring

best_match (default), price_low or price_high.

limitinteger

Products per page, 1-60. Defaults to 30.

Example: 30

pageinteger

Results page, 1-based, up to 100. Defaults to 1.

Example: 1

include_relatedboolean

Also return the related items ALDI lists after the exact matches. Defaults to false (exact matches only).

Example: false

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.aldi.search(query="milk", store_id="151248")["data"]

for p in res["products"]:
    print(p["product_id"], p["name"], p["size"], p["price"], "was", p["was_price"], p["stock_level"])

Response

"query": "milk",

"sort": "best_match",

"include_related": false,

"page": 1,

"limit": 30,

"total_results": 15,

"total_pages": 1,

"count": 15,

"response_time": 5577

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.aldi.search(query="milk", store_id="151248")["data"] for p in res["products"]: print(p["product_id"], p["name"], p["size"], p["price"], "was", p["was_price"], p["stock_level"])