Visual Works

Introduction

The Visual Work API is a method of getting access to descriptions of image content, such as the appearance of paintings and two-dimensional artworks, sculptures and three-dimensional artworks, or digital images. The Visual Work model is of average complexity with many familiar properties and patterns, plus several additions to describe the visual work's relationship to other entities.

For more information about the usage of Visual Work data, please see the Object Aboutness model description.

Property Definitions

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

Properties of Visual Works

Property Diagram

JSON Schema

See the schema documentation and the schema itself

Incoming Properties

Visual 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 image content.

Example

The JSON for a Visual Work entry for a visual content of Miro's "The Farm" could be as below.

• It has the Linked Art context document reference in @context
• It self-documents its URI in id
• It has a type of "VisualItem"
• It has a _label with the value "Appearance of Miro's The Farm" for people reading the JSON
• It is classified_as "Cubist", which has an id of "aat:300021495", which is in turn classified_as being a Style ("aat:300015646")
• It is identified_by a Name, with the content "Appearance of The Farm"
• It is referred_to_by a statement which ...
  • ... has content of "A brilliant amalgamation of an intense ..."
  • ... is classified_as a Description ("aat:300435416")
• It represents a Place, Mont-roig del Camp
• It represents_instance_of_type Tree ("aat:300132410"), meaning there is a tree depicted but the tree has no separate identity beyond the content
• It was created_by a Creation which ...
  • ... was carried_out_by Miro
  • ... had a timespan of between "1921-01-01" and "1922-12-31"

{
  "@context": "https://linked.art/ns/v1/linked-art.json",
  "id": "https://linked.art/example/visual/0",
  "type": "VisualItem",
  "_label": "Appearance of Miro's The Farm",
  "classified_as": [
    {
      "id": "http://vocab.getty.edu/aat/300021495",
      "type": "Type",
      "_label": "Cubist",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300015646",
          "type": "Type",
          "_label": "Style"
        }
      ]
    }
  ],
  "identified_by": [
    {
      "type": "Name",
      "content": "Appearance of The Farm"
    }
  ],
  "referred_to_by": [
    {
      "type": "LinguisticObject",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300435416",
          "type": "Type",
          "_label": "Description",
          "classified_as": [
            {
              "id": "http://vocab.getty.edu/aat/300418049",
              "type": "Type",
              "_label": "Brief Text"
            }
          ]
        }
      ],
      "content": "A brilliant amalgamation of an intense, even primitive, realism with the formal vocabulary of cubism."
    }
  ],
  "represents": [
    {
      "id": "http://vocab.getty.edu/tgn/7300934",
      "type": "Place",
      "_label": "Mont-roig del Camp"
    }
  ],
  "represents_instance_of_type": [
    {
      "id": "http://vocab.getty.edu/aat/300132410",
      "type": "Type",
      "_label": "Tree"
    }
  ],
  "shown_by": [
    {
      "id": "https://www.nga.gov/collection/art-object-69660",
      "type": "HumanMadeObject",
      "_label": "The Farm"
    }
  ],
  "created_by": {
    "type": "Creation",
    "timespan": {
      "type": "TimeSpan",
      "_label": "1921-1922",
      "begin_of_the_begin": "1921-01-01T00:00:00Z",
      "end_of_the_end": "1922-12-31T23:59:59Z"
    },
    "carried_out_by": [
      {
        "id": "http://vocab.getty.edu/ulan/500014094",
        "type": "Person",
        "_label": "Miro"
      }
    ]
  }
}