EBSCO Developer | MedsAPI Content Articles

Retrieving An Article by Id

The DynaMed API GET /v2/content/articles/{articleId} endpoint returns the article matching the ID provided. The ID to retrieve is a required parameter for the endpoint. When using the v2 articles endpoint, you will get the latest content, which is NOT backward compatible with the v1 articles. Because of this, you should use the v2 endpoints (search, search suggestions, slugs) to ensure responses contain links to the v2 articles.

To Get a Basic Article (example):

Gather the following information for the request:

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

Request

GET https://apis.ebsco.com/medsapi-dynamed/v2/content/articles/t115279

The request above is for ID t115279.

Response

{
  "id": "t115279",
  "title": "Acne",
  "slug": "/condition/acne",
  "links": [
    {
      "href": "https://apis.ebsco.com/medsapi-dynamic-health/v2/content/articles/t12345",
      "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 media, 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.

MEDS API Documentation Title