# Saturn — 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.

> Monitor real-time product availability, pricing, and seller information across Saturn.de locations, with the ability to check pickup options at specific stores by postal code. Search for products and retrieve detailed information to make informed purchasing decisions based on current stock and pricing data.

**Category:** E-commerce | **Website:** [www.saturn.de/](https://www.saturn.de/) | **Docs:** [parse.bot/marketplace/2c3e6129-481b-4117-85a9-b780d3c632ad/saturn-de-api](https://parse.bot/marketplace/2c3e6129-481b-4117-85a9-b780d3c632ad/saturn-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-saturn-de-api-2c3e6129/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_detail

Fetch full product detail by Saturn article number. Returns name, price, currency, EAN/GTIN, availability/stock status, delivery cost and timing, and seller/marketplace identity.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `article_number` | string | Yes | Saturn article number (numeric ID, e.g. '142245268' or '2954266'). Obtain from search_products results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-saturn-de-api-2c3e6129/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"article_number":"<string>"}'
```

### get_store_availability

Check per-store (branch) pickup availability for a product near a German postal code. Returns nearby Saturn stores with their pickup status, address, and estimated collection time if available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `article_number` | string | Yes | Saturn article number (numeric ID). Obtain from search_products results. |
| `postal_code` | string | Yes | German 5-digit postal code (PLZ) to search for nearby stores, e.g. '04103' for Leipzig. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-saturn-de-api-2c3e6129/get_store_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"article_number":"<string>","postal_code":"<string>"}'
```

### search_products

Full-text product search on Saturn.de. Returns article number, name, price, delivery status, marketplace/seller identity, and EAN for each hit. Results are auto-iterated by page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | 1-based page number for paginated results. |
| `query` | string | Yes | German-language search keyword (e.g. 'Midea PortaSplit', 'mobiles Klimagerät'). |

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