Dartmouth API Developer Portal

Hood Assets API

Returns information about objects in The Museum System (TMS) from the Hood Museum. This API returns information from multiple source systems. Object metadata is pulled from TMS and object images are pulled from Resource Space.

Rating

Attribute Value
Highly Available Yes
Cache Refresh Interval Once Daily
Filtering Yes

Required Scopes

The information is public for all Dartmouth accounts.

Request

GET /api/hood/assets
GET /api/hood/exhibitions

Required Headers

Authorization: Bearer {jwt}

Notes on usage

This API is used for the Hood Museum's website to provide information on objects that the museum posseses. Each object has metadata describing the object along with other custom attributes that helps display content and search on the website. Those attributes are listed in detail below.

The object metadata is pulled from TMS (The Museum System). If there are images of the object, those are pulled from Resource Space and placed in an array in the object's metadata.

To retrieve the metadata for all objects, use the following query:

/api/hood/assets

A typical use case is retrieving the metadata for one object. That is accomplished with the following query:

/api/hood/assets/12.1.114

Another use case is searching for objects that match certain criteria. For example, you might want to search for all objects made by Pablo Picasso. That is accomplished with the following query:

/api/hood/assets?artist_maker=*pablo picasso*

To search for objects with OR logic:

/api/hood/assets?keywords=|*birch*,*bark*,*canoe*

To search for objects with AND logic:

/api/hood/assets?keywords=^*birch*,*bark*,*canoe*

Returns

Status Code Description
200 The URI parameter {id} passed in is a valid asset
404 The URI parameter {id} passed in is NOT a valid asset

Top Level Payload Attribute Descriptions

Field Type Sample Data Description
object_id string 7704 Unique object id for each object.
object_number string 12.1.114 Unique object number for each object. Primary key
artist_maker string Pablo Picasso The artist or maker of the object. may be more than one. if unknown, this field will may say something like "Unknown Roman".
display_date string American, 1848 - 1893
nationality string American
alpha_sort string Picasso, Pablo Used for sorting. Last name first. If no name, the nationality of the artist is used.
title string Bohemia Double Wall Beaker depicting Saint Mark The object's title.
date string Early Iron Age (1050-750 BCE) The object's date label.
early_date string -1050 Used for date span searches.
late_date string -750 Used for date span searches.
object_name string Pottery The object's name. Can have multiple.
classification string Classical World The object's classification. Can have multiple.
period string 1000 BCE-1 CE The time period when the object was created.
medium string Terracotta The medium of the object.
edition string Edition 11/100
dimensions string Overall: 3 3/8 × 2 9/16 in. (8.6 × 6.5 cm) The dimensions of the object.
inscription string Possibly traces of black ink on front.
subject string Afterlife | Death The object's subject matter.
provenance string Collected by Luigi Palma de Cesnola, American Consul to Cyprus, 1865-1876; given to Hiram Hitchcock (1832-1900, Class of 1872H), Hanover, New Hampshire, about 1872; The history of the object's ownership.
catalogue_raisonne string Barbados Museum and Historical Society, Barbados; by exchange (#120) to the present collection, 1961.
exhibition_history string The Age of the Marvelous, Hood Museum of Art, Dartmouth College, Hanover, New Hampshire, September 21- November 24, 1991; North Carolina Museum of Art, Raleigh, North Carolina, January 25- March 22, 1992 The history of where the object has been on exhibition.
publication_history string Douglas F. Jordan, Dartmouth Class of 1947, Four Sculptured Cypriote Heads from the Hitchcock Collection in the Dartmouth College Museum, Dartmouth College Museum Annual Report, 1947-1948, p. 15-20.
course_history string ANTH 05, Introduction to Archaeology, Nathaniel Kitchel
publisher string University Press, Cambridge, Massachusetts
printer string Suffolk Engraving Company, Boston
published_references string Carol Andrews, Amulets of Ancient Egypt. London, 1994.
label string These tiles once bordered a fireplace in Dreamwold, a lavish estate built in Scituate, Massachusettes, in 1902.
credit_line string Bequest of Emily Howe Hitchcock, Class of 1872HW
object_rights_type string Utilitarian
copyright object © Vito Acconci
is_on_view boolean False True if the object is currently on display in the Hood Museum.
all_artists string Roman | Greek | Cyprus
object_geography string Place Made: Italy, Europe The location where the object was made or imaged.
online_collection_tag string Browse Classical Antiquity | Browse Western Asia Specifies which online collection the object should appear in. Can have multiple.
is_native_american boolean True True if the object's classification is "Native American"
artist_maker_collection array [{"name": "Cypriot"},{"name": "Unidentified Ancient Egyptian maker"}] An array of all of the artists in the artist_maker attribute.
object_name_collection array [{"name": "Pottery"},{"name": "Artifact"}] An array of all of the names in the object_name attribute.
classification_collection array [{"name": "Classical World"}] An array of all of the classifications in the classification attribute.
object_geography_collection array [{"name": "Place Made: Eastern Mediterranean, Cyprus, West Asia, Asia"}] An array of all of the entries in the object_geography attribute.
dimensions_collection array [{"name": "Overall: 4 1/8 × 1/4 in. (10.5 × 0.7 cm)"}] An array of all of the dimensions in the dimensions attribute.
subject_collection array [{"name": "Classical Mythology and Ancient History"}] An array of all of the subjects in the subject attribute.
course_history_collection array [{"name": "CLST 11, Greek and Roman Engineering and Technology, Roger Ulrich"}] An array of all of the courses in the course_history attribute.
exhibition_history_collection array [{"name": "Artifacts of the Roman Empire, Harrington Gallery Teaching Exhibition, Hood Museum of Art, Dartmouth College, Hanover, New Hampshire, October 18-November 5, 1990."}] An array of all of the exhibitions in the exhibition_history attribute.
all_artists_collection array [{"name": "Greek"},{"name": "Roman"}] An array of all of the artists in the all_artists attribute.
online_collection_tag_collection array [{"name": "Browse Classical Antiquity"},{"name": "Browse Western Asia"}] An array of all of the tags in the online_collection_tag attribute.
publication_history_collection array [{"name": "Douglas F. Jordan, Dartmouth Class of 1947, Four Sculptured Cypriote Heads from the Hitchcock Collection in the Dartmouth College Museum, Dartmouth College Museum Annual Report, 1947-1948, p. 15-20."},{"name": "Barbara Thompson, Fred Wilson, So Much Trouble in the World - Believe It or Not!, Hanover, New Hampshire: Trustees of Dartmouth College, 2005."}] An array of the object's publication history.
keywords_collection array [{"keyword": "-1050"},{"keyword": "12.1.137"}] An array of all of the phrases in the keywords attribute. Not necessarily split up by word.
keywords string "roman classical world bequest of emily howe hitchcock, class of 1872hw early iron age (1050-750 bce) -1050 -750 terracotta with brown slip place made: italy, europe pottery 12.1.137" Various object attributes combined into a string for keyword searching.
resources array See sample request below. An array of images of the object pulled from Resource Space. Specifies whether the image is a primary or alternate view. Includes the size code for the images and URLs.
has_resources boolean True True if the resources array has images. False if the array is null.
resource_count integer 3 How many images the object has in the resources array.
has_primary_resources boolean True True if one resource in the resources array has the value "Primary" for "view". False if no resources in the array have that value.
cache_date string 2022-02-17T07:47:22Z When the object was last refreshed

Resources Array Attributes

If an object has images in Resource Space, it will have an array of resources.

Field Type Description
view String This specifies whether the image is a primary or alternate view of the object. There can be more than one alternate view.
assets Array The list of assets for the view. They are all derivatives of the same image.
size_code String Specifies the size of the image. Size code definitions are below.
extension String The file extension for the image. Ex. tif or jpg.
path String The path for the image on the server.
url String The url to access the image on the web.

Size Codes

Each image in the resources array has a size code. Their specifics are listed below. This information is pulled from: https://hood.resourcespace.com/pages/admin/admin_size_management.php?&orderby=width

ID Name Width Height
obt Object Details Thumb 60 60
col Collection 100 75
thm Thumbnail 175 175
ccu Collection Curated 263 999999
csr Collection Search 267 999999
obp Object Details Primary 480 340
obl Object Details Lightbox 650 675
pre Preview 900 480
scr Screen 1400 800
lpr Low resolution print 2000 2000
hpr High resolution print 999999 999999

Sample Request

https://api.dartmouth.edu/api/hood/assets/12.1.114

Sample Return


    {
        "object_id": "10789",
        "object_number": "12.1.114",
        "artist_maker": "Cypriot",
        "display_date": null,
        "nationality": null,
        "alpha_sort": "Cypriot",
        "title": "Juglet",
        "date": "Early Iron Age (1050-750 BCE)",
        "early_date": "-1050",
        "late_date": "-750",
        "object_name": "Pottery",
        "classification": "Classical World",
        "period": "1000 BCE-1 CE",
        "medium": "Black Slip Ware",
        "edition": null,
        "dimensions": "Overall: 3 3/8 × 2 9/16 in. (8.6 × 6.5 cm)",
        "inscription": null,
        "subject": null,
        "provenance": "Collected by Luigi Palma de Cesnola, American Consul to Cyprus, 1865-1876; given to Hiram Hitchcock (1832-1900, Class of 1872H), Hanover, New Hampshire, about 1872; bequeathed to his second wife, Emily Howe Hitchcock (1852-1912), Hanover, New Hampshire, 1900; bequeathed to present collection, 1912.",
        "catalogue_raisonne": null,
        "exhibition_history": null,
        "publication_history": null,
        "course_history": null,
        "publisher": null,
        "printer": null,
        "published_references": null,
        "label": null,
        "credit_line": "Bequest of Emily Howe Hitchcock, Class of 1872HW",
        "object_rights_type": "Utilitarian",
        "copyright": null,
        "is_on_view": false,
        "all_artists": "Cypriot",
        "object_geography": "Place Made: Eastern Mediterranean, Cyprus, West Asia, Asia",
        "online_collection_tag": "Browse Classical Antiquity | Browse Western Asia",
        "is_native_american": false,
        "artist_maker_collection": [
            {
                "name": "Cypriot"
            }
        ],
        "object_name_collection": [
            {
                "name": "Pottery"
            }
        ],
        "classification_collection": [
            {
                "name": "Classical World"
            }
        ],
        "object_geography_collection": [
            {
                "name": "Place Made: Eastern Mediterranean, Cyprus, West Asia, Asia"
            }
        ],
        "dimensions_collection": [
            {
                "name": "Overall: 3 3/8 × 2 9/16 in. (8.6 × 6.5 cm)"
            }
        ],
        "subject_collection": null,
        "course_history_collection": null,
        "exhibition_history_collection": null,
        "all_artists_collection": [
            {
                "name": "Cypriot"
            }
        ],
        "online_collection_tag_collection": [
            {
                "name": "Browse Classical Antiquity"
            },
            {
                "name": "Browse Western Asia"
            }
        ],
        "publication_history_collection": null,
        "keywords_collection": [
            {
                "keyword": "-1050"
            },
            {
                "keyword": "-750"
            },
            {
                "keyword": "1000 bce-1 ce"
            },
            {
                "keyword": "12.1.114"
            },
            {
                "keyword": "bequest of emily howe hitchcock, class of 1872hw"
            },
            {
                "keyword": "black slip ware"
            },
            {
                "keyword": "classical world"
            },
            {
                "keyword": "cypriot"
            },
            {
                "keyword": "early iron age (1050-750 bce)"
            },
            {
                "keyword": "juglet"
            },
            {
                "keyword": "place made: eastern mediterranean, cyprus, west asia, asia"
            },
            {
                "keyword": "pottery"
            },
            {
                "keyword": "utilitarian"
            }
        ],
        "keywords": " cypriot classical world bequest of emily howe hitchcock, class of 1872hw early iron age (1050-750 bce)  -1050 -750 black slip ware  place made: eastern mediterranean, cyprus, west asia, asia pottery 12.1.114 utilitarian 1000 bce-1 ce   juglet",
        "resources": [
            {
                "view": "Primary",
                "assets": [
                    {
                        "size_code": "original",
                        "extension": "tif",
                        "path": "/var/www/filestore/hood/3/4/2_19c337d3024406f/243_c09ef5c59dc0803.tif",
                        "url": "https://hood.resourcespace.com/filestore/hood/3/4/2_19c337d3024406f/243_c09ef5c59dc0803.tif?v=1643374458"
                    },
                    {
                        "size_code": "obl",
                        "extension": "jpg",
                        "path": "/var/www/filestore/hood/3/4/2_19c337d3024406f/243obl_68ad2ee736e33ea.jpg",
                        "url": "https://hood.resourcespace.com/filestore/hood/3/4/2_19c337d3024406f/243obl_68ad2ee736e33ea.jpg?v=1643374459"
                    },
                    {
                        "size_code": "obp",
                        "extension": "jpg",
                        "path": "/var/www/filestore/hood/3/4/2_19c337d3024406f/243obp_250c4383858d852.jpg",
                        "url": "https://hood.resourcespace.com/filestore/hood/3/4/2_19c337d3024406f/243obp_250c4383858d852.jpg?v=1643374459"
                    },
                    {
                        "size_code": "csr",
                        "extension": "jpg",
                        "path": "/var/www/filestore/hood/3/4/2_19c337d3024406f/243csr_b01f63d0a9a7ae1.jpg",
                        "url": "https://hood.resourcespace.com/filestore/hood/3/4/2_19c337d3024406f/243csr_b01f63d0a9a7ae1.jpg?v=1643374460"
                    },
                    {
                        "size_code": "ccu",
                        "extension": "jpg",
                        "path": "/var/www/filestore/hood/3/4/2_19c337d3024406f/243ccu_c868da33d0a842a.jpg",
                        "url": "https://hood.resourcespace.com/filestore/hood/3/4/2_19c337d3024406f/243ccu_c868da33d0a842a.jpg?v=1643374460"
                    },
                    {
                        "size_code": "obt",
                        "extension": "jpg",
                        "path": "/var/www/filestore/hood/3/4/2_19c337d3024406f/243obt_3dc0aa74465f257.jpg",
                        "url": "https://hood.resourcespace.com/filestore/hood/3/4/2_19c337d3024406f/243obt_3dc0aa74465f257.jpg?v=1643374461"
                    }
                ]
            }
        ],
        "has_resources": true,
        "resource_count": 1,
        "has_primary_resources": true,
        "cache_date": "2022-02-16T07:25:51Z"
    }