# ALDI Australia Products API

> ALDI Australia: 3,200 grocery products with prices, unit prices, brands and categories

- Vendor: `aldiaustraliaproductsapi` · version 1.0 · category Food · tags aldi australia api, grocery prices api, supermarket products api, australian grocery api, unit price api, aldi products api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/aldiaustraliaproductsapi
- This document: https://apiclay.com/docs/aldiaustraliaproductsapi.md
- OpenAPI 3.1: https://apiclay.com/api/aldiaustraliaproductsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `aldiaustraliaproductsapi`
- Updated: 2026-11-18

## About

## ALDI Australia Products API

The product finder behind aldi.com.au: about 3,200 products searchable by keyword and category and sortable by price or name, each with SKU, name, brand, selling size, price, comparison unit price (per 100 g, per litre), was-price and savings when on special, categories, badges and images; one product by SKU with its description; and the full category tree.

Data comes from **aldi.com.au** (https://www.aldi.com.au). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/categories` for category keys, then `/search?categoryTree=950000000&amp;limit=30&amp;offset=0` or `/search?q=milk&amp;sort=price_asc&amp;limit=12`, then `/product?sku=`.

### Routes

#### GET `/search` - Search products
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | no | Keyword, e.g. `milk`. |
| categoryTree | query | string | no | Category `key` from `/categories`, e.g. `950000000` (Fruit &amp; Vegetables). |
| sort | query | string | no | `relevance`, `price_asc`, `price_desc`, `name_asc` or `name_desc`. |
| limit | query | number | yes | 12, 16, 24, 30, 32, 48 or 60 (other values are refused). |
| offset | query | number | no | Products to skip, for paging. |

Returns: `data` array: `sku`, `name`, `brandName`, `sellingSize`, `price` (`amount` in cents, `amountRelevantDisplay`, `comparisonDisplay` such as `$2.38 per 100 g`, `wasPriceDisplay`, `savingsDisplay`), `categories`, `badges`, `assets` (images), `notForSale`; plus `meta.pagination` (`totalCount`) and `meta.facets` (category, theme, brand).

#### GET `/product` - Product
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| sku | path | string | yes | 18-digit `sku` from `/search`, e.g. `000000000538441002`. |

Returns: `data`: the search fields plus `description`, `canonical` and full image list.

#### GET `/categories` - Categories
No parameters.

Returns: `data` array of top categories with `key`, `name`, `urlSlugText` and `children` (sub-categories with their own keys).

### Caveats

- Prices are in Australian dollars at the national walk-in price; Special Buys and their on-sale dates change weekly and stock varies by store.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by aldi.com.au.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Search products
- Gateway: `GET https://api.apiclay.com/v1/api/aldiaustraliaproductsapi/search`
- Public query params: `q` (string), `categoryTree` (string), `sort` (string), `limit` (number, required), `offset` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /product — Product
- Gateway: `GET https://api.apiclay.com/v1/api/aldiaustraliaproductsapi/product`
- Public query params: `sku` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories
- Gateway: `GET https://api.apiclay.com/v1/api/aldiaustraliaproductsapi/categories`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/aldiaustraliaproductsapi/search?limit=<limit>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
