Skip to main content
OCLC Support

Entity Changes API

  1. Last updated
  2. Save as PDF
Discover the details of the Entity Changes API.

Overview

Users can retrieve a chronologically sorted history of changes to WorldCat Entity data. 

 Note: Included with OCLC Meridian Subscription.

To learn about OCLC APIs and get started with the Entity Changes API, see:

If you're ready to start using the Entity Changes API, the OCLC Developer Network can help you learn more. The OCLC Developer Network allows you to learn about OCLC APIs, view OCLC API documentation, and participate in the OCLC APIs community.

Types of changes

The following types of changes can be retrieved:

History Table Changes API
Create entity value Create
Add, remove, or replace entity value Update

Context and standard URLs

Examples

Main code

GET v1/changes 
{
    "context": [
        "https://www.w3.org/ns/activitystreams",
        "https://id.oclc.org/api/context.json",
        "https://emm-spec.org/0.1/context.json"
    ],
    "summary": "Worldcat Entity - Changes",
    "type": "OrderedCollection",
    "id": "https://entities.api.oclc.org/changes",
    "first": {
        "type": "OrderedCollectionPage",
        "id": "https://entities.api.oclc.org/changes/pages/1"
    },
    "last": {
        "type": "OrderedCollectionPage",
        "id": "https://entities.api.oclc.org/changes/pages/433"
    },
    "totalItems": (total number of changed items)
}

Pages code

GET v1/changes/pages/{pageNumber}

Page1 is first page of changes in Wordcat Entities and Last page is most recent changes.

    "type": "Add, Remove, Create, Replace",
            "published": "2024-04-12T08:31:31.514Z",
            "object": {
                "id": "E39QJKdVFFTCvc69T8GmRRt4gJ",
                "type": "ENTITY_PROPERTY",
                "updated": "2024-04-12T08:31:31.514Z"