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
subject_of array Optional An array of json objects, each of which is a reference to a Textual Work, the content of which is about the current work, and MUST follow the requirements for a reference
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
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 or a Visual Work that the current text is a part of.
conceptually_part_of array Optional An array of json objects, each of which is a reference to an Abstract Work that the current work is conceptually 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
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
subject_to array Optional An array of json objects, each of which is a Right that is held over the intellectual work
created_by json object Optional A json object representing the creation of the text, which follows the requirements for a Creation
used_for array Optional An array of json objects, each of which is a Publication Activity, which follows the requirements for an Activity

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",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300435443",
          "type": "Type",
          "_label": "Type of Work"
        }
      ]
    }
  ],
  "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(text/0) 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; O3(aat:300435443) class O3 type; O3-- type -->O3_0[Type] class O3_0 classstyle; O3-- _label -->O3_3("''Type of Work''") class O3_3 literal; O2-- classified_as -->O3 O1-- classified_as -->O2 O4( _ ) class O4 name; O4-- type -->O4_0[Name] class O4_0 classstyle; O5(aat:300404670) class O5 type; O5-- type -->O5_0[Type] class O5_0 classstyle; O5-- _label -->O5_3("''Primary Name''") class O5_3 literal; O4-- classified_as -->O5 O4-- content -->O4_3("''Gainsborough: Paintings and Drawings''") class O4_3 literal; O1-- identified_by -->O4 O6( _ ) class O6 name; O6-- type -->O6_0[Identifier] class O6_0 classstyle; O7(aat:300417443) class O7 type; O7-- type -->O7_0[Type] class O7_0 classstyle; O7-- _label -->O7_3("''ISBN Identifier''") class O7_3 literal; O6-- classified_as -->O7 O6-- content -->O6_3("''0714816396''") class O6_3 literal; O1-- identified_by -->O6 O8( _ ) class O8 infoobj; O8-- type -->O8_0[LinguisticObject] class O8_0 classstyle; O9(aat:300026032) class O9 type; O9-- type -->O9_0[Type] class O9_0 classstyle; O9-- _label -->O9_3("''Abstract''") class O9_3 literal; O10(aat:300418049) class O10 type; O10-- type -->O10_0[Type] class O10_0 classstyle; O10-- _label -->O10_3("''Brief Text''") class O10_3 literal; O9-- classified_as -->O10 O8-- classified_as -->O9 O8-- content -->O8_3("''A thorough analysis of the artist's life and work''") class O8_3 literal; O1-- referred_to_by -->O8 O11(ulan:500115200) class O11 actor; O11-- type -->O11_0[Person] class O11_0 classstyle; O11-- _label -->O11_3("''Gainsborough, Thomas''") class O11_3 literal; O1-- about -->O11 O12(aat:300388277) class O12 type; O12-- type -->O12_0[Language] class O12_0 classstyle; O12-- _label -->O12_3("''English''") class O12_3 literal; O1-- language -->O12 O13( _ ) class O13 event; O13-- type -->O13_0[Activity] class O13_0 classstyle; O14(aat:300054686) class O14 type; O14-- type -->O14_0[Type] class O14_0 classstyle; O14-- _label -->O14_3("''Publishing''") class O14_3 literal; O13-- classified_as -->O14 O15( _ ) class O15 timespan; O15-- type -->O15_0[TimeSpan] class O15_0 classstyle; O15-- _label -->O15_2("''1975''") class O15_2 literal; O15-- begin_of_the_begin -->O15_3("''1975-01-01T00:00:00Z''") class O15_3 literal; O15-- end_of_the_end -->O15_4("''1975-12-31T23:59:59Z''") class O15_4 literal; O13-- timespan -->O15 O16( _ ) class O16 place; O16-- type -->O16_0[Place] class O16_0 classstyle; O16-- _label -->O16_2("''New York''") class O16_2 literal; O13-- took_place_at -->O16 O17( _ ) class O17 actor; O17-- type -->O17_0[Group] class O17_0 classstyle; O17-- _label -->O17_2("''Phaidon''") class O17_2 literal; O13-- carried_out_by -->O17 O1-- used_for -->O13 O18( _ ) class O18 event; O18-- type -->O18_0[Creation] class O18_0 classstyle; O19( _ ) class O19 actor; O19-- type -->O19_0[Person] class O19_0 classstyle; O19-- _label -->O19_2("''Hayes, John''") class O19_2 literal; O18-- carried_out_by -->O19 O1-- created_by -->O18
Other Representations: JSON-LD (raw) | JSON-LD (playground) | Turtle (raw) | Turtle (styled)