Shelving a book to read
A book on the reader's to-read shelf becomes a BookmarkAction at the date it was added: the reader saved it for later. The reader has no Goodreads ID configured here, so they are keyed by name.
{
"@type": "BookmarkAction",
"@key": ["@type", "source", "object.sourceId", "timestamp"],
"source": "goodreads",
"timestamp": "2025-06-02T00:00:00.000Z",
"agent": {
"@type": "Person",
"@key": ["@type", "source", "name"],
"source": "goodreads",
"name": "Sam Rivera",
"sameAs": ["@me"]
},
"object": {
"@type": "Book",
"@key": ["@type", "source", "sourceId"],
"source": "goodreads",
"sourceId": "51234",
"name": "Field Notes on Tides",
"url": "https://www.goodreads.com/book/show/51234",
"author": [
{
"@type": "Person",
"@key": ["@type", "source", "name"],
"source": "goodreads",
"name": "Ines Okafor"
}
]
}
}{
"@context": {
"@vocab": "https://schema.chronicle.app/",
"doc": "https://schema.chronicle.app/docs/"
},
"@type": "BookmarkAction",
"doc:key": {
"@list": ["@type", "source", "object.sourceId", "timestamp"]
},
"source": "goodreads",
"timestamp": {
"@value": "2025-06-02T00:00:00.000Z",
"@type": "http://www.w3.org/2001/XMLSchema#dateTime"
},
"agent": {
"@type": "Person",
"doc:key": {
"@list": ["@type", "source", "name"]
},
"source": "goodreads",
"name": "Sam Rivera",
"sameAs": ["@me"]
},
"object": {
"@type": "Book",
"doc:key": {
"@list": ["@type", "source", "sourceId"]
},
"source": "goodreads",
"sourceId": "51234",
"name": "Field Notes on Tides",
"url": "https://www.goodreads.com/book/show/51234",
"author": [
{
"@type": "Person",
"doc:key": {
"@list": ["@type", "source", "name"]
},
"source": "goodreads",
"name": "Ines Okafor"
}
]
}
}@prefix : <https://schema.chronicle.app/> .
@prefix doc: <https://schema.chronicle.app/docs/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
[
a :BookmarkAction;
doc:key ("@type" "source" "object.sourceId" "timestamp");
:source "goodreads";
:timestamp "2025-06-02T00:00:00.000Z"^^xsd:dateTime;
:agent [
a :Person;
doc:key ("@type" "source" "name");
:source "goodreads";
:name "Sam Rivera";
:sameAs "@me"
];
:object [
a :Book;
doc:key ("@type" "source" "sourceId");
:source "goodreads";
:sourceId "51234";
:name "Field Notes on Tides";
:url "https://www.goodreads.com/book/show/51234";
:author [
a :Person;
doc:key ("@type" "source" "name");
:source "goodreads";
:name "Ines Okafor"
]
]
] .