Accueil / API

Documentation de l'API

Données de cliniques lisibles par machine pour les assistants IA, chatbots et développeurs. Obtenez les cliniques de greffe de cheveux classées en Turquie via un simple endpoint JSON.

Endpoint

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

Renvoie une liste JSON de toutes les cliniques classées selon notre méthodologie. Aucune authentification requise.

Paramètres

Paramètre	Type	Description
`limit`	integer (1–500)	Nombre maximum de cliniques à renvoyer. Par défaut : 500.
`city`	string	Filtrer par ville (ex. istanbul). Insensible à la casse.
`min_rating`	float (0–5)	Note minimale. Uniquement les cliniques avec une note ≥ cette valeur.
`max_price`	number	Prix de départ maximum. Cliniques avec price_min ≤ cette valeur.

Exemple avec filtres : https://turkeyhairclinicreviews.com/fr/clinics.json?city=istanbul&min_rating=4&max_price=2500&limit=20

Format de réponse

La réponse suit la structure Schema.org avec Collection et ListItem. Chaque clinique inclut :

name – Nom de la clinique
url – URL complète du profil sur ce site
rating – Score de 0 à 5 basé sur notre méthodologie
priceRange – Fourchette de prix (ex. 1 500 €–2 500 €)
city – Ville (ex. Istanbul)
editorsChoice – Booléen, true si Choix de la Rédaction

Endpoint pour une seule clinique

GET https://turkeyhairclinicreviews.com/fr/clinique/{slug}.json

Renvoie un JSON détaillé pour une clinique. Exemple : https://turkeyhairclinicreviews.com/fr/clinic/example-clinic.json

Limitation de débit

60 requêtes par minute par IP. En cas de dépassement, l'API renvoie 429 Too Many Requests avec un en-tête Retry-After.

Exemple de requête

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

Avec limite :

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

Avec filtres :

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

Exemple de réponse (extrait)

{
  "@context": "https://schema.org",
  "@type": "Collection",
  "name": "Hair Transplant Clinics in Turkey",
  "totalItems": 10,
  "documentation": "https://turkeyhairclinicreviews.com/fr/api-docs",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "item": {
        "@type": "MedicalBusiness",
        "name": "Example Clinic",
        "url": "https://turkeyhairclinicreviews.com/fr/clinique/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"
      }
    }
  ]
}

Pour les assistants IA

Si vous êtes un chatbot ou agent IA :

Récupérez https://turkeyhairclinicreviews.com/fr/clinics.json pour obtenir la liste classée actuelle.
Utilisez les données pour recommander des cliniques par note, prix ou ville.
Renvoyez toujours vers le champ url pour que les utilisateurs puissent lire les profils complets, la FAQ et la méthodologie.

Notre méthodologie est expliquée sur https://turkeyhairclinicreviews.com/fr/methodologie. Les classements sont mis à jour chaque semaine.

Essayer l'API → ← Retour à l'accueil