# WLW Germany — 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 B2B suppliers and manufacturers on wlw.de, view detailed company profiles with contact information and product catalogs, and discover featured businesses and products. Find the right industrial suppliers and vendors quickly by browsing company details and product listings across Germany's largest B2B marketplace.

**Category:** Business Directories | **Website:** [wlw.de/](https://wlw.de/) | **Docs:** [parse.bot/marketplace/9dd2ec23-e71c-4a49-b8e8-a802544b390f/wlw-de-api](https://parse.bot/marketplace/9dd2ec23-e71c-4a49-b8e8-a802544b390f/wlw-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/wlw-germany/`
**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 company details

Retrieve a full company profile including contacts, certificates, address, description, phone number, founding year, and supplier types. The slug parameter is obtained from search_companies results. Returns detailed company information not available in search results, such as full address, contact persons, VAT ID, and certificates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Company slug from search_companies results (e.g. 'metallbearbeitung-pabst-gmbh-cokg-472478'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wlw-germany/get-company-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get homepage featured

Retrieve trending products currently featured on the wlw.de homepage. Returns a list of featured product objects with name, image, price range, and link URL. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wlw-germany/get-homepage-featured \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search companies

Search for B2B supplier companies by keyword with optional filters for country, supplier type, employee count, and verification status. Returns paginated results sorted by relevance. Each company includes basic profile info (name, city, phone, employee count, supplier types) plus portfolio products. Pagination via page number; the total field gives the overall match count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `countries` | string | No | Country code filter. Accepted values: 'DE', 'AT', 'CH'. |
| `employee_counts` | string | No | Employee count range filter. Accepted values: '1-4', '5-9', '10-19', '20-49', '50-99', '100-199', '200-499', '500-999', '1000+'. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword (e.g. 'kunststoff', 'metall', 'stahl'). |
| `supplier_types` | string | No | Supplier type filter. Accepted values: 'production', 'service', 'distribution', 'wholesaler'. |
| `verified` | boolean | No | Only return verified companies when true. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wlw-germany/search-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"countries":"<string>","employee_counts":"<string>","page":"<integer>","query":"<string>","supplier_types":"<string>","verified":"<boolean>"}'
```

### Search products

Search for specific products and services listed on wlw.de by keyword. Returns paginated product listings with associated company information, pricing, images, and sell points. Pagination via page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword (e.g. 'kunststoff', 'metall', 'stahl'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/wlw-germany/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.