Register · Developers

Embedding the register

Add a search of Türkiye's official health-tourism register to your site with a widget, an HTML form, a badge or the JSON API.

Overview

healthturkey.co mirrors the Republic of Türkiye Ministry of Health's register of facilities authorised to treat international patients, and checks it daily. You can add a search of that register to your own site in one of three ways:

All three are free and need no API key or sign-up. Every result links to the facility's record on healthturkey.co.

Quick start

Paste this where the search box should appear:

<div data-healthturkey="search" data-theme="light">
  <a href="https://healthturkey.co/">Register search by healthturkey.co</a>
</div>
<script src="https://healthturkey.co/embed/search.js" async></script>

That is all. The script finds every data-healthturkey element on the page and turns it into a search box. Include the <script> tag once, even with several widgets on the page.

Attribution requirement

Each snippet contains a link to healthturkey.co. The widget only works while that link is in place:

• The link must be in the page's HTML, inside the widget element, as in the snippet.
• It must not carry rel="nofollow", ugc or sponsored, and the page must not have a nofollow robots meta tag.
• It must be visible: no display:none, zero opacity or tiny text. You may change the link text, as long as it still names healthturkey.co.

The widget checks this on every load and shows a short notice instead of the search box if the link fails. We also check each embedding page once a day; if the link is missing, lookups from that site return no results until it is restored. No action is needed on your side beyond putting the link back.

Search

Search box with results listed below it. Matches on clinic name, legal name or authorisation number. Each result shows type, city, number and register status, and opens the record on healthturkey.co in a new tab.

<div data-healthturkey="search" data-theme="light">
  <a href="https://healthturkey.co/">Register search by healthturkey.co</a>
</div>
<script src="https://healthturkey.co/embed/search.js" async></script>

Compact search

Single-line version for sidebars and headers. Results open in a dropdown and close on Esc or an outside click.

<div data-healthturkey="compact" data-theme="light">
  <a href="https://healthturkey.co/">Register search by healthturkey.co</a>
</div>
<script src="https://healthturkey.co/embed/search.js" async></script>

Licence-number check

Takes an authorisation number and returns one of three answers: in the register, no longer in the register, or no facility with that number. Matching is exact.

<div data-healthturkey="licence" data-theme="light">
  <a href="https://healthturkey.co/">Authorisation numbers checked against healthturkey.co</a>
</div>
<script src="https://healthturkey.co/embed/search.js" async></script>

Configuration

Attributes

CSS variables

The widget uses your page's font and the full width of its container. Colours can be overridden on the element or any parent:

[data-healthturkey] {
  --ht-accent: #0B5FD9;
  --ht-radius: 8px;
}

HTML form

No script. Submitting opens the search results on healthturkey.co in a new tab. It takes your site's own form styles.

<form action="https://healthturkey.co/" method="get" target="_blank">
  <label for="ht-q">Check a clinic in Türkiye's health-tourism register</label>
  <input id="ht-q" type="search" name="q" placeholder="Clinic name or ST number" required>
  <button type="submit">Check</button>
  <p><a href="https://healthturkey.co/">Register search by healthturkey.co</a></p>
</form>

Clinic badge

An image for a facility's own website. It carries the healthturkey.co mark, the register status, the licence number and the date of the last check, and updates when the register changes — a facility that leaves the register gets a badge that says so. It is a plain image link to the facility's record, where a visitor can check the claim; no script runs on your page.

Preview Taki Dent

<a href="https://healthturkey.co/clinic/taki-dent-antalya" target="_blank" rel="noopener" title="Check this licence on healthturkey.co">
  <img src="https://healthturkey.co/badge/taki-dent-antalya.svg" width="300" height="74" loading="lazy"
       alt="Taki Dent — verified in the official Turkish health-tourism register" />
</a>

For dark backgrounds add ?theme=dark to the image URL.

Lookup endpoint

GET https://healthturkey.co/api/public/lookup?q={query}

No authentication. CORS is open to all origins. Responses are cached for 24 hours; the register is updated once a day. The attribution requirement applies: link each result to its url and show a followed link to healthturkey.co where the results appear.

Example response

{
  "query": "ST-6335",
  "results": [
    {
      "name": "Taki Dent",
      "legal_name": "Özel Taki Dent Ağız ve Diş Sağlığı Polikliniği",
      "type": "Private Oral and Dental Health Clinic",
      "city": "Antalya",
      "authorisation_number": "ST-6335",
      "status": "listed",
      "url": "https://healthturkey.co/clinic/taki-dent-antalya"
    }
  ],
  "more_url": "https://healthturkey.co/?q=ST-6335",
  "source": "https://healthturkey.co/methodology"
}

Response fields

Other endpoints

See also the dataset page and the methodology.

Troubleshooting

The browser console shows the same reason, prefixed [healthturkey].

FAQ

Is it free?

Yes. No key, no quota to request.

Where does the data come from?

From the public records of the Republic of Türkiye Ministry of Health, checked daily. healthturkey.co is independent of the Ministry. See methodology.

Can I show results on my own page?

Yes, with the API. Link each result to its record.