# Globus Baumarkt — 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 for DIY and building materials across Globus Baumarkt's product catalog, view detailed product information including prices and specifications, and instantly check which nearby branches have items in stock for pickup or reservation. Never waste time calling stores again—find exactly what you need and where to get it, all in one place.

**Category:** E-commerce | **Website:** [www.globus-baumarkt.de/](https://www.globus-baumarkt.de/) | **Docs:** [parse.bot/marketplace/21b527ac-085e-444d-be53-3188c50ee9c1/globus-baumarkt-de-api](https://parse.bot/marketplace/21b527ac-085e-444d-be53-3188c50ee9c1/globus-baumarkt-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/globus-baumarkt/`
**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

### Check store availability

Check per-branch stock availability for a product at Globus Baumarkt stores nearest to a given German postal code. Returns the 5 closest stores with their stock levels, distance, address, business hours, and pickup information. Each store reports two inventory numbers: `stock` is the quantity available for customer purchase or Click & Collect pickup (this drives the `available` flag); `store_stock` is the total physical on-hand count including units reserved for display, pending orders, or other non-purchasable allocations. A store with stock=0 and store_stock>0 has inventory that cannot be purchased or collected.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `article_number` | string | Yes | 10-digit Globus Baumarkt article number (e.g. '0782143956'). Obtainable from search_products results. |
| `postal_code` | string | Yes | 5-digit German postal code (PLZ) to search nearby stores (e.g. '04109' for Leipzig). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/globus-baumarkt/check-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>"}'
```

### Get product detail

Retrieve full product details by article number including name, description, price, brand, EAN (GTIN-13), and image. Performs a search-then-fetch: first locates the product page via article number search, then extracts structured data from the JSON-LD on the product page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `article_number` | string | Yes | 10-digit Globus Baumarkt article number (e.g. '0782143956'). Obtainable from search_products results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/globus-baumarkt/get-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"article_number":"<string>"}'
```

### Search products

Full-text product search across the Globus Baumarkt catalog. Returns matching products with article numbers and URLs. Results are server-rendered from the first page. Multi-word queries use AND semantics. The reported total equals the number of extracted product listings (promotional/editorial cards are excluded).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or phrase (e.g. 'Klimagerät', 'Ventilator', 'Bohrmaschine'). Multi-word queries narrow results with AND semantics. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/globus-baumarkt/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"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.