Please note, we are in the process of retiring the public api. The public api, as well as its documentation and playground, will remain available until July 28th, 2025. This change will not affect integration partners using our partner api.
If you're an Artsy partner gallery, reach out to your Artsy Liaison or contact our Support team for assistance.
Public API Documentation > Resources > Images
Retrieve collections of images following the "images" link from shows.
curl -v "https://api.artsy.net/api/images?show_id={show_id}" -H "X-XAPP-Token: XAPP_TOKEN"
This endpoint accepts the following parameters.
| Name | Value |
|---|---|
| show_id | Retrieve images for a given show, often called "installation shots". |
Images are usually related to other objects, such as profiles.
curl -v "https://api.artsy.net/api/images/{id}" -H "X-XAPP-Token: XAPP_TOKEN"
error: the server responded with status 404
| Key | Target |
|---|---|
| self | The image resource. |
{
"id": "54bfdb597261692b57fd0000",
"created_at": "2015-01-21T17:01:13+00:00",
"updated_at": "2015-01-21T17:01:13+00:00",
"position": 1,
"default": false,
"aspect_ratio": null,
"original_height": null,
"original_width": null,
"image_versions": [
"medium250x165",
"wide"
],
"_links": {
"thumbnail": {
"href": "https://d32dm0rphc51dk.cloudfront.net/-AzVJo2GfeQceXVceoqHKA/medium250x165.jpg"
},
"image": {
"href": "https://d32dm0rphc51dk.cloudfront.net/-AzVJo2GfeQceXVceoqHKA/{image_version}.jpg",
"templated": true
},
"self": {
"href": "https://api.artsy.net/api/images/54bfdb597261692b57fd0000"
}
}
}