For the purposes of this API, bibliographies are bibiliographic itemns that may or may not be connetced to an object or object constituent.
| Endpoint | Description |
|---|---|
| /bibliographies | Index of bibiliography endpoints |
| /bibliographies/{id} | Retrieve bibiliography with corresponding `id` |
Request:
curl -H "X-GUGGENHEIM-API-KEY: [valid api key goes here]" -H "Accept: application/vnd.guggenheim.collection+json" http://api.guggenheim.org/collections/bibliographies
Response:
{
"_links": {
"_self": {
"href": "http://api.guggenheim.org/collections/bibliographies"
},
"item": {
"href": "http://api.guggenheim.org/collections/bibliographies/{id}"
}
}
}
The index endpoint provides a list of links to other bibiliography-related endpoints.
Returns the bibiliography with the corresponding id.
Request:
curl -H "X-GUGGENHEIM-API-KEY: [valid api key goes here]" -H "Accept: application/vnd.guggenheim.collection+json" http://api.guggenheim.org/collections/bibliographies/996
Response:
{
"_links": {
"_self": {
"href": "http://api.guggenheim.org/collections/bibliographies/996"
}
},
"constituents": [
{
"constituent": {
"_links": {
"_self": {
"href": "http://api.guggenheim.org/collections/2462"
}
},
"dates": {
"begin": 0,
"display": null,
"end": 0
},
"display": "Peter Frank",
"firstname": "Peter",
"has_bio": false,
"id": 2462,
"lastname": "Frank",
"middlename": null,
"objects": {
"total_count": 0
},
"sort": "Frank Peter",
"suffix": null
},
"displayed": true,
"order": 1,
"role": "Author"
}
],
"copyright": "\u00a9 Solomon R. Guggenheim Museum",
"description": "As Director Thomas M. Messer wished \u201cto avoid too institutional an emphasis in the inherently fluid area of contemporary art,\u201d the third iteration of the Exxon National Exhibition used the lens of guest curator, critic Peter Frank, as the interpolator between museum and art. Frank also wrote the catalogue's introductory text. Each of the nineteen diverse American artists is featured with biographical information, a short artist\u2019s statement, and images of their work in both color and black and white. The artists featured are Michael Brakke, Guy de Cointet, Manny Farber, Vernon Fisher, Heidi Gl\u00fcck, Tom Green, William Haney, Patrick Hogan, Tom Holste, Barbara Kruger, Philip Larson, Jim Richard, Bill Richards, Darryl Sapien, Norie Sato, Gael Stack, John White, George Woodman, and Frank Young.",
"edition": null,
"excerpt": "There is no accounting for taste, goes the clich\u00e9, but I beg to differ: a curator or critic exercising professional judgment for the edification of the art audience is made to account very quickly for personal bias. For the most part it is recognized that critics and curators are almost as human as the rest of us, and are able to transcend only so far their subjective outlooks.",
"has_media": true,
"id": 996,
"language": "en",
"media": [
{
"assets": {
"full": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/490/pub_19_artists_1981_exxon_001_00fc.jpg"
}
},
"height": 490,
"width": 433
},
"hires": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/hires/pub_19_artists_1981_exxon_001_00fc.jpg"
}
},
"height": 512,
"width": 452
},
"large": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/902/pub_19_artists_1981_exxon_001_00fc.jpg"
}
},
"height": 902,
"width": 796
},
"medium": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/300/pub_19_artists_1981_exxon_001_00fc.jpg"
}
},
"height": 300,
"width": 265
},
"small": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/160/pub_19_artists_1981_exxon_001_00fc.jpg"
}
},
"height": 160,
"width": 141
},
"tiny": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/62/pub_19_artists_1981_exxon_001_00fc.jpg"
}
},
"height": 62,
"width": 55
}
},
"copyright": null,
"format": "JPEG",
"orientation": "portrait",
"rank": 1,
"sequence": "00fc",
"type": "Image"
},
{
"assets": {
"full": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/490/pub_19_artists_1981_exxon_002_0000.jpg"
}
},
"height": 490,
"width": 435
},
"hires": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/hires/pub_19_artists_1981_exxon_002_0000.jpg"
}
},
"height": 512,
"width": 455
},
"large": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/902/pub_19_artists_1981_exxon_002_0000.jpg"
}
},
"height": 902,
"width": 802
},
"medium": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/300/pub_19_artists_1981_exxon_002_0000.jpg"
}
},
"height": 300,
"width": 267
},
"small": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/160/pub_19_artists_1981_exxon_002_0000.jpg"
}
},
"height": 160,
"width": 142
},
"tiny": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/62/pub_19_artists_1981_exxon_002_0000.jpg"
}
},
"height": 62,
"width": 55
}
},
"copyright": null,
"format": "JPEG",
"orientation": "portrait",
"rank": 2,
"sequence": "0000",
"type": "Image"
},
{
"assets": {
"full": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/490/pub_19_artists_1981_exxon_003_0001.jpg"
}
},
"height": 490,
"width": 419
},
"hires": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/hires/pub_19_artists_1981_exxon_003_0001.jpg"
}
},
"height": 512,
"width": 438
},
"large": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/902/pub_19_artists_1981_exxon_003_0001.jpg"
}
},
"height": 902,
"width": 772
},
"medium": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/300/pub_19_artists_1981_exxon_003_0001.jpg"
}
},
"height": 300,
"width": 257
},
"small": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/160/pub_19_artists_1981_exxon_003_0001.jpg"
}
},
"height": 160,
"width": 137
},
"tiny": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/62/pub_19_artists_1981_exxon_003_0001.jpg"
}
},
"height": 62,
"width": 53
}
},
"copyright": null,
"format": "JPEG",
"orientation": "portrait",
"rank": 3,
"sequence": "0001",
"type": "Image"
}
],
"physical": {
"dimensions": "7.50 x 8.50 inches",
"format": "softcover",
"pages": "92"
},
"published": {
"place": null,
"year": 1981
},
"subtitle": null,
"title": "19 Artists\u2014Emergent Americans: 1981 Exxon National Exhibition",
"volume": null
}
| Field | Type | Description |
|---|---|---|
| id | number | Unique ID number for the bibliographic item |
| constituents | array | An array of constituents connected to a bibliographic item |
| copyright | string | Copyright statement connected to a bibliographic item |
| description | string | Description of the bibliographic item |
| edition | string | Edition of the bibliographic item |
| excerpt | string | Excerpt of the bibliographic item |
| has_media | boolean | A boolean that indicates whether a bibliographic item has media or not |
| media | array | An array of media objects connected to a bibliographic item |
| physical | object | An object containing the physical attributes of the bibliographic item |
| published | object | An object containing the publishing related attributes of the bibliographic item |
| subtitle | string | Subtitle of the bibliographic item |
| title | string | Title of the bibliographic item |
| volume | string | Volume of the bibliographic item |
Constituents is an array which represents a list of constituents and their connection to the bibliographic item.
{
"constituent": {
"_links": {
"_self": {
"href": "http://api.guggenheim.org/collections/2462"
}
},
"dates": {
"begin": 0,
"display": null,
"end": 0
},
"display": "Peter Frank",
"firstname": "Peter",
"has_bio": false,
"id": 2462,
"lastname": "Frank",
"middlename": null,
"objects": {
"total_count": 0
},
"sort": "Frank Peter",
"suffix": null
},
"displayed": true,
"order": 1,
"role": "Author"
}
| Field | Type | Description |
|---|---|---|
| constituent | object | The constituent object |
| displayed | boolean | A boolean that indicates whether a constituent should be displayed or not |
| order | number | The ranking order of the constituent among all the constituents of the object |
| role | string | The role of the constituent connected to a bibliograohic item |
Media is an array which represents a list of media related assets—primarilly images—which are connected to a bibliographic item.
{
"assets": {
"full": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/full/pub_19_artists_1981_exxon_003_0001.jpg"
}
},
"height": 490,
"width": 419
},
"hires": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/hires/pub_19_artists_1981_exxon_003_0001.jpg"
}
},
"height": 512,
"width": 438
},
"large": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/large/pub_19_artists_1981_exxon_003_0001.jpg"
}
},
"height": 902,
"width": 772
},
"medium": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/previews/pub_19_artists_1981_exxon_003_0001.jpg"
}
},
"height": 300,
"width": 257
},
"small": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/thumbnails/pub_19_artists_1981_exxon_003_0001.jpg"
}
},
"height": 160,
"width": 137
},
"tiny": {
"_links": {
"_self": {
"href": "http://annex.guggenheim.org/collections/media/postagestamps/pub_19_artists_1981_exxon_003_0001.jpg"
}
},
"height": 62,
"width": 53
}
},
"copyright": null,
"format": "JPEG",
"orientation": "portrait",
"rank": 3,
"sequence": "first",
"type": "Image"
}
</tbody>
| Field | Type | Description |
|---|---|---|
| assets | object | An object which will contain values connected to different available sizes, their access URL as well as the height and width of an asset |
| copyright | string | A string with data on the copyright connected to the asset |
| format | string | A string with data on the file format of the asset; JPEG or PNG for now |
| orientation | string | A string with data on the orientation of the asset; can be either 'portrait' or 'landscpae' |
| rank | string | A string with data on the rank of the asset |
| sequence | string | A four (4) character string with data on the sequence of the asset which can be set to 00fc (front cover), 00bc (back cover), roman number sequence (000i, 00ii, 00ii, etc…) or an ordinal number value (0000, 0001, 0002, etc…) |
| type | string | A string with data on the type of asset; will most likely be 'Image' for now |
Physical is an object which represents a list of physical attributes and their connection to the bibliographic item.
"physical": {
"dimensions": "7.50 x 8.50 inches",
"format": "softcover",
"pages": "92"
}
</tbody>
| Field | Type | Description |
|---|---|---|
| dimensions | string | A string with data on the physical dimensions of the bibliograhic item |
| format | string | A string with data on the format of the bibliograhic item |
| pages | string | A string with data on the physical pages of the bibliograhic item |
Published is an object which represents a list of published attributes and their connection to the bibliograhic item.
"published": {
"place": null,
"year": 1981
}
</tbody>
| Field | Type | Description |
|---|---|---|
| place | string | A string with data on the published place of the bibliograhic item |
| year | string | A string with data on the published year of the bibliograhic item |