---
title: "Freigeschaltete Anbieter mit Bewertungen suchen"
method: POST
path: "/rpc/search_providers"
---

# Freigeschaltete Anbieter mit Bewertungen suchen

`POST /rpc/search_providers`

## Request

- Base URL: `https://pcbyuhvyjgadanzlghmw.supabase.co/rest/v1`
- URL: `https://pcbyuhvyjgadanzlghmw.supabase.co/rest/v1/rpc/search_providers`
- Auth: API key in header `apikey`

Sortiert nach Durchschnitt der Bewertungen, dann Anzahl, dann Name. Keine bezahlten Platzierungen. Ohne Kontaktdaten – den Kontakt stellt der Betreiber her. Mit near und radius_km: Umkreissuche, dann nach Entfernung sortiert (distance_km, Luftlinie).

## Request body

- object
  - `q` string: Stichwort (z. B. "Fußpflege") oder Anfang der Postleitzahl (z. B. "69").
  - `max_results` integer
  - `near` string: 5-stellige Postleitzahl als Mittelpunkt der Umkreissuche.
  - `radius_km` integer: Umkreis in km um near.

## Response `200`

Liste der Anbieter

- Provider[]
  - `id` integer
  - `name` string
  - `place` string
  - `tier` 1 | 2 | 3
  - `services` string
  - `rating_avg` number, nullable: Durchschnitt 1–5, nur aus Bewertungen vermittelter Kunden
  - `rating_count` integer
  - `distance_km` number, nullable: Entfernung in km (Luftlinie), nur bei Umkreissuche.
  - `provider_type` 'local' | 'robotics_setup' | 'tele_helper' | 'robotics_provider': Art des Anbieters: local = lokaler Helfer/Handwerker, robotics_setup = Vor-Ort-Profi für Roboter-Einrichtung, tele_helper = Tele-Helfer (Fernsteuerung), robotics_provider = bundesweiter Robotik-Hersteller/Fachhändler
  - `is_nationwide_partner` boolean: true = bundesweit lieferbar / tätig (wird bei regionalen Suchen ergänzend angezeigt)
  - `local_helpers_count` integer: Anzahl verfügbarer lokaler Helfer in der gesuchten PLZ-Region für die Vor-Ort-Einrichtung

---

[API](https://skmtc.dev/helferundprofi/apis/helfer-profi-schnittstelle-fur-ki-assistenten.md) · [All operations](https://skmtc.dev/helferundprofi/apis/helfer-profi-schnittstelle-fur-ki-assistenten/llms.txt) · [OpenAPI document](https://skmtc.dev/helferundprofi/apis/helfer-profi-schnittstelle-fur-ki-assistenten/revisions/2a74a4c15577?raw)