# Arztsuche 116117 — 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.

> Find therapists and doctors across Germany by postal code, radius, or medical specialty, getting detailed results with names, addresses, distances, and contact information. Quickly locate healthcare providers that match your needs using Germany's official 116117 doctor search portal.

**Category:** Healthcare | **Website:** [arztsuche.116117.de/](https://arztsuche.116117.de/) | **Docs:** [parse.bot/marketplace/8f6c4a2a-9478-4aaa-a8a8-ec506b56cfb8/arztsuche-116117-de-api](https://parse.bot/marketplace/8f6c4a2a-9478-4aaa-a8a8-ec506b56cfb8/arztsuche-116117-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-arztsuche-116117-de-api-8f6c4a2a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### search_all_therapists

Comprehensive search for all doctors and medical specialists within a radius using a grid of geographic queries with deduplication. Makes multiple API calls to cover the full area. Slower but thorough — returns all unique results within the radius, not just the 50 closest. Best with smaller radii (5-10 km) or larger grid spacing for bigger areas.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `grid_spacing_km` | number | No | Distance between grid query points in km. Smaller values are more thorough but slower. Recommended: 2-3 for small areas, 5-8 for large areas. |
| `plz` | string | Yes | German postal code (PLZ) as the center point, e.g. '10115' |
| `radius_km` | integer | No | Search radius in kilometers |
| `specialty` | string | No | Medical specialty filter (same values as search_therapists) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arztsuche-116117-de-api-8f6c4a2a/search_all_therapists \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"grid_spacing_km":"<number>","plz":"<string>","radius_km":"<integer>","specialty":"<string>"}'
```

### search_location

Look up a location by name or postal code. Returns location suggestions with type (PLZ, city, OSM) that can inform the plz parameter for therapist searches. Useful for resolving ambiguous location input into a specific postal code.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Location search query - postal code or city name, e.g. '10115' or 'Berlin' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arztsuche-116117-de-api-8f6c4a2a/search_location \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_specialty

Search for medical specialties and their filter codes. Returns matching specialty categories with codes that can be used as the specialty parameter in therapist searches. Each category contains entries with a numeric code, display value, and result count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Specialty search query, e.g. 'Psychotherapeut', 'Hausarzt', 'Orthopädie' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arztsuche-116117-de-api-8f6c4a2a/search_specialty \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_therapists

Search for doctors and medical specialists by postal code. Returns up to 50 closest results sorted by distance. The API returns a fixed window of 50 nearest matches; the radius_km parameter filters those client-side. Use search_all_therapists for complete coverage beyond 50 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `plz` | string | Yes | German postal code (PLZ) to search around, e.g. '10115' |
| `radius_km` | integer | No | Search radius in kilometers for client-side filtering. API always returns 50 closest results; radius filters those by distance. |
| `specialty` | string | No | Medical specialty filter. Accepted named values: 'psychotherapie', 'hausarzt', 'augenarzt', 'chirurgie', 'frauenheilkunde', 'hno', 'hautarzt', 'kinderarzt', 'orthopaedie', 'urologie', 'innere_medizin', 'neurologie_psychiatrie', 'kinder_jugendpsychiatrie', 'all'. Can also pass a numeric code from search_specialty. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-arztsuche-116117-de-api-8f6c4a2a/search_therapists \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plz":"<string>","radius_km":"<integer>","specialty":"<string>"}'
```