# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-globus-baumarkt-de-api-21b527ac/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-globus-baumarkt-de-api-21b527ac/check_store_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-globus-baumarkt-de-api-21b527ac/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-globus-baumarkt-de-api-21b527ac/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```