This API allows for programmatic searching of and retrieval from the extensive Nucleus medical visuals catalog via a simple request/response vocabulary, allowing for the integration of Nucleus's thousands of medical images and animations within partner applications.
Check out these example implementations:
All requests should be sent to the server at content-api.nucleusmedical.media over https.
Requests must always include a header named 'X-Nucleus-Content-Api-Key' whose value must be an active Nucleus Content API key. Contact a Nucleus representative if you don't have an API key or if you require a new one.
The following argument is optional on all calls:
Additional optional and required arguments specific to each endpoint are documented below.
{
"error-num": 0,
"error-message": "",
"error-message-detail": "",
"status-code": 200,
"api-version": "0.8",
"result": {
"count": 1,
"page": 1,
"matches": [
{
"item-id": "71328",
"vendor-number": "exh71413a",
"title": "Male figure with Brain Injury, Damage to the Spleen and Liver, and Fractures of the Arm and Legs Bilaterally",
"description": "This medical exhibit depicts a silhouette (outline) view of the full body revealing the skeletal anatomy from the skull down to the feet and showing the brain within the skull, the lungs within the ribcage and the liver and spleen within the abdomen. This image acts as an overall orientation to the various major injuries in this case and will include traumatic brain injury, multiple facial fractures, right humerus fracture, right brachial plexus injury, left radius fracture, multiple rib fractures, hemothorax, bilateral pneumothorax and lung contusions, liver laceration, spleen laceration, L4 and L5 transverse process fractures, pelvic fractures and right knee and ankle fractures.",
"language": "en",
"type": "Medical Exhibit",
"last-modified": "2020-03-05",
"status": "Published",
"match-relevance": "222",
"thumb-path": "https://api.nucleusmedical.media/v1/thumb/exh71413a/128",
"view-path": "https://nmal.nucleusmedicalmedia.com/view-item?ItemID=71328"
}
]
}
}{
"error-num": 0,
"error-message": "",
"error-message-detail": "",
"status-code": 200,
"api-version": "0.8",
"result": {
"count": 1,
"matches": [
{
"item-id": "78588",
"title": "Treating High Blood Sugar",
"vendor-number": "AND13013",
"description": "MEDICAL ANIMATION TRANSCRIPT: This video will teach you how to manage and treat high blood sugar. Please watch the entire video before treating your high blood sugar. After you eat food that contains carbohydrates, your body breaks it down into a sugar called glucose. Your body makes a hormone called insulin that helps you either use or store blood sugar. When you have diabetes, your body does not make enough insulin or cannot use the insulin it makes properly. This can cause you to have too much sugar in your blood, which is a condition called hyperglycemia. Hyperglycemia can happen when you do not take enough insulin or diabetes medicine; take other medicines that increase blood sugar; eat more food or carbohydrates than you usually do; do not get enough exercise or physical activity; get sick, injured, or have surgery; have emotional stress, such as family or work problems; or have changes to hormone levels, such as during menstrual periods. If you have hyperglycemia or your blood sugar is too high, you may feel very thirsty and have to urinate a lot. You may also feel very tired and notice your vision is blurry. If you do not treat hyperglycemia, your blood sugar may build up to a dangerously high level, requiring you to seek immediate emergency care. The first step to understanding how to treat high blood sugar is knowing your normal blood sugar target range. If you feel or notice symptoms of hyperglycemia, be sure to check your blood sugar level right away. If your blood sugar is above your target range make sure you drink plenty of water or other sugar free liquids to stay hydrated. Take your insulin or diabetes medication the way your health care provider says you should. Do not take extra medication without first checking with your health care provider. Check your blood sugar every four hours. Follow your normal meal plan and increase your physical activity or exercise if you can. Do not exercise if your blood sugar is above 240. Exercise may make your blood sugar level go even higher. Contact your health care provider if your blood sugar stays above your target range or you notice the following symptoms that may need immediate treatment-- shortness of breath, breath that smells fruity, or your mouth feels very dry. You can help prevent hyperglycemia by regularly checking your blood sugar, following your normal meal plan, taking your diabetes medication as prescribed by your doctor, controlling stress, and exercising regularly.",
"language": "en",
"last-modified": "2020-07-02",
"thumb-path": "https://api.nucleusmedical.media/v1/thumb/AND13013/128",
"view-path": "https://nmal.nucleusmedicalmedia.com/view-item?ItemID=78588"
}
]
}
}{
"error-num": 0,
"error-message": 0,
"result": {
"urls": {
"AND13013": "https://images.nucleusmedical.media/AND13013_b34f10ddbdc4c267dd41e8a5b31d690c/ff3261fa/AND13013/H270xW480/image.jpg"
}
}
}{
"error-num": 0,
"error-message": "",
"error-message-detail": "",
"status-code": 200,
"api-version": "0.8",
"result": {
"count": 3,
"matches": [
{
"type-id": "1",
"type-name": "Animation"
},
{
"type-id": "1024",
"type-name": "Medical Exhibit"
},
{
"type-id": "256",
"type-name": "Stock Illustration"
}
]
}
}{
"error-num": 0,
"error-message": "",
"error-message-detail": "",
"status-code": 200,
"api-version": "0.8",
"result": {
"count": 2,
"matches": [
{
"language-id": "en",
"language-name": "English"
},
{
"language-id": "es",
"language-name": "Español (Spanish)"
}
]
}
}API responses are formatted as JSON and include error-num, error-message, status code, and current API version elements at a minimum. An error-num value greater than zero indicates a failure. The error-message value provides additional information about the failure.
If the error-num value is zero, the repsonse will also include a result element which contains the results of the request.