Retrieving an Article by ID GET
The Consumer Health API GET an article by article ID endpoint returns the requested article. Before you can execute an article call, you must have an 'Authorization' token which is to be entered into the request header.
Basic Retrieval by ID
To Perform an Article Request (example):
Gather the following information for the request:
- An access token. Please see Using the Client Credentials Grant for further information.
- The ID of the requested article.
Request
GET https://apis.ebsco.com/medsapi-consumer-health/v1/content/articles/t1643468393575Response
{
"id": "t1643468393575",
"title": "Myasthenia Gravis",
"links": [
{
"rel": "self",
"href": "https://apis.ebsco.com/medsapi-consumer-health/v1/content/articles/t1643468393575"
}
],
"metadata": {
"title": "Myasthenia Gravis",
"editor": " Nicole S. Meregian, PA",
"gender": [
"Male",
"Female"
],
"DC.Type": "topic",
"created": "2010-10-15T00:00:00.000Z",
"revised": "2024-05-01T00:00:00.000Z",
"subject": [
"Myasthenia Gravis"
],
"DC.Title": "Myasthenia Gravis",
"ageGroup": [
"Aged, 80 and Older"
],
"category": [
"Neurology",
"Allergies"
],
"DC.Format": "XHTML",
"copyright": "(C) Copyright 2026",
"hlChunkID": "11654",
"DC.Creator": "by Cynthia M. Johnson, MA",
"DC.Coverage": "/dci/myastheniagravis,11001110000011200000113000001140000011500000131000001",
"DC.IsPartOf": "GUID-211AA2F3-CCA6-47F8-A902-1257BE3BDD3D",
"DC.Language": "en",
"DC.Identifier": "GUID-07E7C9A6-69CC-4EB0-AAAF-95016DCE1850",
"subject.minor": [
"Young Adult",
],
"alternateTitle": [
"MG"
],
"publisherPlace": [
"Ipswich, Massachusetts"
],
"DC.Date.Created": "2010-10-15T00:00:00.000Z",
"DC.Date.Revised": "2024-05-01T00:00:00.000Z",
"DC.rights.owner": "(C) Copyright 2026",
"specificInterest": [
"Evidence-Based Practice",
"Consumer Health"
],
"medicalCodes.SNOMED": [
"230687001|Myopathy in myasthenia gravis",
],
"medicalCodes.ICD-10-CM": [
"G70.0|Myasthenia gravis",
],
"medicalCodes.ICD-9-CM-D": [
"358.00|Myasthenia gravis without (acute) exacerbation",
]
},
"toc": [
{
"title": "Treatment",
"anchor": "GUID-DFB962DB-CF8E-4683-80F0-6EAB63DFBF6B__TREATMENT",
"children": [
{
"title": "Medications",
"anchor": "GUID-DFB962DB-CF8E-4683-80F0-6EAB63DFBF6B__SSEC1"
}
]
}
],
"sections": [
{
"anchor": "GUID-DFB962DB-CF8E-4683-80F0-6EAB63DFBF6B",
"title": "Myasthenia Gravis",
"content": "<div class=\"body\"><p class=\"p SubTitle\">(MG)</p>\n<div class=\"section\" id=\"GUID-DFB962DB-CF8E-4683-80F0-6EAB63DFBF6B__DEFINITION\"><p class=\"p SectionHeader\">Definition</p>\n<p class=\"p standard\">Myasthenia gravis (MG) is a disease that damages the communication between nerves and muscles. This can lead to muscle weakness that gets worse over time.</p>\n</div>\n<div class=\"section\" id=\"GUID-DFB962DB-CF8E-4683-80F0-6EAB63DFBF6B__CAUSES\"><p class=\"p SectionHeader\">Causes</p>\n<p class=\"p standard\">MG happens when there is a problem with the ....</div>"
},
{
"references": [
{
"anchor": "REFERENCES",
"title": "References:",
"content": [
{
"id": "GUID-E4A8FF15-DBC3-4FAD-BC5B-3FFF8092B510__P1",
"data": "Juel VC, Massey JM. Myasthenia gravis. Orphanet J Rare Dis. 2007 Nov 6;2:44."
}
]
}
]
},
{
"anchor": "GUID-EE31FBF9-52E9-4C16-AD53-7FC514C1038A",
"title": "RESOURCES:",
"content": "<div class=\"bodydiv unit ResourceGroup\"><ul class=\"ul\"><li class=\"li ResourceItem\"><p class=\"p ItemLine\">Myasthenia Gravis Foundation of America</p>\n<p class=\"p ItemLine\"><a class=\"xref extlinkhtml\" href=\"http://www.myasthenia.org\" target=\"_blank\">http://www.myasthenia.org</a></p>\n</li>\n<li class=\"li ResourceItem\"><p class=\"p ItemLine\">National Institute of Neurological Disorders and Stroke</p>\n<p class=\"p ItemLine\"><a class=\"xref extlinkhtml\" href=\"http://www.ninds.nih.gov\" target=\"_blank\">http://www.ninds.nih.gov</a></p>\n</li>\n</ul>\n</div><div class=\"bodydiv unit ResourceGroup\"><p class=\"p ResourceHeader\">CANADIAN RESOURCES:</p>\n<ul class=\"ul\"><li class=\"li ResourceItem\"><p class=\"p ItemLine\">Myasthenia Gravis Association of BC</p>\n<p class=\"p ItemLine\"><a class=\"xref extlinkhtml\" href=\"http://myastheniagravis.ca\" target=\"_blank\">http://myastheniagravis.ca</a></p>\n</li>\n<li class=\"li ResourceItem\"><p class=\"p ItemLine\">Public Health Agency of Canada</p>\n<p class=\"p ItemLine\"><a class=\"xref extlinkhtml\" href=\"http://www.phac-aspc.gc.ca\" target=\"_blank\">http://www.phac-aspc.gc.ca</a></p>\n</li>\n</ul>\n</div>"
}
],
"ancillary": {
"hlType": "FactSheet",
"chunkId": "11654",
"pubType": {
"id": "Condition"
},
"pubFamily": "patientinformation",
"contributors": [
{
"reviewers": [
{
"id": "T1641969260975",
"chunkId": "29311",
"reviewer": " Nicole S. Meregian, PA",
"organization": " EBSCO Medical Review Board "
}
]
}
],
"multimedia": [
{
"mediaType": "image",
"content": [
{
"links": [
{
"rel": "external",
"href": "https://media.ebsco.healthcare/eis-live/image/authenticated/t_media_lib_thumb/v1/EBSCOHealth/CCMS/Consumer_Health/images/SN7531.jpg?__cld_token__=exp=1785342900~hmac=615b717646f836ee82580bdff95f8d792c6fce35d9dfe0346ceafd5e489d6c24&_a=BAMAPqiu0",
"imageSize": "small"
}
],
"title": "The Thymus Gland",
"copyright": "Copyright © Nucleus Medical Media, Inc.",
"mediaHost": "Cloudinary",
"publicId": "EBSCOHealth/CCMS/Consumer_Health/images/SN7531"
}
]
}
],
"productInformation": [
{
"an": "2010812339",
"product": "HLT",
"title": "Myasthenia Gravis",
"publisher": "HealthLibrary",
"publicationType": "(condition)"
}
]
}
}Media within Articles
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 will be returned. To distinguish the video and video link in the response, a type parameter is added and is set to "poster". No poster is returned unless posterSize is provided.
| Parameter Name | Description |
|---|---|
| imageSize | Returns the requested size(s): small, medium, large, 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
When imageSize is requested, the image link will look the same as in the above response, but with the addition of imageSize.
"multimedia": [
{
"mediaType": "image",
"content": [
{
"links": [
{
"rel": "external",
"href": "http://media.ebsco.healthcare/eis-live/image/authenticated/t_s200/v1/EBSCOHealth/CCMS/Consumer_Health/images/SN2726.jpg?__cld_token__=exp=1774007567~hmac=f37610188268db0e85bebfcc6fa052db46557652d49ddcc4a24cb5cefbea0986",
"imageSize": "small"
}
],
"title": "Sciatica Nerve Pain",
"copyright": "Copyright © 2002 Nucleus Communications, Inc. All rights reserved.",
"mediaHost": "Cloudinary",
"publicId": "EBSCOHealth/CCMS/Consumer_Health/images/SN2726"
}
]
}
]Video Link Section when posterSize is Requested
"multimedia": [
{
"mediaType": "video",
"content": [
{
"links": [
{
"rel": "external",
"href": "http://media.ebsco.healthcare/eis-live/video/authenticated/v1/EBSCOHealth/CCMS/Consumer_Health/videos/SNV71100E44920A1099.mp4?__cld_token__=exp=1774007609~hmac=5116bc3bd68f83becf9b6ded0bcbe3f6f7dfffebcda4ab5c1e021cb5340a8406"
},
{
"rel": "external",
"href": "http://media.ebsco.healthcare/eis-live/video/authenticated/t_s200/f_jpg/v1/EBSCOHealth/CCMS/Consumer_Health/videos/SNV71100E44920A1099.jpg?__cld_token__=exp=1774007609~hmac=81f92e2622198ca2cfc9b7f273d4c9a47e8c71caea7e2cd53d1bf5ac9b2494ff",
"posterSize": "small",
"type": "poster"
}
],
"title": "Diagnostic_Pelvic_Laparoscopy.mp4",
"mediaHost": "Cloudinary",
"publicId": "EBSCOHealth/CCMS/Consumer_Health/videos/SNV71100E44920A1099"
}
]
}Note that the video and the poster are both included. To easily distinguish, the type is set to poster.
Error Response Codes
The Dynamic Health get an article by ID endpoint can return one of the error response codes.
Updated 2 months ago
Did this page help you?