# Aldi (Germany) — 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.

> Browse current and upcoming Aldi Nord offers, search products, and discover deals organized by category or date. Access detailed product information, weekly flyers, and explore items across all available categories to find the best bargains.

**Category:** Food & Dining | **Website:** [aldi.de/](https://aldi.de/) | **Docs:** [parse.bot/marketplace/397bcd36-69f3-489f-a98d-49e56e4a80a7/aldi-de-api](https://parse.bot/marketplace/397bcd36-69f3-489f-a98d-49e56e4a80a7/aldi-de-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-de-api-397bcd36/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_current_offers

Retrieve all current-week discount offers from Aldi Nord. Returns products grouped by action date with pricing, category, and validity information. Each offer includes its section title (e.g. 'Frische-Aktion: Obst & Gemüse') and validity window. Products without a strike-through price have original_price=null.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aldi-de-api-397bcd36/get_current_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_next_week_offers

Retrieve all next-week preview offers from Aldi Nord. Returns offer products for the upcoming week with pricing, category, and validity information. Structure is identical to current-week offers but with future validity dates.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aldi-de-api-397bcd36/get_next_week_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_offer_details

Fetch detailed information for a specific product by its product ID from the Aldi Nord product data service. Returns pricing with base price breakdown, category IDs, and full product metadata. Product IDs can be obtained from get_current_offers, get_next_week_offers, or search_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product objectID (e.g. '6570', '6276'). Obtainable from get_current_offers or search_products results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aldi-de-api-397bcd36/get_offer_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_offers_by_category

Filter current-week offers by offer section title. Performs a case-insensitive substring match against the offer_section_title field. Returns only matching offers from the current week. Section titles can be discovered from get_current_offers results (e.g. 'Frische-Aktion: Obst & Gemüse', 'Fleisch & Fisch').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_name` | string | Yes | Offer section title substring to filter by (case-insensitive, e.g. 'Obst', 'Fleisch', 'Frische'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aldi-de-api-397bcd36/get_offers_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_name":"<string>"}'
```

### get_offers_by_date

Filter current-week offers by their validity start date. Returns only offers whose validity_start contains the given date string. Dates from current offers can be discovered via get_current_offers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offer_date` | string | Yes | Offer start date in YYYY-MM-DD format (e.g. '2026-06-07'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aldi-de-api-397bcd36/get_offers_by_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offer_date":"<string>"}'
```

### get_product_categories

Retrieve all top-level product assortment categories with product counts. Categories represent the full permanent assortment hierarchy (not weekly offers). Use these category names with get_products_by_category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aldi-de-api-397bcd36/get_product_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_products_by_category

List products in a given top-level category from the permanent assortment. Category names must match those returned by get_product_categories (e.g. 'Milchprodukte', 'Snacks & Süßigkeiten'). Returns products with pricing and hierarchical category data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_name` | string | Yes | Category name from get_product_categories (e.g. 'Milchprodukte', 'Snacks & Süßigkeiten'). |
| `limit` | integer | No | Maximum number of results to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aldi-de-api-397bcd36/get_products_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_name":"<string>","limit":"<integer>"}'
```

### get_weekly_flyers

Retrieve metadata for available digital flyers (Prospekte) from the Aldi Nord CMS. Includes current and next week flyer tiles with images, descriptions, and dates.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aldi-de-api-397bcd36/get_weekly_flyers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_products

Search for products in the Aldi Nord assortment using a keyword query. Returns matching products with pricing, brand, and hierarchical category information. Powered by Algolia full-text search across product names and attributes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |
| `query` | string | Yes | Search keyword (e.g. 'Milch', 'Bananen', 'Käse'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-aldi-de-api-397bcd36/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```