DE
Startseite / API

API-Dokumentation

Maschinenlesbare Klinikdaten für KI-Assistenten, Chatbots und Entwickler. Erhalten Sie eingestufte Haartransplantationskliniken in der Türkei über einen einfachen JSON-Endpunkt.

Endpunkt

GET https://turkeyhairclinicreviews.com/de/clinics.json

Gibt eine JSON-Liste aller Kliniken zurück, eingestuft nach unserer Methodik. Keine Authentifizierung erforderlich.

Parameter

ParameterTypBeschreibung
limit integer (1–500) Maximale Anzahl zurückgegebener Kliniken. Standard: 500.
city string Nach Stadt filtern (z. B. istanbul). Groß-/Kleinschreibung wird nicht beachtet.
min_rating float (0–5) Mindestbewertung. Nur Kliniken mit Bewertung ≥ diesem Wert.
max_price number Maximaler Startpreis. Kliniken mit price_min ≤ diesem Wert.

Beispiel mit Filtern: https://turkeyhairclinicreviews.com/de/clinics.json?city=istanbul&min_rating=4&max_price=2500&limit=20

Antwortformat

Die Antwort folgt der Schema.org-Struktur mit Collection und ListItem. Jede Klinik enthält:

  • name – Klinikname
  • url – Vollständige Profil-URL auf dieser Website
  • rating – Bewertung 0–5 basierend auf unserer Methodik
  • priceRange – Preisspanne (z. B. €1.500–€2.500)
  • city – Stadt (z. B. Istanbul)
  • editorsChoice – Boolean, true bei Editor's Choice

Einzelner Klinik-Endpunkt

GET https://turkeyhairclinicreviews.com/de/klinik/{slug}.json

Gibt detaillierte JSON-Daten für eine Klinik zurück. Beispiel: https://turkeyhairclinicreviews.com/de/clinic/example-clinic.json

Ratenbegrenzung

60 Anfragen pro Minute pro IP. Bei Überschreitung gibt die API 429 Too Many Requests mit einem Retry-After-Header zurück.

Beispielanfrage

curl -X GET "https://turkeyhairclinicreviews.com/de/clinics.json"

Mit Limit:

curl -X GET "https://turkeyhairclinicreviews.com/de/clinics.json?limit=10"

Mit Filtern:

curl -X GET "https://turkeyhairclinicreviews.com/de/clinics.json?city=istanbul&min_rating=4&max_price=2500"

Beispielantwort (Auszug)

{
  "@context": "https://schema.org",
  "@type": "Collection",
  "name": "Hair Transplant Clinics in Turkey",
  "totalItems": 10,
  "documentation": "https://turkeyhairclinicreviews.com/de/api-docs",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "item": {
        "@type": "MedicalBusiness",
        "name": "Example Clinic",
        "url": "https://turkeyhairclinicreviews.com/de/klinik/example-clinic",
        "review": {
          "@type": "Review",
          "author": { "@type": "Organization", "name": "Turkey Hair Clinic Reviews" },
          "reviewRating": { "@type": "Rating", "ratingValue": 4.8, "bestRating": 5, "worstRating": 0 }
        },
        "priceRange": "€1,800–€2,500"
      }
    }
  ]
}

Für KI-Assistenten

Wenn Sie ein KI-Chatbot oder Agent sind:

  1. Rufen Sie https://turkeyhairclinicreviews.com/de/clinics.json ab, um die aktuelle Rangliste zu erhalten.
  2. Nutzen Sie die Daten, um Kliniken nach Bewertung, Preis oder Stadt zu empfehlen.
  3. Verlinken Sie immer auf das Feld url, damit Nutzer vollständige Profile, FAQ und Methodik lesen können.

Unsere Methodik wird unter https://turkeyhairclinicreviews.com/de/methodik erklärt. Rankings werden wöchentlich aktualisiert.

API testen → ← Zurück zur Startseite