NHS Syndication

NHS Choices syndication provides the ability to take NHS Choices content and embed into your website, mobile application, or any internet-enabled device or portal. The documentation contained within this site will give you guidance on how to do so, and where to start. Syndication is covered by:

Matt George – NHS organisations, government and local authorities, content management providers, third sector and charity

Richard Moore – Commercial partners, mobile application developers

Alejandra Diaz – Individuals and any other enquiries

NHS Health Check – your midlife MOT

The NHS Health Check is your chance to get a free midlife MOT. For adults in England aged 40-74 without a pre-existing condition, the NHS Health Check will assess your risk of getting a vascular disease like type 2 diabetes, stroke, heart disease or chronic kidney disease. This guide explains what happens at the NHS Health Check, when and how you can get one, and what you could do to lower your risk.

This content is now available via a widget and content feedswith all the supporting information available on how to embed it.

Additionally, we have lots of related lifestyle and health tips, which will enable you to offer a comprehensive package of information – now including videos highlighting the benefits of having an NHS Health Check.


For information on how to use the NHS Health Check content effectively, please speak to louise.cleaver@phe.gov.uk. For help with implementing the content, or how to use the supporting material, speak to alejandra.diaz@nhs.net. You can also access related content, tools, widgets and videos that allow you communicate better the NHS Health Check message.

Additional content available

This spreadsheet outlines supporting information, such as videos tools and widgets, that can help you to back up your messages around the NHS Health Check. If you want to take the content via the full syndication route, the links are also shared here. We’ve also broken the supporting articles into lifestyle sections, to help you position them correctly.

If you wish to syndicate any of NHS Choices content-marked widgets, please get in touch with the syndication team, who can help you to build them. Additionally, find some guidance on how to embed NHS Choices videos on your digital platforms.


Care Act Syndication Opportunities for Local Authorities

The Care Act places a requirement on each local authority to provide information about local care providers and advice on relevant care topics, either individually or in partnership with other authorities. NHS Choices provides a significant amount of health and social care content, which can be consumed by third party sites without charge.

Integrating NHS Choices content into local authority sites offers an extremely cost-effective way of meeting the advice and information requirements of the Care Act. The attached paper aims to highlight key areas of the content that is available for syndication and how it might be implemented. It is intended to promote discussion that may lead to a set of requirements/specifications.

Download (PDF, Unknown)

Patient safety data

A new set of data for performance of hospitals on patient safety has been released as part of Secretary of State for Health’s new campaign to make the NHS the safest healthcare system in the world.

The NHS choices website already offers data on hospitals according to waiting times, facilities, specialist treatments, or consultants. This set of data is now complemented by their performance on patient safety and is available for syndication in .xml format.

You can search for hospitals in England by postcode or location, and find out how they are performing. Hospitals are ranked by how they are doing in terms of infection control and cleanliness but also their CQC rating, safe staffing levels, or patient safety reporting.

You need an APIKEY to syndicate this data. If you do not have an APIKEY, you need to sign up to our syndication programme, where you will obtain an APIKEY that grant you access to the data feeds.

Syndication uses a single entry point (see below) to store the indicator metrics; from here, you can access the relevant metrics by using the IDs, and grouping them together to replicate the functionality on NHS Choices website.

An example implementation for a hospital is:


You will find the data related to the following categories and their respective IDs:

Care Quality Commission national standards (ID – 103010)

Infection control and cleanliness (ID – 8093)

StaffSurveyWouldRecommend  (ID – 183)

Percentage of admitted patients assessed for blood clots (ID – 5074)

NHS England patient safety notices (ID – 5104)

Open and honest reporting (ID – 8092)

Staff Survey Standard of Care (ID – 182)

New video embed codes

New video embed codes have been launched in Conditions and Behind the Headlines to meet the requirements of developers building responsive designed websites.

The new embed codes deliver Brightcove’s Smart Player which is a Video Cloud video player that is capable of running as a Flash player or as an HTML5 player. When a smart player loads using the JavaScript player publishing code, it detects the device that is loading it. If the device supports Flash, then the player loads in Flash mode. If the device does not support Flash, but does support HTML5, then the player loads in HTML5 mode.

HTML5 mode is supported only for Apple iOS and Android OS devices. You can test whether any given device supports HTML5 mode by visiting http://admin.brightcove.com/html5support/index.html using the device’s browser. That test page will report explicitly whether the device is compatible with Video Cloud HTML5 players.

The embed codes deliver a chromeless player as below:

Video player

To use the new embed codes simply refresh your cached content by accessing the feeds. All previous Behind the Headlines stories have been updated with the new embed code.

Launch of Organisation API for care home providers to post profile information into NHS Choices

Every month, millions of visitors search for health and care services on NHS Choices. Users can search for detailed information on care homes and domiciliary care services including, facilities, staff and service specialities.

Each social care organisation has the ability to update its own profile but it has become clear that many profiles remain incomplete. The Organisation API will solve this problem by enabling providers and their partners to update information on behalf of individual and multiple social care organisations.

By using the API, providers of multiple social care organisations will avoid the time consuming task of updating service information on many different profile pages as the API enables profile updates from corporate websites. Providers without technical resources can also benefit. They can nominate one out of five comparison site partners to have editing rights on their profiles. The partner will then use the API to update the listing information from its own site, through the API, directly into the provider’s profile page.

Currently, the API supports updates to the ‘Overview’, ‘Services’, ‘Contact, map and Directions’ tabs. The ability to post photos and information in the ‘What we Offer’ tab will follow later in the year.

A similar service for pharmacy providers will be completed by the end of July and will allow pharmacists to update overview information, opening hours and a list of services. We are also looking to extend the API to other organisation types in the near future.

The Organisation API is organised around RESTful principles – each resource has a unique URI, and HTTP verbs are used to specify the action to perform on that resource.To write a client application for the API, syndication partners will need to use a full-featured HTTP client library that supports the HTTP verbs: GET, POST, PUT and DELETE. Most modern development languages including .NET, PHP, Ruby and Java will communicate with the API.

Partners looking to build apps using GET requests  to access social care provider information should continue using the V1 syndication feeds. The GET requests that form part of this service should only be used by partners looking to post information into NHS Choices.

To use the service, partners will need to register for an API key from:


Providers will also need to contact the Service Desk (servicedesk@nhschoices.nhs.uk) to order to link their profile(s) to the API.

For further information please email the Service Desk for a user guide.

NHS symptom checkers

The NHS symptom checkers help users assess symptoms and advice on the best possible treatment for specific conditions. The tools guide users through a series of questions that seek to establish their current health situation depending on gender, age and other physical and mental factors.

In order to access the tool for use on your website, you need to follow the instructions and register through our NHS Choices website. You will be given a unique URL which contains a unique code to access the tools. This URL will direct you to the symptom checker of your preference and embed it into your website by using the iframe function.


We have over 45 different symptom checkers customised for different conditions. Please make sure you interlink the symptom checker pages to other relevant content pages, so that users can easily find them, maximising their value on your website.

You can find more supporting information in the following guides:

Syndication Introduction Factsheet

iFrames FAQs


XML Implementation Checklist

XML style guide

Developers Guide

If you experience any problems please email servicedesk@nhschoices.nhs.uk

NHS Choices attribution logo for syndication

Any NHS Choices syndicated content must incorporate the following attribution (credit) to NHS Choices:



The logo should be placed, above the fold, and remain clearly visible in line with the associated content on every web page that contains the NHS Choices syndicated content. You should also link this logo to the relevant page on the NHS Choices website that the content has been supplied from. This URL is supplied as part of the feed.

If you are displaying NHS Choices Syndicated Content in a context where a functional link back to the article on the NHS Choices website is not possible then you should use the following attribution (credit):

From www.nhs.uk.

Using the Brightcove API to return videos

This post quickly summarises how to use the Brightcove API to pull back a video. Please refer to other posts for information about multiple renditions, and other methods. All data is returned in .json.

You’ll first need a token – speak to your relevant syndication manager, who can supply you with one. This token will enable you to access the video library in read format, making calls to pull back content based on criteria.

To retrieve all records, with no filtering or specific criteria, the call would look like:


This will return the entire information associated with our videos. In order to narrow down the content, such as returning a single video, you need to add criteria to filter the list.

To do this for a single video, the call would look like this:


where video_id is the ID of the video you’re trying to find. You could use the initial call to return and parse the IDs from the entire list, and then pull each video based on this ID using the second call.

This will return the entire information based on a single video. From here, you can work with the information, such as accessing the rendition (stored within FLVURL). You can then apply other methods and criteria as required. For further information on how to use these criteria and methods, see http://support.brightcove.com/en/video-cloud/docs/how-to-search-videos-media-api#searchTerms and http://docs.brightcove.com/en/video-cloud/media/reference.html#Video_Read.


Implementing services demo: using RUBY

We’ve created an example of how to build a services application, using a scripting language (RUBY in this case). This should allow you to see how the process works, and can be applied across services, as well as organisations. It doesn’t matter what language you use – this should show you how to get started. You can see the entire project at GitHub, which also contains an explanation of what we’ve done. We hope to release more of these over the coming months.

Syndicate content using SNOMED CT via How Are You? API

  • All medical terms in this platform are expressed as SNOMED concept IDs. SNOMED CT is an international standard for clinical terminologies that is essential for interoperability of electronic health records, apps and devices.
  • Through their partnership with NHS Choices, they now provide all NHS Choices articles on conditions and treatments as part of the RESTful API.
  • Conditions are searchable both by primary terms and synonyms. Most importantly, you can find all articles for a condition by the SNOMED concept ID. For example, this is a direct link to a JSON representation of Arthritis and all NHS Choices articles for this condition.

For further information, please see http://blog.howareyou.com/post/60346857949/easily-syndicate-content-from-nhs-choices-using-snomed.

Please note that this API has been developed by a third party, and is not directly supported by NHS Choices.