MEDS API Documentation Title

 

 

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

 

 

 

 

Retrieving Articles (Deprecated)

The DynaMed API GET  /v1/articles/{articleId} endpoint returns the article matching the ID provided.  The ID to retrieve is a required parameter for the endpoint. 

This endpoint is deprecated and will not provide any new content fields.  Instead use /v2/content/articles/{id}

To Get a Basic Article (example):

Gather the following information for the request:

Request

GET https://apis.ebsco.com/medsapi-dynamed/v1/articles/t116814

The request above is for ID t116814.

Response

{
    "id": "T116814",
    "title": "Cardiac Arrest in Adults",
    "pubType": {
        "id": "condition",
        "title": "Condition"
    },
    "slug": "/condition/cardiac-arrest-in-adults",
    "links": [
        {
          "href": "https://apis.ebsco.com/medsapi-dynamed/v1/articles/T116814",
          "rel": "self"
        }
      ],
    "contributors": [
        {
            "label": "Topic Editor ",
            "shortName": "Dr. Lang",
            "fullName": "Eddy Lang MDCM, CCFP(EM), CSPQ",
            "conflictsText": "Dr. Lang declares no relevant financial conflicts of interest.",
            "affiliationText": "Zone Clinical and Academic Department Head for Emergency Medicine and Professor of Emergency Medicine, University of Calgary; Alberta, Canada; Senior Researcher, Alberta Health Services; Alberta, Canada"
        }
    ],
    "updates": [
        {
            "text": "mobilization of CFRs might improve survival in patients having out-of-hospital cardiac arrest (Cochrane Database Syst Rev 2019 Jul 19)",
            "timestamp": "2020-02-14T20:22:14+00:00",
            "anchor": "TOPIC_V2C_JDM_Q3B__LI_AJM_RK3_Z3B",
            "practiceChangingUpdate": false,
            "updateType": "evidenceUpdate",
            "updatePriority": "standard"
        }
    ],
    "sections": [
      {
        "anchor": "GUID-0859557F-9D73-4E90-9AC0-E7FC1D8E94BA",
        "content": "<div aria-labelledby=\"ariaid-title2\" class=\"topic nested1\" id=\"GUID-0859557F-9D73-4E90-9AC0-E7FC1D8E94BA\" lang=\"en\" xml:lang=\"en\"><h2 class=\"title topictitle2\" id=\"ARIAID-TITLE2\">Related Summaries</h2><div class=\"body\"><ul class=\"ul\"><li class=\"li\"><a class=\"link internal\" href=\"/condition/ventricular-fibrillation\">Ventricular fibrillation</a></li><li class=\"li\"><a class=\"link internal\" href=\"/condition/sudden-cardiac-death\">Sudden cardiac death</a></li><li class=\"li\"><a class=\"link internal\" href=\"/approach-to/ventricular-tachycardia-approach-to-the-patient\">Ventricular tachycardia &ndash; approach to the patient</a></li><li class=\"li\"><a class=\"link internal\" href=\"/management/advanced-cardiovascular-life-support-acls\">Advanced cardiovascular life support (ACLS)</a></li><li class=\"li\"><a class=\"link internal\" href=\"/management/adult-basic-life-support-bls\">Adult basic life support (BLS)</a></li><li class=\"li\"><a class=\"link internal\" href=\"/management/immediate-post-cardiac-arrest-care\">Immediate post-cardiac arrest care</a></li><li class=\"li\"><a class=\"link internal\" href=\"/management/therapeutic-hypothermia-for-neuroprotection-following-cardiac-arrest\">Therapeutic hypothermia for neuroprotection following cardiac arrest</a></li><li class=\"li\"><a class=\"link internal\" href=\"/device/implantable-cardioverter-defibrillator-icd\">Implantable cardioverter defibrillator (ICD)</a></li><li class=\"li\"><a class=\"link internal\" href=\"/condition/st-elevation-myocardial-infarction-stemi\">ST-elevation myocardial infarction (STEMI)</a></li><li class=\"li\"><a class=\"link internal\" href=\"/condition/acute-coronary-syndromes\">Acute coronary syndromes</a></li><li class=\"li\"><a class=\"link internal\" href=\"/condition/coronary-artery-disease-cad\">Coronary artery disease (CAD)</a></li></ul></div></div>",
        "title": "Related Summaries"
      }
    ],
   
  "toc": [
    {
      "title": "Related Summaries",
      "anchor": "GUID-0859557F-9D73-4E90-9AC0-E7FC1D8E94BA"
    },
    {
      "title": "General Information",
      "children": [
        {
          "title": "Description",
          "anchor": "DESCRIPTION"
        }
      ],
      "anchor": "GUID-214F4C1E-0A7E-4738-9110-ADDF6247FE3E"
    },
    {
      "title": "ICD Codes",
      "children": [
        {
          "title": "ICD-10 codes",
          "anchor": "ICD_10_CODES"
        }
      ],
      "anchor": "GUID-FB77A5C3-0DDC-43A9-A0E3-AA620716EE77"
    }
  ],
  "images": [
    {
      "description": "The main plot shows survival probability during the first 90 days, and the inset shows survival probability over the full observational period. Survival analysis was based on cardiac arrests that occurred between January 1, 2009, and October 2, 2011. Mortality was observed until December 31, 2011, when the data were censored; thus, there was follow-up to at least 90 days for each beneficiary. ALS indicates advanced life support; BLS, basic life support.",
      "title": "Cardiac arrest survival rates",
      "copyright": "Courtesy of The JAMA Network®   ©American Medical Association",
      "imageProvider": "AMA",
      "id": "i508496",
      "links": [
        {
            "rel": "external",
            "href": "http://media.ebsco.healthcare/eis-live/image/authenticated/v1/EBSCOHealth/CCMS/i508496.png?cld_token__=exp=1589557523~hmac=39e61c4969ae0fc2034b65fa3096d7582ead7a487cd5ff89301e2f873cb2d5f1"
        }
      ],
      "contentLocations": [
        {
          "parent": {
            "title": "Cardiac Arrest in Adults",
            "id*": "T116814",
            "slug": "/condition/cardiac-arrest-in-adults",
            "links*": [
              {
                "href*": "https://apis.ebsco.com/medsapi-dynamed/v1/topics/T116814",
                "rel": "self"
              }
            ]
          },
          "anchor": "I508496"
        }
      ]
    }
  ],
  "videos": [
    {
      "id": "V123456",
      "title": "Kegel exercises",
      "copyright": "Copyright ©2021 EBSCO Information Services.",
      "mediaProvider": "EBSCO Information Services",
      "format": "mp4",
      "description": "Video outlining the exercises involved in treating Urinary Incontinence.",
      "links": [
        {
          "rel": "external",
          "href": "http://media.ebsco.healthcare/eis-live/video/authenticated/v1/EBSCOHealth/CCMS/Dynamed/videos/V123456"
        }
      ],
      "contentLocations": [
        {
          "parent": {
            "title": "Behavioral Interventions for Urinary Incontinence",
            "slug": "/management/behavioral-interventions-for-urinary-incontinence"
          },
          "anchor": "V123456"
        }
      ]
    }
  ],
  "referenceLinks": [
    {
      "anchor": "GUID-165FCFE4-2101-4D94-9757-4D7F919F01E2__ANC_1795582378",
      "content": "<li class=\"li\" id=\"GUID-165FCFE4-2101-4D94-9757-4D7F919F01E2__ANC_1795582378\"> Subbiah R, Gula LJ, Klein GJ, et al. Workup of the cardiac arrest survivor: for the symposium on sudden cardiac death for progress in cardiovascular diseases. <a class=\"xref extlinkhtml\" href=\"http://www.ncbi.nlm.nih.gov/pubmed/19026854?dopt=Abstract\" target=\"_blank\"><span class=\"data\" property=\"pubmed\" value=\"19026854\"></span>Prog Cardiovasc Dis. 2008 Nov-Dec;51(3):195-203</a></li>"
    },
    {
      "anchor": "GUID-165FCFE4-2101-4D94-9757-4D7F919F01E2__ANC_888790949",
      "content": "<li class=\"li\" id=\"GUID-165FCFE4-2101-4D94-9757-4D7F919F01E2__ANC_888790949\"> Yousuf O, Chrispin J, Tomaselli GF, Berger RD. Clinical management and prevention of sudden cardiac death. <a class=\"xref extlinkhtml\" href=\"http://www.ncbi.nlm.nih.gov/pubmed/26044254?dopt=Abstract\" target=\"_blank\"><span class=\"data\" property=\"pubmed\" value=\"26044254\"></span>Circ Res. 2015 Jun 5;116(12):2020-40</a><a class=\"xref extlinkpdf\" href=\"http://circres.ahajournals.org/content/116/12/2020.full.pdf+html\" target=\"_blank\">PDF</a></li>"
    }
  ],
    "consensusDetails": [
      {
        "anchor": "GUID-5BE09253-2230-425C-827F-C0C1ECE62F83__CONSENSUSDETAIL",
        "noteContent": "<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>",
        "panelContent": "<div class=\"bodydiv consensusPanel\"><p class=\"p\">Panel participants:</p><ul class=\"ul\"><li class=\"li\">Vijay Duggirala, MD: Clinical Assistant Professor, The Ohio State University College of Nursing; Clinical Assistant Professor, The Ohio State University College of Medicine; Hospitalist, Director of Consult Services and Director of Quality &amp; Patient Safety, Division of Hospital Medicine, The Ohio State Wexner Medical Center; Ohio, United States</li><li class=\"li\">Dr. Duggirala declares no relevant financial conflicts of interest.</li><li class=\"li\">Chi Huang, MD: Executive Medical Director of General Medicine and Hospital Medicine Shared Services, Wake Forest Baptist Health System; Section Chief, Hospital Medicine, Wake Forest Baptist Medical Center; Associate Professor of Internal Medicine, Wake Forest Medical School; North Carolina, United States</li><li class=\"li\">Dr. Huang declares no relevant financial conflicts of interest.</li><li class=\"li\">Richard Rothman, MD: Chair and Physician Advisor, Department of Hospital Medicine, Cleveland Clinic India River Hospital; Florida, United States</li><li class=\"li\">Dr. Rothman declares no relevant financial conflicts of interest.</li><li class=\"li\">Andr&eacute;s J. Solorza, MD: Assistant Clinical Professor, Tufts University; Chair-Person, Department of Hospital Medicine, Lahey Hospital and Medical Center; Massachusetts, United States</li><li class=\"li\">Dr. Solorza declares no relevant financial conflicts of interest.</li><li class=\"li\">Nestor G. Tarragona, MD, FHM, FACP: Assistant Professor of Medicine, Tufts University School of Medicine; Vice Chairperson, Division of Hospital Medicine, Lahey Hospital and Medical Center; Medical Director for Latin America, Teladoc Health; Massachusetts, United States</li><li class=\"li\">Dr. Tarragona declares no relevant financial conflicts of interest.</li><li class=\"li\">Yoania Quintana-Garcia, MD: Hospitalist, Cleveland Clinic Indian River Hospital; Florida, United States</li><li class=\"li\">Dr. Quintana-Garcia declares no relevant financial conflicts of interest.</li></ul></div>"
    }
  ],
}

Images within Articles

When an article has images, each image resource will contain a link to a full resolution image that is optimized for the browser making the request.  The image link is only valid for 24 hours. The caller can alternately request that secure URLs (https) be returned by specifying the secure=true 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".

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

 

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.