getChangelog

This function reads the public Linked API changelog: what was released and when. Use it to learn what is new since you last checked, or whether something you need has shipped. It is exported from the package root and needs no client and no token.

typescript

import { getChangelog } from '@linkedapi/node';

try {
  // Releases for the week of October 1, 2026 and later
  const changelog = await getChangelog({ since: '2026-10-01' });

  for (const release of changelog.entries) {
    console.log(release.date);
    for (const item of release.items) {
      console.log(`  ${item.title}: https://linkedapi.io${item.docs}`);
    }
  }
} catch (e) {
  // A plain Error carrying the server's message, e.g. for an invalid since
  console.error('Could not read the changelog:', e);
}

python

from linkedapi import LinkedApiError, get_changelog

try:
    # Releases for the week of October 1, 2026 and later
    changelog = get_changelog("2026-10-01")

    for release in changelog.entries:
        print(release.date)
        for item in release.items:
            print(f"  {item.title}: https://linkedapi.io{item.docs}")
except LinkedApiError as e:
    print(f"Could not read the changelog: {e.message}")

Params

since – optional. Return only the releases for the week containing this point and later. Either an ISO 8601 date, such as 2026-10-01, or an instant with a time zone, such as 2026-10-01T12:00:00Z. Node also accepts a Date; Python accepts a date or a timezone-aware datetime. Omit it to get the whole changelog.

In Node, since is a field of the options object; in Python, it is the first argument.

Data

since – the since you passed, or null when you passed none.
count – the number of releases returned.
entries – the releases, newest first. Each has:
- date – the Monday of the release's week, as YYYY-MM-DD;
- items – what shipped, each with a title, a body and docs, the path of its documentation on https://linkedapi.io.

Releases are weekly

A release covers a week and is dated by its Monday. It counts as shipped at the end of that week, so since returns every release whose week ends after it – including the week since falls in, even when its date is a few days earlier. That way a check in the middle of a week never misses what ships later the same week.

The price is that a later check in the same week returns that release again, and items can be added to it during its week. Deduplicate releases by date, and keep the copy you received last.

Errors

Node – throws a plain Error, not a LinkedApiError, with the server's message when the response is not 2xx – for example, an invalid since. A network failure is thrown as the underlying fetch error.
Python – raises a LinkedApiError of type httpError, both for a non-2xx response, with the server's message, and for a network failure.

The same changelog is available from the terminal with linkedin changelog and to AI agents through the MCP tool get_changelog.

PreviousgetApiUsage NextOverview