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

Basic Retrieving of an Article by Slug

To Get a Basic Article (example):

Gather the following information for the request:

An access token. Please see Using the Client Credentials Grant for further information.
The slug to retrieve.

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"
              }
            ],
            "publicId": "EBSCOHealth/CCMS/Dynamed/videos/V1674666001630"
            "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,
        "nejmAdvantage": true,
        "updateType": "guidelineNotationUpdate",
        "updatePriority": "low",
        "anchor": "UNITED_STATES_GUIDELINES__LI_XR1_ZCK_DZBGNU101723"
      }
   }
}

Media within Articles

Responses can include items that have images and/or videos. These include the title, copyright and a link to the actual image or video. The image URL is a link to a full resolution image that is optimized for the browser making the request. The link is valid for 24 hours and should not be cached.

Access to Multimedia Assets

Article responses may include references to multimedia assets within the multimedia section of the response payload.

Each Multimedia Entry Can Include the Following Metadata

Title – The name or caption associated with the media asset.
Copyright – Copyright attribution information.
Media URL – A link to the associated image or video asset.

Media URL Behavior

The media URL provides access to a full-resolution image or video.
The URL is temporary and valid for 24 hours from the time the article response is generated.
Clients must not cache the URL.

Access and Refresh

If access to the media asset is required after the 24-hour validity period, the client must re-request the article through the API to obtain a new media URL.
No additional authentication is required to retrieve the media asset once the URL has been issued.

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 are be returned. To distinguish the video and video link in the response, a type parameter is added and is set to "poster".

Parameter Name	Description
secure	Set to true to return secure https URLs for media links. Default is true.
imageSize	Returns the requested size(s) for image links: small, medium, large or full.
posterSize	Returns the requested size(s) for image links: small, medium, large or full.

Image Link Section when imageSize is Requested

The image link will look the same as in the above response with the will addition of an imageSize.

 "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.mp4"
        },
        {
          "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.jpg"
        }
      ]

Error Response Codes

The DynaMed retrieving an article by slug endpoint can return one of the error response codes.