# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-aldi-co-uk-api-498f5d4e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-aldi-co-uk-api-498f5d4e/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-aldi-co-uk-api-498f5d4e/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-aldi-co-uk-api-498f5d4e/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-aldi-co-uk-api-498f5d4e/search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","service_point":"<string>"}'
```