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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-wlw-de-api-9dd2ec23/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-wlw-de-api-9dd2ec23/get_company_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wlw-de-api-9dd2ec23/get_homepage_featured \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wlw-de-api-9dd2ec23/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-wlw-de-api-9dd2ec23/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```