Linked Art API: Textual Work

Table of Contents

Introduction

The Textual Work API is a method of getting access to descriptions of texts, such as the linguistic content carried in printed or digital books, linguistic content incorporated as part of artworks, or other noteworthy linguistic content. The Textual Work model is of average complexity with many familiar properties and patterns, plus several additions to describe the text's relationship to other entities.

For more information about the usage of Textual Work data, please see the Document model description.

Property Definitions

Dereferencing an entity via the Textual Work endpoint would result in a JSON-LD document containing a single JSON object with the following properties.

Properties of Textual Works

Property Name Datatype Requirement Description
@context string, array Required The value MUST be the URI of the Linked Art context as a string, "https://linked.art/ns/v1/linked-art.json" or an array in which the URI is the last entry to allow for extensions
id string Required The value MUST be the HTTP(S) URI at which the text's representation can be dereferenced
type string Required The class for the text, which MUST be the value "LinguisticObject"
_label string Recommended A human readable label for the text, intended for developers
classified_as array Recommended An array of json objects, each of which is a classification of the text and MUST follow the requirements for Type
identified_by array Recommended An array of json objects, each of which is a name/title of the text and MUST follow the requirements for Name, or an identifier for the text and MUST follow the requirements for Identifier
referred_to_by array Optional An array of json objects, each of which is a human readable statement about the text and MUST follow the requirements for Statement
equivalent array Optional An array of json objects, each of which is a reference to an external identity and description of the current text
representation array Optional An array of json objects, each of which is a reference to a Visual Work that represents the current text, and MUST follow the requirements for a reference
member_of array Optional An array of json objects, each of which is a Set that the current text is a member of and MUST follow the requirements for a reference to a Set
subject_of array Optional An array of json objects, each of which is a reference to another Textual Work, the content of which focuses on the current text, and MUST follow the requirements for a reference
attributed_by array Optional An array of json objects, each of which is a Relationship Assignment that relates the current text to another entity
language array Optional An array of json objects, each of which is a language the text is expressed in, and MUST follow the requirements for Language
dimension array Optional An array of json objects, each of which is a Dimension, such as total number of words, of the current text
part_of array Optional An array of json objects, each of which is a reference to another Textual Work that the current text is a part of.
content string Optional The string representation of the textual content of the work
format string Optional The media type of the encoding of the string representation given in the content property
digitally_carried_by array Optional An array of json objects, each of which is a reference to a Digital Object, such as a PDF, that digitally carries the text of this work
carried_by array Optional An array of json objects, each of which is a reference to a Physical Object, such as a book, that physically carries the text of this work
about array Optional An array of json objects, each of which is a reference to another entity of any type, that this text is primarily about
refers_to array Optional An array of json objects, each of which is a reference to another entity of any type, that this text references in some way, but is not necessarily the primary topic of the work
created_by json object Optional A json object representing the creation of the text, which follows the requirements for Creations described below
used_for array Optional An array of json objects, each of which is a Publication Activity, which follows the requirements for Publications described below

Properties of Creations, Publication Activities

Property Name Datatype Requirement Description
id string Optional If present, the value MUST be a URI identifying the creation or publication
type string Required The class for the creation, which MUST be the value "Creation" or "Activity"
_label string Recommended A human readable label for the creation or publication, intended for developers
identified_by array Recommended An array of json objects, each of which is a name for the creation or publication and MUST follow the requirements for Name, or an identifier for the creation or publication and MUST follow the requirements for Identifier
classified_as array Recommended An array of json objects, each of which is a further classification of the creation or publication and MUST follow the requirements for Type
timespan json object Recommended A json object recording when the creation or publication occured, which MUST follow the requirements for timespans
referred_to_by array Optional An array of json objects, each of which is an embedded statement about the creation or publication
took_place_at array Optional An array of json objects, each of which is a reference to a Place where the creation or publication occured
caused_by array Optional An array of json objects, each of which is a reference to an Event that caused the creation or publication to occur
influenced_by array Optional An array of json objects, each of which is a reference to an entity that influenced the creation or publication in some noticable fashion
carried_out_by array Optional An array of json objects, each of which is a reference to a Person or Group that carried out the creation or publication

Property Diagram

diagram

JSON Schema

See the schema documentation and the schema itself

Incoming Properties

Textual Work instances are typically found as the object of the following properties, other than the self-referential properties above. This list is not exhaustive, but is intended to cover the likely cases where other endpoints refer to texts.

Property Name Source Endpoint Description
subject_of All Any entity can be the subject of textual content
carries Physical Object A physical object can carry a text, such as a manuscript and the text written on its pages
digitally_carries Digital Object A digital object can also digitally carry a text, such as a word document and the text encoded in it

Example

The JSON for a Textual Work entry for a text of a book about Gainsborough's works could be as below.

{
  "@context": "https://linked.art/ns/v1/linked-art.json",
  "id": "https://linked.art/example/text/0",
  "type": "LinguisticObject",
  "_label": "Gainsborough by Hayes",
  "classified_as": [
    {
      "id": "http://vocab.getty.edu/aat/300060417",
      "type": "Type",
      "_label": "Monograph"
    }
  ],
  "identified_by": [
    {
      "type": "Name",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300404670",
          "type": "Type",
          "_label": "Primary Name"
        }
      ],
      "content": "Gainsborough: Paintings and Drawings"
    },
    {
      "type": "Identifier",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300417443",
          "type": "Type",
          "_label": "ISBN Identifier"
        }
      ],
      "content": "0714816396"
    }
  ],
  "referred_to_by": [
    {
      "type": "LinguisticObject",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300026032",
          "type": "Type",
          "_label": "Abstract",
          "classified_as": [
            {
              "id": "http://vocab.getty.edu/aat/300418049",
              "type": "Type",
              "_label": "Brief Text"
            }
          ]
        }
      ],
      "content": "A thorough analysis of the artist's life and work"
    }
  ],
  "about": [
    {
      "id": "http://vocab.getty.edu/ulan/500115200",
      "type": "Person",
      "_label": "Gainsborough, Thomas"
    }
  ],
  "language": [
    {
      "id": "http://vocab.getty.edu/aat/300388277",
      "type": "Language",
      "_label": "English"
    }
  ],
  "used_for": [
    {
      "type": "Activity",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300054686",
          "type": "Type",
          "_label": "Publishing"
        }
      ],
      "timespan": {
        "type": "TimeSpan",
        "_label": "1975",
        "begin_of_the_begin": "1975-01-01T00:00:00Z",
        "end_of_the_end": "1975-12-31T23:59:59Z"
      },
      "took_place_at": [
        {
          "type": "Place",
          "_label": "New York"
        }
      ],
      "carried_out_by": [
        {
          "type": "Group",
          "_label": "Phaidon"
        }
      ]
    }
  ],
  "created_by": {
    "type": "Creation",
    "carried_out_by": [
      {
        "type": "Person",
        "_label": "Hayes, John"
      }
    ]
  }
}

graph TD classDef object stroke:black,fill:#E1BA9C,rx:20px,ry:20px; classDef actor stroke:black,fill:#FFBDCA,rx:20px,ry:20px; classDef type stroke:red,fill:#FAB565,rx:20px,ry:20px; classDef name stroke:orange,fill:#FEF3BA,rx:20px,ry:20px; classDef dims stroke:black,fill:#c6c6c6,rx:20px,ry:20px; classDef infoobj stroke:#907010,fill:#fffa40,rx:20px,ry:20px classDef timespan stroke:blue,fill:#ddfffe,rx:20px,ry:20px classDef place stroke:#3a7a3a,fill:#aff090,rx:20px,ry:20px classDef event stroke:#1010FF,fill:#96e0f6,rx:20px,ry:20px classDef literal stroke:black,fill:#f0f0e0; classDef classstyle stroke:black,fill:white; O1(text0) class O1 infoobj; O1-- type -->O1_0[LinguisticObject] class O1_0 classstyle; O1-- _label -->O1_4("''Gainsborough by Hayes''") class O1_4 literal; O2(aat:300060417) class O2 type; O2-- type -->O2_0[Type] class O2_0 classstyle; O2-- _label -->O2_3("''Monograph''") class O2_3 literal; O1-- classified_as -->O2 O3( _ ) class O3 name; O3-- type -->O3_0[Name] class O3_0 classstyle; O4(aat:300404670) class O4 type; O4-- type -->O4_0[Type] class O4_0 classstyle; O4-- _label -->O4_3("''Primary Name''") class O4_3 literal; O3-- classified_as -->O4 O3-- content -->O3_3("''Gainsborough: Paintings and Drawings''") class O3_3 literal; O1-- identified_by -->O3 O5( _ ) class O5 name; O5-- type -->O5_0[Identifier] class O5_0 classstyle; O6(aat:300417443) class O6 type; O6-- type -->O6_0[Type] class O6_0 classstyle; O6-- _label -->O6_3("''ISBN Identifier''") class O6_3 literal; O5-- classified_as -->O6 O5-- content -->O5_3("''0714816396''") class O5_3 literal; O1-- identified_by -->O5 O7( _ ) class O7 infoobj; O7-- type -->O7_0[LinguisticObject] class O7_0 classstyle; O8(aat:300026032) class O8 type; O8-- type -->O8_0[Type] class O8_0 classstyle; O8-- _label -->O8_3("''Abstract''") class O8_3 literal; O9(aat:300418049) class O9 type; O9-- type -->O9_0[Type] class O9_0 classstyle; O9-- _label -->O9_3("''Brief Text''") class O9_3 literal; O8-- classified_as -->O9 O7-- classified_as -->O8 O7-- content -->O7_3("''A thorough analysis of the artist's life and work''") class O7_3 literal; O1-- referred_to_by -->O7 O10(ulan:500115200) class O10 actor; O10-- type -->O10_0[Person] class O10_0 classstyle; O10-- _label -->O10_3("''Gainsborough, Thomas''") class O10_3 literal; O1-- about -->O10 O11(aat:300388277) class O11 type; O11-- type -->O11_0[Language] class O11_0 classstyle; O11-- _label -->O11_3("''English''") class O11_3 literal; O1-- language -->O11 O12( _ ) class O12 event; O12-- type -->O12_0[Activity] class O12_0 classstyle; O13(aat:300054686) class O13 type; O13-- type -->O13_0[Type] class O13_0 classstyle; O13-- _label -->O13_3("''Publishing''") class O13_3 literal; O12-- classified_as -->O13 O14( _ ) class O14 timespan; O14-- type -->O14_0[TimeSpan] class O14_0 classstyle; O14-- _label -->O14_2("''1975''") class O14_2 literal; O14-- begin_of_the_begin -->O14_3("''1975-01-01T00:00:00Z''") class O14_3 literal; O14-- end_of_the_end -->O14_4("''1975-12-31T23:59:59Z''") class O14_4 literal; O12-- timespan -->O14 O15( _ ) class O15 place; O15-- type -->O15_0[Place] class O15_0 classstyle; O15-- _label -->O15_2("''New York''") class O15_2 literal; O12-- took_place_at -->O15 O16( _ ) class O16 actor; O16-- type -->O16_0[Group] class O16_0 classstyle; O16-- _label -->O16_2("''Phaidon''") class O16_2 literal; O12-- carried_out_by -->O16 O1-- used_for -->O12 O17( _ ) class O17 event; O17-- type -->O17_0[Creation] class O17_0 classstyle; O18( _ ) class O18 actor; O18-- type -->O18_0[Person] class O18_0 classstyle; O18-- _label -->O18_2("''Hayes, John''") class O18_2 literal; O17-- carried_out_by -->O18 O1-- created_by -->O17
Other Representations: JSON-LD (raw) | JSON-LD (playground) | Turtle (raw) | Turtle (styled)