# 11880 — 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 and discover millions of German businesses from 11880.com's comprehensive directory, instantly accessing company contact details, locations, and trade information. Get intelligent autocomplete suggestions for trades and cities to refine your business searches and find exactly who you're looking for.

**Category:** Business Directories | **Website:** [11880.com/](https://11880.com/) | **Docs:** [parse.bot/marketplace/baf39459-9496-41e8-969b-389c985e8441/11880-com-api](https://parse.bot/marketplace/baf39459-9496-41e8-969b-389c985e8441/11880-com-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/11880/`
**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 cities autocomplete

Get autocomplete suggestions for cities based on a partial city name. Returns up to 10 matching German cities with URL-safe slugs and representative zip codes. Supports German umlauts in input. Useful for discovering valid location values before calling search_companies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial city name to search for (e.g. "berl" for Berlin, "muen" for Muenchen). Supports German umlauts. |

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

### Get company details

Retrieve comprehensive details for a specific company using its 11880.com detail page URL. Returns structured contact info (phone, email, website), physical address with geo coordinates, opening hours for each day of the week, aggregated rating and individual reviews, and accepted payment methods. The URL is obtained from search_companies results[*].detail_url.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The 11880.com detail page URL, as returned in search_companies results[*].detail_url. |

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

### Get trades autocomplete

Get autocomplete suggestions for industries and trades based on a partial search string. Returns up to 10 matching trade suggestions with their identifiers. Useful for discovering valid keyword values before calling search_companies.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial search string for industries or trades (e.g. "rest" for Restaurant). |

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

### Search companies

Search for companies by keyword and location in the 11880.com directory. Returns paginated business listings with name, address, phone, and rating. The keyword matches trades or company names; the location scopes results to a city. Pagination is page-based starting at 1. An optional filters JSON string narrows results further (e.g. opening_hours, rating).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filters` | string | No | JSON string of filters to apply, e.g. {"opening_hours": "true", "rating": "4"}. |
| `keyword` | string | No | Industry or company name to search for. |
| `location` | string | No | City name to search in. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/11880/search-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"filters":"<string>","keyword":"<string>","location":"<string>","page":"<integer>"}'
```

## 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.