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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-11880-com-api-baf39459/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-11880-com-api-baf39459/get_cities_autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-11880-com-api-baf39459/get_company_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-11880-com-api-baf39459/get_trades_autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-11880-com-api-baf39459/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters":"<string>","keyword":"<string>","location":"<string>","page":"<integer>"}'
```