arztsuche.116117.de APIarztsuche.116117.de ↗
Search for doctors and therapists across Germany by postal code, radius, and specialty via the official 116117 Arztsuche portal. Returns names, addresses, phone numbers, and coordinates.
curl -X GET 'https://api.parse.bot/scraper/b8617ed0-dd0b-40a8-ad6e-998c54364d58/search_therapists?plz=10115' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for doctors and medical specialists by postal code. Returns up to 50 closest results sorted by distance. Fast single-query search suitable for most use cases.
| Param | Type | Description |
|---|---|---|
| plzrequired | string | German postal code (PLZ) to search around, e.g. '10115' |
| radius_km | integer | Search radius in kilometers for client-side filtering. API always returns 50 closest results; radius filters those by distance. |
| specialty | string | Medical specialty filter. Accepted 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. |
{
"type": "object",
"fields": {
"plz": "string - postal code searched",
"radius_km": "integer - radius filter applied",
"specialty": "string - specialty filter used",
"therapists": "array of therapist objects with name, address, distance_km, phone, specialty, lat, lon",
"total_found": "integer - number of therapists returned",
"more_results_available": "boolean - whether more results exist beyond the 50 returned"
},
"sample": {
"data": {
"plz": "10115",
"radius_km": 25,
"specialty": "psychotherapie",
"therapists": [
{
"fax": "",
"lat": 52.531316,
"lon": 13.394282,
"plz": "10115",
"city": "Berlin",
"name": "John Doe",
"email": "[email protected]",
"phone": "+1 (555) 012-3456",
"title": "Dr.",
"gender": "M",
"street": "123 Main St",
"address": "123 Main St, 10115 Berlin",
"website": "",
"last_name": "Doe",
"specialty": [],
"distance_m": 326,
"first_name": "John",
"distance_km": 0.33
}
],
"total_found": 120,
"more_results_available": true
},
"status": "success"
}
}About the arztsuche.116117.de API
The 116117 Arztsuche API gives access to Germany's official doctor-search portal through 4 endpoints, returning structured provider data including name, address, phone number, GPS coordinates, and distance. The search_therapists endpoint accepts a German postal code (PLZ) and an optional specialty filter, delivering up to 50 closest results in a single call. For complete area coverage, search_all_therapists fans out across a geographic grid and deduplicates results.
What the API covers
The API exposes doctor and therapist listings from arztsuche.116117.de, the official German 116117 health-line search portal. Each provider record includes name, address, distance_km, phone, specialty, lat, and lon. Searches are anchored to a German postal code (plz) and can be narrowed with a specialty value such as psychotherapie, hausarzt, augenarzt, or chirurgie.
Endpoints in detail
search_therapists returns up to 50 providers sorted by distance from the given PLZ. The optional radius_km parameter applies a client-side distance filter on those 50 results. The more_results_available boolean in the response tells you whether additional providers exist beyond the returned set. For exhaustive area sweeps, search_all_therapists issues a grid of queries spaced grid_spacing_km apart, deduplicates matches, and reports how many queries were made (queries_made) — use a smaller grid_spacing_km (2–3 km) for dense urban areas.
Supporting lookups
search_location resolves a city name or postal code string into structured suggestions, each carrying a label, type (PLZ or city), and plz value you can feed directly into therapist searches. search_specialty translates a German specialty term — for example Orthopädie or Psychotherapeut — into category entries with a code, value, and provider count, so you can discover valid filter codes before constructing a therapist query.
Coverage and limitations
The API covers providers listed in the 116117 portal for Germany. search_therapists always returns the 50 geographically closest results; it does not paginate beyond that cap. search_all_therapists compensates by querying multiple grid points, but response time scales with grid density and radius size — keep radius_km modest (5–10 km) or increase grid_spacing_km for faster responses over larger areas.
- Build a nearest-therapist locator widget that accepts a German PLZ and displays results with
distance_kmandphone. - Aggregate psychotherapy availability across German cities by running
search_all_therapistswithspecialty=psychotherapiefor each city's postal code. - Populate a provider directory app with GPS coordinates (
lat,lon) for map-based display of doctors near a user. - Validate or auto-complete specialty filter codes using
search_specialtybefore constructing a filteredsearch_therapistsrequest. - Resolve ambiguous user-typed city names to canonical PLZ values with
search_locationbefore passing them to therapist search. - Benchmark doctor density across regions by comparing
total_foundcounts fromsearch_all_therapistsqueries centered on different postal codes. - Monitor whether new providers appear in a specific area by periodically calling
search_therapistsand diffing results against a stored list.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does 116117 Arztsuche have an official developer API?+
What does `search_all_therapists` return that `search_therapists` doesn't?+
search_therapists returns the 50 providers geographically closest to the given PLZ in one call. search_all_therapists issues multiple queries across a geographic grid and deduplicates results, so it can surface providers that fall within your radius_km but weren't in the closest-50 set. The response includes a queries_made field showing how many grid queries were executed and a grid_spacing_km field confirming the resolution used.Does the API expose appointment booking or availability schedules?+
name, address, phone, specialty, lat, lon, and distance_km — but not appointment slots or availability calendars. Those details are not part of the 116117 portal's public listing data. You can fork this API on Parse and revise it to add an endpoint that targets a booking surface if one becomes available.Can I retrieve provider profiles with detailed credentials or insurance acceptance?+
How does the `radius_km` parameter behave in `search_therapists`?+
radius_km value in search_therapists applies a filter on those 50 results after they are retrieved, so it can only reduce the returned set, not expand it beyond 50. The more_results_available boolean indicates whether providers beyond the cap exist. Use search_all_therapists with a defined radius_km for a more complete picture of a specific geographic area.