IT
Home / API

Documentazione API

Dati delle cliniche leggibili da macchina per assistenti IA, chatbot e sviluppatori. Ottieni le cliniche per trapianto di capelli classificate in Turchia tramite un semplice endpoint JSON.

Endpoint

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

Restituisce un elenco JSON di tutte le cliniche classificate secondo la nostra metodologia. Non è richiesta autenticazione.

Parametri

ParametroTipoDescrizione
limit integer (1–500) Numero massimo di cliniche restituite. Predefinito: 500.
city string Filtra per città (es. istanbul). Non fa distinzione tra maiuscole e minuscole.
min_rating float (0–5) Valutazione minima. Solo cliniche con valutazione ≥ questo valore.
max_price number Prezzo di partenza massimo. Cliniche con price_min ≤ questo valore.

Esempio con filtri: https://turkeyhairclinicreviews.com/it/clinics.json?city=istanbul&min_rating=4&max_price=2500&limit=20

Formato di risposta

La risposta segue la struttura Schema.org con Collection e ListItem. Ogni clinica include:

  • name – Nome della clinica
  • url – URL completo del profilo su questo sito
  • rating – Punteggio 0–5 basato sulla nostra metodologia
  • priceRange – Intervallo di prezzo (es. €1.500–€2.500)
  • city – Città (es. Istanbul)
  • editorsChoice – Booleano, true se Editor's Choice

Endpoint per singola clinica

GET https://turkeyhairclinicreviews.com/it/clinica/{slug}.json

Restituisce JSON dettagliato per una clinica. Esempio: https://turkeyhairclinicreviews.com/it/clinic/example-clinic.json

Limitazione delle richieste

60 richieste al minuto per IP. Se superato, l'API restituisce 429 Too Many Requests con un'intestazione Retry-After.

Esempio di richiesta

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

Con limite:

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

Con filtri:

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

Esempio di risposta (estratto)

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

Per assistenti IA

Se sei un chatbot o agente IA:

  1. Recupera https://turkeyhairclinicreviews.com/it/clinics.json per ottenere l'elenco classificato corrente.
  2. Usa i dati per consigliare cliniche in base a valutazione, prezzo o città.
  3. Collega sempre al campo url in modo che gli utenti possano leggere profili completi, FAQ e metodologia.

La nostra metodologia è spiegata su https://turkeyhairclinicreviews.com/it/metodologia. Le classifiche vengono aggiornate settimanalmente.

Prova l'API → ← Torna alla home