Collection

This endpoint gives access to the collection with brief information about each object. The results are split up in result pages. By using the p and ps parameters you can fetch more results, up to a total of 10,000. All of the other parameters are identical to the advanced search page on the Rijksmuseum website. You can use that page to find out what's the best query to use, especially for parameters like involvedMake, type, material and technique.

Collection Base URL

https://www.rijksmuseum.nl/api/{culture}/collection

Parameters

The following parameters are supported:

Parameter	Format	Default	Notes
key	a-z|0-9		Required: add your API-key to every request.
format	json / jsonp / xml	json	The format of the result.
culture	nl / en		The language of both the search and the data in the search results.
p	0-n	0	The result page.
ps	1-100	10	The number of results per page.
q	a-z		The search terms that need to occur in one of the fields of the object data.
involvedMaker	a-z		Object needs to be made by this agent. Case sensitive. E.g. Rembrandt+van+Rijn
type	a-z		The type of the object (singular). E.g. painting
material	a-z		The material of the object. E.g.canvas
technique	a-z		The technique used to make the object. E.g. etching
f.dating.period	0-21		The century in which the object is made. Can be negative as well (e.g. -1)
f.normalized32Colors.hex	Color HEX		Colors found in the images (mind: The # in #FF0000 should be url-encoded!).
imgonly	True / False	False	Only give results for which an image is available (true) or not (false).
toppieces	True / False	False	Only give works that are top pieces (true) or not (false).
s	relevance		Sort results on relevance.
s	objecttype		Sort results on type.
s	chronologic		Sort results chronologically (oldest first).
s	achronologic		Sort results chronologically (newest first).
s	artist		Sort results on artist (a-z).
s	artistdesc		Sort results on artist (z-a).

note

Note that page * pageSize cannot exceed 10,000.

Example Collection

Request

https://www.rijksmuseum.nl/api/nl/collection?key={api-key}&involvedMaker=Rembrandt+van+Rijn

Response

{
  "elapsedMilliseconds": 0,
  "count": 3491,
  "artObjects": [
    {
      "links": {
        "self": "http://www.rijksmuseum.nl/api/nl/collection/SK-C-5",
        "web": "http://www.rijksmuseum.nl/nl/collectie/SK-C-5"
      },
      "id": "nl-SK-C-5",
      "objectNumber": "SK-C-5",
      "title": "De Nachtwacht",
      "hasImage": true,
      "principalOrFirstMaker": "Rembrandt van Rijn",
      "longTitle": "De Nachtwacht, Rembrandt van Rijn, 1642",
      "showImage": true,
      "permitDownload": true,
      "webImage": {
          "guid": "bbd1fae8-4023-4859-8ed1-d38616aec96c",
          "offsetPercentageX": 0,
          "offsetPercentageY": 1,
          "width": 5656,
          "height": 4704,
          "url":"https://lh3.googleusercontent.com/SsEIJWka3_cYRXXSE8VD3XNOgtOxoZhqW1uB6UFj78eg8gq3G4jAqL4Z_5KwA12aD7Leqp27F653aBkYkRBkEQyeKxfaZPyDx0O8CzWg=s0"
      },
      "headerImage": {
        "guid": "29a2a516-f1d2-4713-9cbd-7a4458026057",
        "offsetPercentageX": 0,
        "offsetPercentageY": 0,
        "width": 1920,
        "height": 460,
        "url": "https://lh3.googleusercontent.com/nAHNYM604vhPa1hbE_hBJw55JI01-ls0zCwHwvDEES38PpGyGHMgG_vaigVWSuK8GFkaxfn2Dmevw_Nmujn5dKW3jItgS6QaSI8VIsiH=s0"
      },
      "productionPlaces": ["Amsterdam"]
    },
    // more results...
  ]
}