# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/saturn/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/saturn/get-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/saturn/get-store-availability \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/saturn/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.