# Edeka24 — 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 and search EDEKA24's product catalog, view detailed product information and categories, and manage your shopping cart all programmatically. Authenticate your account, add items to your cart, and proceed to checkout seamlessly through automated requests.

**Category:** Food & Dining | **Website:** [edeka24.de/](https://edeka24.de/) | **Docs:** [parse.bot/marketplace/ffeff11d-f575-4b04-bb23-0e25ba18df27/edeka24-de-api](https://parse.bot/marketplace/ffeff11d-f575-4b04-bb23-0e25ba18df27/edeka24-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-edeka24-de-api-ffeff11d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### export_products

Export product search results in a flat, spreadsheet-friendly format. Returns up to 100 products for the given query, each with Product Name, Price, URL, and SKU fields. Useful for bulk data extraction.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-edeka24-de-api-ffeff11d/export_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_categories

Retrieve the full category tree from the site navigation. Returns top-level categories with their subcategories and URLs. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### get_product_details

Get detailed information for a single product page including name, price, unit price, description, images, and specifications table. Requires the full product URL. Returns stale_input with kind input_not_found if the product page returns 404/410.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full product URL on edeka24.de (e.g. 'https://www.edeka24.de/Lebensmittel/Kaffee-Tee/Kaffee-gemahlen-Instant/Melitta-Kaffee-Auslese-klassisch-gemahlen-500G.html'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-edeka24-de-api-ffeff11d/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_products_by_category

Fetch paginated product listings for a specific category by its full URL. Parses the category page HTML to extract product cards. Each product includes name, price, unit price, image URL, and internal product ID. Page numbers are 1-based.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based). |
| `url` | string | Yes | Full category URL on edeka24.de (e.g. 'https://www.edeka24.de/Lebensmittel/Kaffee-Tee/Kaffee-gemahlen-Instant/'). |

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

### search_products

Full-text search over the edeka24.de product catalog via the Findologic search engine. Returns paginated product summaries including name, price, URL, image, and SKU. Pagination is offset-based; each page returns up to `limit` items starting from `offset`.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page. |
| `offset` | integer | No | Offset for pagination (0-based item index). |
| `query` | string | Yes | Search keyword (e.g. 'kaffee', 'milch', 'bio'). |

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