Return the images for an object in our collection. You can try this method out right here in your browser!
- access_token (required) — A valid OAuth2 access token
- format — The format in which to return the data. Supported formats are json, jsonp, dson. The default format is json.
- object_id (required) — A valid Cooper Hewitt object ID.
- id — A valid Cooper Hewitt object ID. This API parameter is deprecated in favor of 'object_id'.
curl -X GET 'https://api.collection.cooperhewitt.org/rest/?method=cooperhewitt.objects.getImages&access_token=<TOKEN>&object_id=<OBJECT_ID> &id=<ID>'
About Image Sizes
Depending on image availability, you will receive references to multiple sizes of each image in the API response. The sizes are defined as follows:
b: 1024px on the longest side.
z: 640px on the longest side.
n: 320px on the longest side.
d: 320px on the longest side. This image is also dithered using our Atkinson dithering server for smaller filesize.
sq: 300px square image that is cropped from the
This API method uses OAuth2 and allows you to pass parameters as part of the URL (or as
GET requests). One of those parameters is your access token which is extra special and has super-powers. Requests to and from the API are done over an encrypted channel so no one can see what's going on BUT that also means there are a couple things you need to be conscious of:
- That the request URL always starts with
https://and not just
http://— that little s is what tells your browser to use an encrypted connection.
- If you are copy-paste-ing those URLs in to an email or some other place where someone else might be able to read them you should make sure to remove the access token — remember the access token is what links your account to Cooper Hewitt, Smithsonian Design Museum Collections on behalf of an application and has super-powers.