# Aldi (United Kingdom) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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.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.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.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.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.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>"}'
```