MEDS API Documentation Title

 

 

Browse our guides and interact with our API reference for more information about MEDSAPI DynaMed/DynaMedex. Try MEDSAPI DynaMed/DynaMedex and learn about core concepts.

 

 

 

 

Retrieving An Article by Slug

The DynaMed API GET  /v2/content/slug/{slug} endpoint returns the article matching the slug provided.  The slug to retrieve is a required parameter for the endpoint.

To Get a Basic Article (example):

Gather the following information for the request:

Request

GET https://apis.ebsco.com/medsapi-dynamed/v2/content/slug/condition/acute-heart-failure

The request above is for slug /condition/acute-heart-failure.

Response

{
  "id": "t115279",
  "title": "Acne",
  "slug": "/condition/acne",
  "links": [
    {
      "href": "https://apis.ebsco.com/medsapi-dynamic-health/v2/content/slug/condition/acute-heart-failure",
      "rel": "self"
    }
  ],
  "metadata": {
    "DC.Coverage": [
      "PediatricsDermatologic disorders"
    ],
    "DC.Date.Created": "2017-06-27",
    "DC.Date.Revised": "2019-07-29",
    "DC.Format": "XHTML",
    "DC.Identifier": "GUID-944EB57C-4546-4A61-924E-713D3A3DB473",
    "DC.Language": "en",
    "DC.Publisher": "EBSCO Publishing",
    "DC.Title": "Acne",
    "DC.Type": "topic",
    "DC.rights.owner": "(C) Copyright 2023",
    "abstract": "Acne is a chronic skin condition characterized by noninflammatory open and/or closed comedones and inflammatory lesions.",
    "copyright": "(C) Copyright 2023",
    "description": "Acne is a chronic skin condition characterized by noninflammatory open and/or closed comedones and inflammatory lesions."
  },
  "toc": [
    {
      "anchor": "GUID-3E2BB624-A1C1-4C77-BF7A-19789BD87180",
      "children": [
        {
          "anchor": "OVERVIEW_BACKGROUND",
          "title": "Background"
        }
      ],
      "title": "Overview and Recommendations"
    }
  ],
  "sections": [
    {
      "anchor": "GUID-3E2BB624-A1C1-4C77-BF7A-19789BD87180",
      "children": [
        {
          "anchor": "OVERVIEW_BACKGROUND",
          "content": "<html>...</html>",
          "title": "Background"
        }
      ],
      "content": "< html>...</html>",
      "title": "Overview and Recommendations"
    }
  ],
  "tablesContent": {
    "TOPIC_XFD_BTB_TYB__TABLE_ARN_MK2_TYB": "<?xml version=\\\"1.0\\\"?>< table>table data</table>"
  },
  "ancillary": {
    "algoritmIds": [
      "a55555"
    ],
    "consensusDetails": [
      {
        "anchor": "GUID-342C5BB2-451B-44EA-977C-EC127205856A__CONSENSUSDETAIL",
        "consensusNote": "<div>Content referenced with...</div>",
        "consensusPanel": "<div>Panel participants:</div>"
      }
    ],
   "contributors": [
      {
        "affiliationText": "\"The Skin Clinic, Massachusetts, United States",
        "conflictsText": "Dr. Elpern declares no relevant conflicts of\\n interest.",
        "degrees": "MD, MPH, FACP",
        "firstName": "David J.",
        "label": "Topic Editor",
        "lastName": "Elpern"
      }
    ],
    "HFC": {
      "content": "<div>This content is supported by a combination of the best available evidence and expert opinion put forth by members of our <a class=\"hospitalistPanel\" href=\"#\">Hospitalist Panel</a>.</div>",
      "title": "Hospitalist Panel",
      "dialog": "<div class=\"bodydiv panelDetail\" id=\"GUID-8DD2D4C3-C958-4EB4-9DF5-551DD0FA0A42__CONSENSUSDETAIL\"> <div class=\"bodydiv consensusNote\">Content referenced with &ldquo;Consensus&rdquo; in Hospitalist Focused Content is supported by a combination of the best available evidence and expert opinion put forth by a panel of Hospitalists.</div> <div class=\"bodydiv consensusPanel\"> <p class=\"p\">Panel participants:</p> \n <ul class=\"ul\"> <li class=\"li\">Dr. Duggirala declares no relevant financial conflicts of interest.</li> \n ... </ul> \n </div></div>"
    },
    "revisedDate": "2017-06-27",
    "description": "Acne is a chronic skin condition characterized by noninflammatory open and/or closed comedones and inflammatory lesions.",
    "headerMetadata": {
      "boxedWarnings": [
        {
          "heading": "Intravenous (Powder for Solution)",
          "warnings": [
            "Hypersensitivity Reactions Including Anaphylaxis"
          ]
        }
      ],
      "classes": [
        "Enzyme"
      ],
      "routes": [
        "intravenous"
      ]
    },
    "imageIds": [
      "i505966"
    ],
    "multimedia": [
      {
        "content": [
          {
            "copyright": "Copyright 2023, Luke Danaher. Video courtesy of Luke Danaher and Radiopaedia.org. Used under licence.",
            "description": "Diagnostic Approach to Cystic Lung Disease",
            "links": [
              {
                "href": "https://media.ebsco.healthcare/video/authenticated/s--y2MpK4a9--/v1674665799/EBSCOHealth/CCMS/Dynamed/videos/V1674666001630.mp4",
                "imageSize": "medium",
                "posterSize": "small",
                "rel": "external",
                "type": "poster"
              }
            ],
            "mediaHost": "cloudinary",
            "title": "Birt-Hogg-Dubé syndrome. "
          }
        ],
        "mediaType": "video"
      }
    ],
    "pubDate": "2018-06-29",
    "pubType": {
      "id": "condition",
      "title": "Skill"
    },
    "referenceLinks": [
      {
        "anchor": "GUID-C22B30D6-C077-4BDE-8547-F6C9F2DAE88A__AAD2016",
        "description": "<li>Eichenfield DZ<div data-title=\\\"JAMA 2021\\\" data-transform=\\\"full-text-container\\\" data-value=\\\"34812859\\\"><a href=\\\"http://pubmed.ncbi.nlm.nih.gov/34812859?dopt=Abstract\\\">PubMed Abstract</a></div>.</li>"
      }
    ],
    "revisedDate": "2019-07-29",
    "videoIds": [
      "V1674666001630"
    ],
    "updates": [
      {
        "text": "Heart Failure Society of America guideline on heart failure epidemiology and outcomes statistics (J Card Fail 2023 Oct)",
        "timestamp": "2023-10-18T00:47:05.000Z",
        "practiceChangingUpdate": false,
        "healthEquity": false,
        "updateType": "guidelineNotationUpdate",
        "updatePriority": "low",
        "anchor": "UNITED_STATES_GUIDELINES__LI_XR1_ZCK_DZBGNU101723"
      }
  }
}

Media within Articles

When an article has images, videos or algorthims each media resource will contain a secure link to a full resolution for that media that is optimized for the browser making the request.  The link is only valid for 24 hours. The caller can alternately request that an http URL be returned by specifying the secure=false parameter.

Specifying Image and Video Image sizes

Links to images of varying sizes may be returned in the article response. To specify the image size, add one or more imageSize query parameters to the call.  small (200w), medium (500w) and large (1000w) image sizes are supported.  Also, the full image size is supported and is the default if no image size was specified. A still image of the video (aka thumbnail or poster) can also be returned with the video. To specify the size, add one or more posterSize parameters to the call. Small, medium, large and full sized images of the video will be returned. To distinguish the video and video link in the response, a type parameter is added and is set to "poster".

For some use cases, non-expiring media links are required. In this case, mediaLinksFormat can be set to "server", which will return a secure link to the image or video in its original size. The link will include the file type. If a video is returned, it will return a poster of the video in the poster's original size. By default, mediaLinksFormat is set to "browser", and does not need to be specified.

Parameter Name Description
secure Set to true to return secure https URLs for media links
imageSize Returns the requested size(s) for image links: small, medium, large or full
posterSize Returns the requested size(s) for poster of the video links: small, medium, large or full
mediaLinksFormat  Returns a secure link in its original size. Options are server or browser (default).

 

Image Link Section when imageSize is Requested

The image link will look the same as in the above response, but will add an imageSize to the links:

      "links": [
        {
            "rel": "external",
            "imageSize": "small",
            "href": "http://media.ebsco.healthcare/eis-live/image/authenticated/t_s200/f_auto/v1/EBSCOHealth/CCMS/i508496.png?cld_token__=exp=1589557523~hmac=39e61c4969ae0fc2034b65fa3096d7582ead7a487cd5ff89301e2f873cb2d5f1"
        }
      ]

Video Link Section when posterSize is Requested

      "links": [
        {
          "rel": "external",
          "href": "http://media.ebsco.healthcare/eis-live/video/authenticated/v1/EBSCOHealth/CCMS/Dynamed/videos/V123456"
        },
        {
          "rel": "external",
          "posterSize": "large",
          "type": "poster",
          "href": "http://media.ebsco.healthcare/eis-live/video/authenticated/t_s1000/f_jpg/v1/EBSCOHealth/CCMS/Dynamed/videos/V123456"
        }
      ]

Error Response Codes

The DynaMed search for articles endpoint can return one of the error response codes.