Get Metadata for Articles that have been Published or Republished

The Product Content API GET /v1/articles endpoint returns metadata for articles published within a specified date range.

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 next page number to retrieve (optional).

EBSCO recommends not using the date parameters to ensure getting the current status of all the documents regardless of when they were created and subsequently updated.

Dates

Request 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 1000 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 1000 items.

Request

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

The request above is for articles that have been republished between September 14, 2022 and May 9, 2023 GMT.

Response

{
  "_metadata": {
    "totalItems": 711,
    "totalPages": 8,
    "page": 1,
    "links": [
      {
        "rel": "self",
        "href": "https://apis.ebsco.com/medsapi-product-content/v1/articles?updatedSince=2022-09-14T18:21:54.345Z&updatedBefore=2023-05-09&page=1"
      },
      {
        "rel": "next",
        "href": "https://apis.ebsco.com/medsapi-product-content/v1/articles?updatedSince=2022-09-14T18:21:54.345Z&updatedBefore=2023-05-09&page=2"
      },
      {
        "rel": "last",
        "href": "https://apis.ebsco.com/medsapi-product-content/v1/articles?updatedSince=2022-09-14T18:21:54.345Z&updatedBefore=2023-05-09&page=8"
      }
    ]
  },
  "items": [
    {
      "id": "t232776",
      "product": {
        "code": "dmx",
        "title": "DynaMedex"
      },
      "slug": "/drug-monograph/linezolid",
      "updatedAt": "2025-03-22T1133:56.315",
      "addedToListAt": "2025-01-01T15:22:56.315"
      "removedFromListAt": "2025-01-22T09:09:56.315",
      "isDeleted": true,
      "title": "Linezolid",
      "description": "this topic provides overviews of mechanisms of action, spectrum of activity..."
      "pubType": {
        "id": "drug"
      },
      "idDeleted": false
    },
    ...
  ]
} 

Dates in the Response

The response for each item will include an updatedAt, addedToListAt and removedFromListAt. These fields indicate when the article was first made available to your account and when the article was removed from your account.  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 through our pipeline for internal purposes. If isDeleted is set to true, then this article has been removed from our systems and is no longer available. In this case, the updatedAt will reflect the date when the article was removed.

Products

A product code is returned to indicate which product set the content belongs to.  The values that might be returned are dm, dmx, dh, ch and rc, representng DynaMed, DynaMedex, Dynamic Health, Consumer Health and NAH Reference Center respectively.

Error Response Codes

The Product Content articles endpoint can return one of the error response codes.