# Local — 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 Swiss businesses and retrieve their contact details, addresses, phone numbers, opening hours, and website URLs directly from the local.ch directory. Look up companies by name, category, or location, and perform reverse phone number lookups.

**Category:** Business Directories | **Website:** [local.ch/](https://local.ch/) | **Docs:** [parse.bot/marketplace/54de2eb4-bd4b-4677-865b-218d98e2d57f/local-ch-api](https://parse.bot/marketplace/54de2eb4-bd4b-4677-865b-218d98e2d57f/local-ch-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-local-ch-api-54de2eb4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_business_detail

Get detailed information for a specific business listing using its local.ch URL. Returns available contact details, opening hours, ratings, images, and description. Not all fields are populated for every business — fields may be null or empty depending on what the business has listed. The url parameter is obtained from the detail_url field in search_businesses results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full local.ch business detail URL (e.g. 'https://www.local.ch/en/d/zurich/8001/restaurant/george-bar-grill-E2FE14_t_A8FFW9_xUkXBQ'). Obtained from the detail_url field in search_businesses results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-local-ch-api-54de2eb4/get_business_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### phone_number_lookup

Lookup business or person details by phone number on local.ch. Returns matching directory entries. Coverage depends on what is listed in the directory — not all phone numbers will return results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `phone_number` | string | Yes | Swiss phone number to look up. Accepts formats with or without spaces (e.g. '044 250 50 50' or '0442505050'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-local-ch-api-54de2eb4/phone_number_lookup \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"<string>"}'
```

### search_businesses

Search for businesses in the local.ch directory by keyword and location. Returns a paginated list of business listings with basic contact information. Pagination is page-number based. Each result includes a detail_url for fetching full business information via get_business_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `what` | string | Yes | Search keyword for business type or name (e.g. 'garage', 'restaurant', 'bank') |
| `where` | string | Yes | Location to search in, typically a Swiss city name (e.g. 'Zurich', 'Geneva', 'Basel') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-local-ch-api-54de2eb4/search_businesses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","what":"<string>","where":"<string>"}'
```