Skip to main content

Collection Image

This endpoint gives all the information you need to show the image split up in tiles. This was used to implement the zoom functionality on the Rijksmuseum website in the previous version of Rijksstudio. This specific API only supports the JSON format.

Collection Image Base URL
https://www.rijksmuseum.nl/api{culture}/collection/{object-number}/tiles

Parameters

The following parameters are supported:

ParameterFormatDefaultNotes
keya-z|0-9Required: add your API-key to every request.
object-numbera-z|0-9|-The identifier of the object (case-sensitive).

Example Collection Image

Request

https://www.rijksmuseum.nl/api/nl/collection/SK-C-5/tiles?key={api-key}

Response

{
"levels":[
{
"name":"z3",
"width":1771,
"height":1441,
"tiles":[
{
"x":2,
"y":2,
"url":"http://lh3.googleusercontent.com/-I1HN0VxmDySYN5oCqaykuTRukdFh-JemILAmTvHtGsGnBm968CiQpxkfgqQZnbKD5bS1m0tGZYx7v8HFnWjE3kizw=s0"
},
// more results...
]
}
{
"name":"z4",
"width":885,
"height":720,
"tiles":[
{
"x":1,
"y":0,
"url":"http://lh3.googleusercontent.com/-fBdzIPG0qlGnIkqKUFaX3dAiEnC9jnfCIR9ib32M1xh7bPHuK6ZTJMxgwn8jYsvymdupCFdtm3vHJg-n10JuhBD7w=s0"
},
// more results...
]
},
// more results...
]
}

As you can see, this API returns a list of zoom levels. These levels have a number of tiles. The tiles form the full image. You can choose the right level by using the width and height. They describe the total resolution of the chosen level. You can also select a level by name. Level z0 contains the largest available image and z6 the smallest.

When you have chosen a level you can construct the image by positioning the tiles. X and Y describe the horizontal and vertical position of each image.