# Aldi (United Kingdom) — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse Aldi UK's product catalog with detailed information about items, categories, and real-time suggestions to help you find exactly what you're looking for. Get instant access to product details, pricing, and category navigation across Aldi's full range of groceries and goods.

**Category:** Food & Dining | **Website:** [aldi.co.uk/](https://aldi.co.uk/) | **Docs:** [parse.bot/marketplace/498f5d4e-42ef-4af7-99ca-83f5508650bd/aldi-co-uk-api](https://parse.bot/marketplace/498f5d4e-42ef-4af7-99ca-83f5508650bd/aldi-co-uk-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/aldi-united-kingdom/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get categories

Get the full product category tree for Aldi UK. Returns hierarchical categories with keys that can be used to filter search_products results. Each category has a key, name, URL slug, and children array for subcategories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `service_point` | string | No | Store service point code determining available categories. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/aldi-united-kingdom/get-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"service_point":"<string>"}'
```

### Get product details

Get detailed product information for one or more products by their SKU codes. Returns product data including name, brand, pricing, categories, and image assets. SKUs are available from search_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `service_point` | string | No | Store service point code determining product availability and pricing. |
| `skus` | string | Yes | Comma-separated list of product SKU codes (e.g. '000000000589532003,000000000297445002'). SKUs are available from search_products results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/aldi-united-kingdom/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"service_point":"<string>","skus":"<string>"}'
```

### Search products

Search for products on Aldi UK by keyword query and/or category. Returns paginated results with product details, pricing, and available facets for filtering. At least one of query or category_key must be provided. Paginates via offset; each product includes SKU, name, brand, price, categories, and image assets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_key` | string | No | Category key to filter products. Obtain from get_categories endpoint (categories[].key). At least one of query or category_key must be provided. |
| `limit` | integer | No | Number of results per page. Accepts exactly one of: 12, 16, 24, 30, 32, 48, 60. |
| `offset` | integer | No | Pagination offset (number of results to skip). |
| `query` | string | No | Search query text. At least one of query or category_key must be provided. |
| `service_point` | string | No | Store service point code determining product availability and pricing. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/aldi-united-kingdom/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_key":"<string>","limit":"<integer>","offset":"<integer>","query":"<string>","service_point":"<string>","sort":"<string>"}'
```

### Search suggestions

Get search autocomplete suggestions for a partial query. Returns keyword completions, matching products with pricing, and relevant categories with document counts. Useful for building search-as-you-type interfaces.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial search query to get suggestions for. |
| `service_point` | string | No | Store service point code. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/aldi-united-kingdom/search-suggestions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","service_point":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.