ARTLOOK 5.2 API
Revision September 2023
Getting started
Function calls
All image IDs are the same as item IDs (eg. artwork item 78654 has image 78654.JPG). Similarly grouping images have the same ID as the grouping (grouping 567 will have grouping image 567.JPG and likewise with contact images.
All images are stored on Amazon AWS and cached via the Bunny CDN. They can be directly accessed via the following URL:
https://artlook.b-cdn.net/
using the following formats (all prefaced with the above URL):
| Image Type | Call structure | Call example |
| artwork - thumbnail | /tenant-id/items/item-id.JPG | /1/items/78654.JPG |
| artwork – original size | /tenant-id/items/FS_item-id.JPG | /1/items/FS_78654.JPG |
| grouping - thumbnail | /tenant-id/groupings/grouping-id.JPG | /1/groupings/78.JPG |
| grouping – original size | /tenant-id/items/FS_grouping-id.JPG | /1/groupings/FS_78.JPG |
| Contact – thumbnail | /tenant-id/contacts/contact-id.JPG | /1/contacts/654.JPG |
| Contact – original size | /tenant-id/contacts/FS_contact-id.JPG | /1/contacts/FS_654.JPG |
| Artist representative image – thumbnail | /tenant-id/contacts/contact-id_.JPG | /1/contacts/654_.JPG |
| Artist representative image – original size | /tenant-id/contacts/FS_contact-id_.JPG | /1/contacts/FS_654_.JPG |
However, most API calls also return a list of images with a fully qualified filename ($data->images). Similarly, see $data->thumbs.
To make use of our inbuilt image caching and pre-sizing/cropping, instead make calls for images to
https://imagecache.artlookonline.com/image/
using the following formats (all prefaced with the above URL):
/required-size/tenant-id/image-type/FS_id.JPG
Example (for a 1024 x 800 version):
https://imagecache.artlookonline.com/image/slide/1184/items/FS_78654.JPG
“Required-size” options:
- slide – fits the image to a 1024 x 800 size
- x768 – returns a cropped to 768 square
- w768 – return a 768 wide image
- h300 – returns a 300 high image
- fullhd – returns a 1920 x 1080 sized version of the image
“Image-type” options
- items
- groupings
- contacts
Artworks (items) and groupings have a principal image as described above. They may also have additional or
subimages. If an item or grouping has subimages these can be called as follows:
https://imagecache.artlookonline.com/image/{size}/{tenant}/{type}/extras/{id}FS_{id}_{sub-counter}.JPG
Example:
https://imagecache.artlookonline.com/image/slide/1184/groupings/extras/40121/FS_40121_0001.JPG
Where {sub-counter} is the count of subimage padded with 3 zeros.
However, the API will always return the id of the image and an array of fully qualified subimage paths if they exist so that is an easier way to load the additional images.
All API calls that return artworks (items) also return an image URL, usually with the property image. Usually a thumb property that represents the URL of a thumbnail version of the image is also returned. These URLs are complete and need no additional programmatic manipulation provided the required size is either full size or thumbnail. However, if a different size is required it is recommended to use the imagecache described above.
©Artlook Software Limited 2016 - 2017