Finishing a book
A reader's Goodreads export lists a book on their read shelf. The row becomes two actions on the same Book, keyed by Goodreads' book ID: a BookmarkAction at the date the book was added to a shelf, and a CompleteAction at the date it was finished. This example shows the finish.
The book carries its author, its publisher (an Organization keyed by name), its pageCount, and the reader's review as its description. The book's ISBN-13 is a sameAs key in the isbn namespace, so the same edition read through any source that knows its ISBN collapses onto one book. Each custom shelf the book sits on is a Collection it isPartOf, keyed by the shelf's permalink.
{
"@type": "CompleteAction",
"@key": ["@type", "source", "object.sourceId", "timestamp"],
"source": "goodreads",
"timestamp": "2025-03-14T00:00:00.000Z",
"agent": {
"@type": "Person",
"@key": ["@type", "source", "sourceId"],
"source": "goodreads",
"sourceId": "1234567",
"name": "Sam Rivera",
"url": "https://www.goodreads.com/user/show/1234567",
"sameAs": ["@me"]
},
"object": {
"@type": "Book",
"@key": ["@type", "source", "sourceId"],
"source": "goodreads",
"sourceId": "40961427",
"name": "The Lighthouse Keeper",
"url": "https://www.goodreads.com/book/show/40961427",
"description": "Quiet and patient. The last chapter stayed with me.",
"pageCount": 312,
"author": [
{
"@type": "Person",
"@key": ["@type", "source", "name"],
"source": "goodreads",
"name": "Maya Lindqvist"
},
{
"@type": "Person",
"@key": ["@type", "source", "name"],
"source": "goodreads",
"name": "Tomas Berg"
}
],
"publisher": [
{
"@type": "Organization",
"@key": ["@type", "source", "name"],
"source": "goodreads",
"name": "Harbor Press"
}
],
"isPartOf": [
{
"@type": "Collection",
"@key": ["@type", "url"],
"source": "goodreads",
"name": "favorites",
"url": "https://www.goodreads.com/review/list/1234567?shelf=favorites"
}
],
"sameAs": [
{
"@type": "Book",
"@key": ["source", "sourceId"],
"source": "isbn",
"sourceId": "9780000000019",
"name": "The Lighthouse Keeper"
}
]
}
}{
"@context": {
"@vocab": "https://schema.chronicle.app/",
"doc": "https://schema.chronicle.app/docs/"
},
"@type": "CompleteAction",
"doc:key": {
"@list": ["@type", "source", "object.sourceId", "timestamp"]
},
"source": "goodreads",
"timestamp": {
"@value": "2025-03-14T00:00:00.000Z",
"@type": "http://www.w3.org/2001/XMLSchema#dateTime"
},
"agent": {
"@type": "Person",
"doc:key": {
"@list": ["@type", "source", "sourceId"]
},
"source": "goodreads",
"sourceId": "1234567",
"name": "Sam Rivera",
"url": "https://www.goodreads.com/user/show/1234567",
"sameAs": ["@me"]
},
"object": {
"@type": "Book",
"doc:key": {
"@list": ["@type", "source", "sourceId"]
},
"source": "goodreads",
"sourceId": "40961427",
"name": "The Lighthouse Keeper",
"url": "https://www.goodreads.com/book/show/40961427",
"description": "Quiet and patient. The last chapter stayed with me.",
"pageCount": {
"@value": "312",
"@type": "http://www.w3.org/2001/XMLSchema#integer"
},
"author": [
{
"@type": "Person",
"doc:key": {
"@list": ["@type", "source", "name"]
},
"source": "goodreads",
"name": "Maya Lindqvist"
},
{
"@type": "Person",
"doc:key": {
"@list": ["@type", "source", "name"]
},
"source": "goodreads",
"name": "Tomas Berg"
}
],
"publisher": [
{
"@type": "Organization",
"doc:key": {
"@list": ["@type", "source", "name"]
},
"source": "goodreads",
"name": "Harbor Press"
}
],
"isPartOf": [
{
"@type": "Collection",
"doc:key": {
"@list": ["@type", "url"]
},
"source": "goodreads",
"name": "favorites",
"url": "https://www.goodreads.com/review/list/1234567?shelf=favorites"
}
],
"sameAs": [
{
"@type": "Book",
"doc:key": {
"@list": ["source", "sourceId"]
},
"source": "isbn",
"sourceId": "9780000000019",
"name": "The Lighthouse Keeper"
}
]
}
}@prefix : <https://schema.chronicle.app/> .
@prefix doc: <https://schema.chronicle.app/docs/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
[
a :CompleteAction;
doc:key ("@type" "source" "object.sourceId" "timestamp");
:source "goodreads";
:timestamp "2025-03-14T00:00:00.000Z"^^xsd:dateTime;
:agent [
a :Person;
doc:key ("@type" "source" "sourceId");
:source "goodreads";
:sourceId "1234567";
:name "Sam Rivera";
:url "https://www.goodreads.com/user/show/1234567";
:sameAs "@me"
];
:object [
a :Book;
doc:key ("@type" "source" "sourceId");
:source "goodreads";
:sourceId "40961427";
:name "The Lighthouse Keeper";
:url "https://www.goodreads.com/book/show/40961427";
:description "Quiet and patient. The last chapter stayed with me.";
:pageCount "312"^^xsd:integer;
:author [
a :Person;
doc:key ("@type" "source" "name");
:source "goodreads";
:name "Maya Lindqvist"
], [
a :Person;
doc:key ("@type" "source" "name");
:source "goodreads";
:name "Tomas Berg"
];
:publisher [
a :Organization;
doc:key ("@type" "source" "name");
:source "goodreads";
:name "Harbor Press"
];
:isPartOf [
a :Collection;
doc:key ("@type" "url");
:source "goodreads";
:name "favorites";
:url "https://www.goodreads.com/review/list/1234567?shelf=favorites"
];
:sameAs [
a :Book;
doc:key ("source" "sourceId");
:source "isbn";
:sourceId "9780000000019";
:name "The Lighthouse Keeper"
]
]
] .