Consumer Health

 

Browse our guides and interact with our API reference for more information about MEDSAPI NAH Reference Center. Try the API and learn about core concepts.

 

 

 

 

Get Metadata for Articles that have been Published or Republished

The NAH Reference Center GET  /content/articles endpoint returns metadata for articles published within a specified date range. The updatedAt timestamp is not necessarily related to editors updating the article with new information. It may represent the last time the article was reprocessed for delivery.

To Get Article Metadata for Updated Articles (example):

Gather the following information for the request:

  • An access token. Please see Use the Client Credentials Grant for further information.
  • The dates to retrieve (optional).
  • The page number to retrieve (optional).

Request

GET https://apis.ebsco.com/medsapi-ref-ctr/v1/content/articles?updatedSince=2022-09-14&updatedBefore=2023-05-09

The request above is for NAH Reference center articles of type FactSheet that have been republished between September 14, 2022 and May 9, 2023.

Response

{
  "_metadata": {
    "totalItems": 733,
    "totalPages": 8,
    "page": 1,
    "links": [
      {
        "rel": "self",
        "href": "https://apis.ebsco.com/medsapi-ref-ctr/v1/content/articles?hlType=FactSheet&page=1"
      },
      {
        "rel": "next",
        "href": "https://apis.ebsco.com/medsapi-ref-ctr/v1/content/articles?hlType=FactSheet&page=2"
      },
      {
        "rel": "last",
        "href": "https://apis.ebsco.com/medsapi-ref-ctr/v1/content/articles?hlType=FactSheet&page=74"
      }
    ]
  },
  "items": [
    {
      "id": "t700332",
      "createdAt": "2024-04-25T13:01:45.321Z",
      "updatedAt": "2024-05-14T14:42:22.866Z",
      "title": null,
      "description": "Bulimia Nervosa",
      "pubType": {
        "id": "QuickLesson"
      }
    },
    ...
} 

Dates

The updatedAt parameter indicates the last time the page was published.

Dates must conform to ISO 8601.  An example date is 2021-12-17T22:50:42.511Z or 2021-12-17.  If neither updatedSince or updatedBefore are provided, then all updates will be returned.  If no updatedBefore is supplied, then all dates from the updateSince until today's date will be returned.  If no updatedSince is provided, then all dates up to the updatedBefore will be returned.

Paging

Up to 100 items may be returned in a request.  If more than that are returned, the totalItems will indicate how many items there are to retrieve.  The page parameter in the response indicates the page that was returned.  To get the next page of items, add one to the page.  Each page has 100 items.

Error Response Codes

The NAH Reference Center articles endpoint can return one of the error response codes.