# SMK (National Gallery of Denmark)

> Explore SMK, the National Gallery of Denmark: search over 200,000 paintings, prints, drawings and sculptures by artist, type, technique, date and more, read an artwork's full record with its images and whether they are free to reuse, find artworks that look alike or show places near you, pick random highlights, and look up artists. A trigger starts a workflow when SMK adds a matching artwork. No account or API key required.

App · 11 actions. Web page: https://docs.lodol.com/docs/integrations/smk

## Actions

### Count artworks by

Count the artworks a search matches per object type, technique, material, artist, nationality, gender, department, person depicted, tag, colour, gallery room, collection and more, most first. Each value is ready for the matching field of 'Search artworks'.

**Inputs**

- Count by (`group_by`, text, required): What to count the matching artworks by. One of: `object_type` (Object type), `technique`, `material`, `artist`, `artist_nationality` (Artist's nationality), `artist_gender` (Artist's gender), `artist_role` (Artist's role (after, publisher, printer...)), `department`, `person_depicted` (Person depicted), `tag` (Tag (from image recognition)), and 8 more.
- Search words (`query`, text): Words to find in an artwork's record, such as skagen. Put a phrase in double quotes ("fall of the titans") and a hyphen before a word to leave it out. Leave empty to list everything the other fields allow.
- Object type (`object_type`, text): Only artworks of this type, such as painting, drawing or etching: one of the commonest, or any other typed as SMK names it. Leave empty for any.
- Technique (`technique`, text): Only artworks made this way, such as oil on canvas or woodcut: one of the commonest, or any other typed as SMK names it. Leave empty for any.
- Material (`material`, text): Only artworks made of this, such as canvas or bronze. Leave empty for any.
- Artist (`artist`, text): Only artworks by this artist: one of the 200 with the most works at SMK, a name typed exactly as SMK writes it (Vilhelm Hammershøi), or an artist ID from 'Search artists' (180_person). Leave empty for any.
- Artist's nationality (`artist_nationality`, text): Only artworks by artists of this nationality, such as danish or dutch. Leave empty for any.
- Department (`department`, text): Only artworks one of SMK's departments looks after, such as the Royal Collection of Paintings and Sculptures. Leave empty for all.
- Made from year (`made_from_year`, number): Only artworks made in or after this year. One dated loosely (1800 to 1810) counts when its dates overlap. Leave empty for no limit. From 1 to 2100.
- Made to year (`made_to_year`, number): Only artworks made in or before this year. Leave empty for no limit. From 1 to 2100.
- Public domain only (`public_domain_only`, true/false): Only artworks in the public domain, whose images are free to use for any purpose. Default: `false`.
- With an image only (`with_image_only`, true/false): Only artworks SMK has photographed. Default: `false`.
- On display only (`on_display_only`, true/false): Only artworks on display at SMK now. Default: `false`.
- Most values (`limit`, number): How many values to list, most first, up to 500. From 1 to 500. Default: `50`.
- Language (`language`, text): The language of titles, object types and techniques, and of the words searched for. SMK has English titles for its best-known works; the rest stay in Danish. The dropdowns' values are English, so with Danish, type Danish words (maleri for painting). One of: `en` (English), `da` (Danish). Default: `en`.

**Outputs**

- `count` (number): How many values are listed.
- `filter_field` (text): The 'Search artworks' field each value goes into, such as 'object_type'; empty when there is none.
- `group_by` (text): What the artworks were counted by, such as 'object_type'.
- `total` (number): How many artworks the search matched.
- `values` (list): Each value and how many artworks have it, most first.

**Example output**

```json
{
  "count": 2,
  "filter_field": "object_type",
  "group_by": "object_type",
  "total": 203745,
  "values": [
    {
      "count": 112690,
      "label": "print",
      "value": "print"
    },
    {
      "count": 75289,
      "label": "drawing",
      "value": "drawing"
    }
  ]
}
```

### Find artworks of places near a point

Find artworks showing places within a distance of a point on the map, such as views of Copenhagen, narrowed by words, object type, public domain and images. SMK has mapped about 5,000 artworks, mostly of places in Denmark. Each comes with its place and how far it is.

**Inputs**

- Latitude (`latitude`, number, required): The point's latitude, such as 55.6761 for Copenhagen. From -90 to 90.
- Longitude (`longitude`, number, required): The point's longitude, such as 12.5683 for Copenhagen. From -180 to 180.
- Within (km) (`distance_km`, number): How far around to look, in kilometres. From 0.1 to 500.0. Default: `5.0`.
- Search words (`query`, text): Words to find in an artwork's record, such as skagen. Put a phrase in double quotes ("fall of the titans") and a hyphen before a word to leave it out. Leave empty to list everything the other fields allow.
- Object type (`object_type`, text): Only artworks of this type, such as painting, drawing or etching: one of the commonest, or any other typed as SMK names it. Leave empty for any.
- Public domain only (`public_domain_only`, true/false): Only artworks in the public domain, whose images are free to use for any purpose. Default: `false`.
- With an image only (`with_image_only`, true/false): Only artworks SMK has photographed. Default: `false`.
- Sort by (`sort`, text): The order of the results. Best match comes first by default. One of: `relevance` (Best match), `production_date` (Date made), `acquired` (Date acquired by SMK), `added` (Date added to SMK's online collection), `changed` (Date the record last changed), `object_number` (Object number). Default: `relevance`.
- Order (`sort_order`, text): Newest or highest first, or oldest or lowest first. One of: `desc` (Descending (newest or highest first)), `asc` (Ascending (oldest or lowest first)). Default: `desc`.
- Language (`language`, text): The language of titles, object types and techniques, and of the words searched for. SMK has English titles for its best-known works; the rest stay in Danish. The dropdowns' values are English, so with Danish, type Danish words (maleri for painting). One of: `en` (English), `da` (Danish). Default: `en`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.
- Results per page (`per_page`, number): How many to return on a page, up to 100. From 1 to 100. Default: `20`.

**Outputs**

- `artworks` (list): The artworks on this page.
- `count` (number): How many are on this page.
- `distance_km` (number): How far around it was searched, in kilometres.
- `latitude` (number): The latitude searched from.
- `longitude` (number): The longitude searched from.
- `more_available` (true/false): Whether there is a next page.
- `page` (number): This page's number, from 1.
- `per_page` (number): How many a page holds.
- `total` (number): How many match in all.

**Example output**

```json
{
  "artworks": [
    {
      "added": "2020-03-21",
      "artist": "H.G.F. Holm",
      "artist_id": "4977_person",
      "artists": [
        "H.G.F. Holm"
      ],
      "copyright": null,
      "date": "1803-1861",
      "distance_km": 0.747,
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KKSgb20565",
      "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi93Mzc2M2I5Mzdfa2tzZ2IyMDU2NS50aWYuanAyL2Z1bGwvZnVsbC8wL25hdGl2ZS5qcGciLCJwdWJsaWNfZG9tYWluIjp0cnVlLCJvYmplY3RfbnVtYmVyIjoiS0tTZ2IyMDU2NSIsIm51bSI6IiJ9X...",
      "image_height": 4518,
      "image_iiif_id": "https://iip.smk.dk/iiif/jp2/w3763b937_kksgb20565.tif.jp2",
      "image_iiif_info": "https://iip.smk.dk/iiif/jp2/w3763b937_kksgb20565.tif.jp2/info.json",
      "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/w3763b937_kksgb20565.tif.jp2/full/!1024,/0/default.jpg",
      "image_width": 6592,
      "last_changed": "2026-04-23",
      "latitude": 55.681347,
      "licence": "Public domain",
      "longitude": 12.5757299,
      "materials": [],
      "object_number": "KKSgb20565",
      "object_type": "Watercolour, Drawing",
      "on_display": false,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": null,
      "techniques": [],
      "title": "Udsigt fra Rundet\u00e5rn over K\u00f8benhavn til Frederiksberg Slot",
      "url": "https://open.smk.dk/artwork/image/KKSgb20565",
      "year_from": 1803,
      "year_to": 1861
    },
    {
      "added": "2020-03-21",
      "artist": "Adam Willaerts",
      "artist_id": "30637_person",
      "artists": [
        "Adam Willaerts"
      ],
      "copyright": null,
      "date": "1637-1638",
      "distance_km": 1.232,
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KKSgb17295",
      "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi92dDE1MG42N21fa2tzZ2IxNzI5NS50aWYuanAyL2Z1bGwvZnVsbC8wL25hdGl2ZS5qcGciLCJwdWJsaWNfZG9tYWluIjp0cnVlLCJvYmplY3RfbnVtYmVyIjoiS0tTZ2IxNzI5NSIsIm51bSI6IiJ9X...",
      "image_height": 5080,
      "image_iiif_id": "https://iip.smk.dk/iiif/jp2/vt150n67m_kksgb17295.tif.jp2",
      "image_iiif_info": "https://iip.smk.dk/iiif/jp2/vt150n67m_kksgb17295.tif.jp2/info.json",
      "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/vt150n67m_kksgb17295.tif.jp2/full/!1024,/0/default.jpg",
      "image_width": 7156,
      "last_changed": "2026-09-03",
      "latitude": 55.67634666739197,
      "licence": "Public domain",
      "longitude": 12.587949512316898,
      "materials": [],
      "object_number": "KKSgb17295",
      "object_type": "Drawing",
      "on_display": false,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": null,
      "techniques": [],
      "title": "Christian II leaves Copenhagen in 1523",
      "url": "https://open.smk.dk/artwork/image/KKSgb17295",
      "year_from": 1637,
      "year_to": 1638
    }
  ],
  "count": 2,
  "distance_km": 2.0,
  "latitude": 55.6761,
  "longitude": 12.5683,
  "more_available": true,
  "page": 1,
  "per_page": 2,
  "total": 849
}
```

### Find artworks of places near another artwork

Find artworks showing places near the place another artwork shows, nearest first, such as other views of the same street. Works for the artworks SMK has put on its map; each comes with its place and how far it is.

**Inputs**

- Object number (`object_number`, text, required): The artwork's object number (inventory number), such as KMS1, in any case, or its address on open.smk.dk. 'Search artworks' gives it.
- Within (km) (`distance_km`, number): How far around to look, in kilometres. From 0.1 to 500.0. Default: `5.0`.
- Language (`language`, text): The language of titles, object types and techniques, and of the words searched for. SMK has English titles for its best-known works; the rest stay in Danish. The dropdowns' values are English, so with Danish, type Danish words (maleri for painting). One of: `en` (English), `da` (Danish). Default: `en`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.
- Results per page (`per_page`, number): How many to return on a page, up to 100. From 1 to 100. Default: `20`.

**Outputs**

- `artworks` (list): The artworks on this page, nearest first.
- `count` (number): How many are on this page.
- `distance_km` (number): How far around it was searched, in kilometres.
- `latitude` (number): The latitude of the place it shows.
- `longitude` (number): The longitude of the place it shows.
- `more_available` (true/false): Whether there is a next page.
- `object_number` (text): The artwork's object number (inventory number), such as 'KMS1'. Every action that takes an artwork accepts it.
- `page` (number): This page's number, from 1.
- `per_page` (number): How many a page holds.
- `title` (text): The title of the artwork searched from.
- `total` (number): How many match in all.

**Example output**

```json
{
  "artworks": [
    {
      "added": "2020-03-21",
      "artist": "Johan Herman Thiele",
      "artist_id": "11067_person",
      "artists": [
        "Johan Herman Thiele"
      ],
      "copyright": null,
      "date": "1735-1750",
      "distance_km": 0.0,
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KKSgb11372",
      "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi85czE2MTg2NzFfa2tzZ2IxMTM3Mi50aWYucmVjb25zdHJ1Y3RlZC50aWYuanAyL2Z1bGwvZnVsbC8wL25hdGl2ZS5qcGciLCJwdWJsaWNfZG9tYWluIjp0cnVlLCJvYmplY3RfbnVtYmVyIjoiS0tTZ...",
      "image_height": 5187,
      "image_iiif_id": "https://iip.smk.dk/iiif/jp2/9s1618671_kksgb11372.tif.reconstructed.tif.jp2",
      "image_iiif_info": "https://iip.smk.dk/iiif/jp2/9s1618671_kksgb11372.tif.reconstructed.tif.jp2/info.json",
      "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/9s1618671_kksgb11372.tif.reconstructed.tif.jp2/full/!1024,/0/default.jpg",
      "image_width": 3788,
      "last_changed": "2025-07-11",
      "latitude": 55.681347,
      "licence": "Public domain",
      "longitude": 12.5757299,
      "materials": [],
      "object_number": "KKSgb11372",
      "object_type": "Copper engraving, Print",
      "on_display": false,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": null,
      "techniques": [
        "Copper engraving"
      ],
      "title": "Rundet\u00e5rn",
      "url": "https://open.smk.dk/artwork/image/KKSgb11372",
      "year_from": 1735,
      "year_to": 1750
    },
    {
      "added": "2020-03-21",
      "artist": "Bj\u00f8rn N\u00f8rgaard",
      "artist_id": "454_person",
      "artists": [
        "Bj\u00f8rn N\u00f8rgaard"
      ],
      "copyright": "\u00a9 Bj\u00f8rn N\u00f8rgaard / VISDA",
      "date": "1978",
      "distance_km": 0.0,
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KKS1982-140/12",
      "image_download": "https://api.smk.dk/api/v1/thumbnail/d0e0ea3f-df2d-4e26-9055-06d76d6052ac.jpg",
      "image_height": 1600,
      "image_iiif_id": null,
      "image_iiif_info": null,
      "image_thumbnail": "https://api.smk.dk/api/v1/thumbnail/d0e0ea3f-df2d-4e26-9055-06d76d6052ac.jpg",
      "image_width": 1178,
      "last_changed": "2025-07-11",
      "latitude": 55.681347,
      "licence": "In copyright",
      "longitude": 12.5757299,
      "materials": [],
      "object_number": "KKS1982-140/12",
      "object_type": "Drawing",
      "on_display": false,
      "public_domain": false,
      "rights_url": "https://www.smk.dk/en/section/use-of-smk-material/",
      "room": null,
      "techniques": [
        "Pencil"
      ],
      "title": "Tre skitser af Rundet\u00e5rn, mileh\u00f8j, milep\u00e6l og \"L\u00f8gspir p\u00e5 kirke\"",
      "url": "https://open.smk.dk/artwork/image/KKS1982-140/12",
      "year_from": 1978,
      "year_to": 1978
    }
  ],
  "count": 2,
  "distance_km": 1.0,
  "latitude": 55.681347,
  "longitude": 12.5757299,
  "more_available": true,
  "object_number": "KKSgb20565",
  "page": 1,
  "per_page": 2,
  "title": "Udsigt fra Rundet\u00e5rn over K\u00f8benhavn til Frederiksberg Slot",
  "total": 644
}
```

### Find similar artworks

Find the artworks that look most like one, as SMK's image analysis sees them (four, for a photographed work), each with everything 'Search artworks' gives.

**Inputs**

- Object number (`object_number`, text, required): The artwork's object number (inventory number), such as KMS1, in any case, or its address on open.smk.dk. 'Search artworks' gives it.
- Language (`language`, text): The language of titles, object types and techniques, and of the words searched for. SMK has English titles for its best-known works; the rest stay in Danish. The dropdowns' values are English, so with Danish, type Danish words (maleri for painting). One of: `en` (English), `da` (Danish). Default: `en`.

**Outputs**

- `artworks` (list): The similar artworks, most similar first.
- `count` (number): How many similar artworks were found (SMK gives four).
- `has_image` (true/false): Whether it has a picture; without one SMK finds nothing similar.
- `object_number` (text): The artwork's object number (inventory number), such as 'KMS1'. Every action that takes an artwork accepts it.
- `title` (text): The artwork's title.

**Example output**

```json
{
  "artworks": [
    {
      "added": "2020-03-21",
      "artist": "Vilhelm Hammersh\u00f8i",
      "artist_id": "180_person",
      "artists": [
        "Vilhelm Hammersh\u00f8i"
      ],
      "copyright": null,
      "date": "1888",
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KMS7246",
      "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi9kNTA0cnAzODVfS01TNzI0Ni50aWYucmVjb25zdHJ1Y3RlZC50aWYuanAyL2Z1bGwvZnVsbC8wL25hdGl2ZS5qcGciLCJwdWJsaWNfZG9tYWluIjp0cnVlLCJvYmplY3RfbnVtYmVyIjoiS01TNzI0N...",
      "image_height": 6177,
      "image_iiif_id": "https://iip.smk.dk/iiif/jp2/d504rp385_KMS7246.tif.reconstructed.tif.jp2",
      "image_iiif_info": "https://iip.smk.dk/iiif/jp2/d504rp385_KMS7246.tif.reconstructed.tif.jp2/info.json",
      "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/d504rp385_KMS7246.tif.reconstructed.tif.jp2/full/!1024,/0/default.jpg",
      "image_width": 5054,
      "last_changed": "2026-07-29",
      "licence": "Public domain",
      "materials": [
        "canvas"
      ],
      "object_number": "KMS7246",
      "object_type": "Painting",
      "on_display": false,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": null,
      "techniques": [
        "Oil on canvas"
      ],
      "title": "Interior. An Old Stove",
      "url": "https://open.smk.dk/artwork/image/KMS7246",
      "year_from": 1888,
      "year_to": 1888
    },
    {
      "added": "2020-03-21",
      "artist": "Vilhelm Hammersh\u00f8i",
      "artist_id": "180_person",
      "artists": [
        "Vilhelm Hammersh\u00f8i"
      ],
      "copyright": null,
      "date": "1902",
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KMS3697",
      "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi80MTY4N205MmtfS01TMzY5Ny50aWYuY3JvcHBlZC50aWYuanAyL2Z1bGwvZnVsbC8wL25hdGl2ZS5qcGciLCJwdWJsaWNfZG9tYWluIjp0cnVlLCJvYmplY3RfbnVtYmVyIjoiS01TMzY5NyIsIm51b...",
      "image_height": 3907,
      "image_iiif_id": "https://iip.smk.dk/iiif/jp2/41687m92k_KMS3697.tif.cropped.tif.jp2",
      "image_iiif_info": "https://iip.smk.dk/iiif/jp2/41687m92k_KMS3697.tif.cropped.tif.jp2/info.json",
      "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/41687m92k_KMS3697.tif.cropped.tif.jp2/full/!1024,/0/default.jpg",
      "image_width": 3656,
      "last_changed": "2026-07-29",
      "licence": "Public domain",
      "materials": [
        "canvas"
      ],
      "object_number": "KMS3697",
      "object_type": "Painting",
      "on_display": false,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": null,
      "techniques": [
        "Oil on canvas"
      ],
      "title": "A Room in the Artist's Home in Strandgade, Copenhagen, with the Artist's Wife",
      "url": "https://open.smk.dk/artwork/image/KMS3697",
      "year_from": 1902,
      "year_to": 1902
    }
  ],
  "count": 2,
  "has_image": true,
  "object_number": "KMS3696",
  "title": "Interior in Strandgade, Sunlight on the Floor"
}
```

### Get an artist

Get one artist by their SMK artist ID: names, birth and death dates, nationality, gender, and the object numbers of every work of theirs SMK has.

**Inputs**

- Artist ID (`artist_id`, text, required): SMK's ID for the artist, such as 180_person (or just 180). 'Search artists' gives it, and every artwork gives its artist's.

**Outputs**

- `added` (text): When their record was added (YYYY-MM-DD).
- `artist_id` (text): SMK's ID for the artist, such as '180_person'. 'Get an artist' and 'List an artist's artworks' take it.
- `artwork_count` (number): How many of their works SMK has.
- `birth_year` (number): The year they were born.
- `born` (text): When they were born, as precisely as SMK knows it (YYYY-MM-DD or a year).
- `death_year` (number): The year they died.
- `died` (text): When they died, as precisely as SMK knows it.
- `forename` (text): Their forename.
- `gender` (text): 'male', 'female' or 'unknown'.
- `last_changed` (text): When their record last changed (YYYY-MM-DD).
- `name` (text): Their name, forename first, such as 'Vilhelm Hammershøi'.
- `name_inverted` (text): Their name surname first, as SMK files it.
- `nationality` (text): Their nationality, such as 'Danish'.
- `object_numbers` (list): The object numbers of their works at SMK, for 'Get several artworks'.
- `surname` (text): Their surname.

**Example output**

```json
{
  "added": "2021-08-31",
  "artist_id": "180_person",
  "artwork_count": 64,
  "birth_year": 1864,
  "born": "1864-05-15",
  "death_year": 1916,
  "died": "1916-02-13",
  "forename": "Vilhelm",
  "gender": "male",
  "last_changed": "2022-05-18",
  "name": "Vilhelm Hammersh\u00f8i",
  "name_inverted": "Hammersh\u00f8i, Vilhelm",
  "nationality": "Danish",
  "object_numbers": [
    "KMS1542",
    "KMS3358"
  ],
  "surname": "Hammersh\u00f8i"
}
```

### Get an artwork

Get one artwork by its object number with everything SMK records: titles, credits, dating, measurements, inscriptions, SMK's texts about it, exhibitions, literature, people and places shown, and every picture with its download and IIIF links, plus whether it is in the public domain or who holds the copyright.

**Inputs**

- Object number (`object_number`, text, required): The artwork's object number (inventory number), such as KMS1, in any case, or its address on open.smk.dk. 'Search artworks' gives it.
- Language (`language`, text): The language of titles, object types and techniques, and of the words searched for. SMK has English titles for its best-known works; the rest stay in Danish. The dropdowns' values are English, so with Danish, type Danish words (maleri for painting). One of: `en` (English), `da` (Danish). Default: `en`.

**Outputs**

- `acquired` (text): When SMK acquired it.
- `added` (text): When it was added to SMK's online collection (YYYY-MM-DD).
- `artist` (text): Who made it, as SMK credits it; several artists are separated by semicolons.
- `artist_id` (text): SMK's ID for the artist, such as '180_person'. 'Get an artist' and 'List an artist's artworks' take it.
- `artists` (list): Each artist SMK credits, such as 'Vilhelm Hammershøi'.
- `collection` (text): The collection it came to SMK with.
- `colours` (list): Its main colours, as hex codes such as '#ec6449'.
- `copyright` (text): Who holds the copyright, such as '© Al Masson / VISDA', for a work still in copyright.
- `date` (text): When it was made, as SMK writes it, such as '1588-1590'.
- `date_notes` (list): SMK's notes on how it is dated.
- `department` (text): The SMK department that looks after it, such as 'Den Kongelige Maleri- og Skulptursamling'. SMK gives it only when Danish is chosen.
- `dimensions` (list): Its measurements.
- `exhibitions` (list): Exhibitions it has been in.
- `has_image` (true/false): Whether SMK has a photograph of it online.
- `iiif_manifest` (text): Its IIIF manifest, which IIIF viewers such as Mirador open, with every picture and its rights.
- `image_download` (text): The full-size picture, as a JPEG to download (often several thousand pixels).
- `image_height` (number): The full-size picture's height, in pixels.
- `image_iiif_id` (text): Its picture's IIIF Image API address, for any size or crop: add /full/!800,800/0/default.jpg for one at most 800 pixels.
- `image_iiif_info` (text): Its picture's IIIF info.json, giving the sizes on offer.
- `image_thumbnail` (text): A picture of it about 1,024 pixels wide, ready to show.
- `image_width` (number): The full-size picture's width, in pixels.
- `images` (list): Every photograph of it, the main one first.
- `inscriptions` (list): Signatures, dates and other writing on it.
- `last_changed` (text): When its record last changed (YYYY-MM-DD).
- `latitude` (number): The latitude of the place it shows, when SMK has put it on its map.
- `licence` (text): 'Public domain', 'Public domain (CC0)' (a few works SMK marks with CC0) or 'In copyright', in words.
- `literature` (list): Books and articles that discuss it.
- `longitude` (number): The longitude of the place it shows.
- `materials` (list): What it is made of, such as 'canvas'.
- `object_number` (text): The artwork's object number (inventory number), such as 'KMS1'. Every action that takes an artwork accepts it.
- `object_type` (text): What kind of object it is, such as 'Painting' or 'Etching, Print'.
- `on_display` (true/false): Whether it is on display at SMK now.
- `part_of` (list): The object numbers of the works it is part of.
- `parts` (list): The object numbers of its parts.
- `people_depicted` (list): People it portrays or shows, such as 'H.C. Andersen'.
- `production` (list): Everyone SMK credits for it, and their part.
- `public_domain` (true/false): Whether it is in the public domain: if so its images are free to use for any purpose without asking; if not, the artist's rights holder must agree first.
- `rights_url` (text): A link explaining the rights: the Public Domain Mark (or CC0) for a free work, SMK's page on using its material for one in copyright.
- `room` (text): The gallery room it hangs in, such as 'Sal 205', when on display.
- `subjects` (list): Places and subjects it shows, such as 'København'. SMK gives these only when Danish is chosen.
- `techniques` (list): How it was made, such as 'Oil on canvas'.
- `texts` (list): SMK's texts about it, such as its catalogue text.
- `title` (text): Its title, in English when SMK has one and English was asked for, otherwise in Danish.
- `titles` (list): Every title it has had.
- `url` (text): Its page on SMK Open, SMK's online collection.
- `work_status` (text): Such as 'part of a series' or 'sketchbook sheet'.
- `year_from` (number): The first year it may have been made in.
- `year_to` (number): The last year it may have been made in.

**Example output**

```json
{
  "acquired": "1924-12-31",
  "added": "2020-03-21",
  "artist": "Vilhelm Hammersh\u00f8i",
  "artist_id": "180_person",
  "artists": [
    "Vilhelm Hammersh\u00f8i"
  ],
  "collection": null,
  "colours": [
    "#bbbbbb",
    "#999999"
  ],
  "copyright": null,
  "date": "1901",
  "date_notes": [
    "V\u00e6rkdatering: (1901)",
    "Datering if. Bramsen & Micha\u00eblis 1918"
  ],
  "department": null,
  "dimensions": [
    {
      "dimension": "height",
      "part": "Netto",
      "unit": "cm",
      "value": "46.5"
    },
    {
      "dimension": "width",
      "part": "Netto",
      "unit": "cm",
      "value": "52"
    }
  ],
  "exhibitions": [
    {
      "end": "2016-02-26",
      "start": "2015-10-16",
      "title": "Painting Tranquility: Masterworks by Vilhelm Hammersh\u00f8i from SMK - The National Gallery of Denmark",
      "venue": "The American-Scandinavian Foundation, New York"
    },
    {
      "end": "2016-06-25",
      "start": "2016-04-15",
      "title": "Painting Tranquility: Masterworks by Vilhelm Hammersh\u00f8i from SMK - The National Gallery of Denmark",
      "venue": "AGO Art Gallery of Ontario, Toronto"
    }
  ],
  "has_image": true,
  "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KMS3696",
  "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi8zMTk3eHI4MzFfS01TMzY5Ni50aWYuanAyL2Z1bGwvZnVsbC8wL25hdGl2ZS5qcGciLCJwdWJsaWNfZG9tYWluIjp0cnVlLCJvYmplY3RfbnVtYmVyIjoiS01TMzY5NiIsIm51bSI6IiJ9XQ==/KMS3...",
  "image_height": 20467,
  "image_iiif_id": "https://iip.smk.dk/iiif/jp2/3197xr831_KMS3696.tif.jp2",
  "image_iiif_info": "https://iip.smk.dk/iiif/jp2/3197xr831_KMS3696.tif.jp2/info.json",
  "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/3197xr831_KMS3696.tif.jp2/full/!1024,/0/default.jpg",
  "image_width": 23311,
  "images": [
    {
      "download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi8zMTk3eHI4MzFfS01TMzY5Ni50aWYuanAyL2Z1bGwvZnVsbC8wL25hdGl2ZS5qcGciLCJwdWJsaWNfZG9tYWluIjp0cnVlLCJvYmplY3RfbnVtYmVyIjoiS01TMzY5NiIsIm51bSI6IiJ9XQ==/KMS3...",
      "height": 20467,
      "iiif_id": "https://iip.smk.dk/iiif/jp2/3197xr831_KMS3696.tif.jp2",
      "iiif_info": "https://iip.smk.dk/iiif/jp2/3197xr831_KMS3696.tif.jp2/info.json",
      "main": true,
      "orientation": "landscape",
      "thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/3197xr831_KMS3696.tif.jp2/full/!1024,/0/default.jpg",
      "width": 23311
    },
    {
      "download": "https://iip.smk.dk/iiif/jp2/ms35t957b_KMS3696_A3.tif.jp2/full/full/0/native.jpg",
      "height": 4132,
      "iiif_id": "https://iip.smk.dk/iiif/jp2/ms35t957b_KMS3696_A3.tif.jp2",
      "iiif_info": "https://iip.smk.dk/iiif/jp2/ms35t957b_KMS3696_A3.tif.jp2/info.json",
      "main": false,
      "orientation": "landscape",
      "thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/ms35t957b_KMS3696_A3.tif.jp2/full/!1024,/0/default.jpg",
      "width": 4724
    }
  ],
  "inscriptions": [
    {
      "kind": "signature",
      "position": null,
      "text": "V H"
    }
  ],
  "last_changed": "2026-05-18",
  "latitude": 55.6756462,
  "licence": "Public domain",
  "literature": [
    {
      "author": "Tone Sinding Steinsvik",
      "pages": "Heri: Bente Scavenius, \"Vilhelm Hammersh\u00f8i\", s. 91, kat. 47",
      "title": "Den forunderlige stilheten: Ida Lorentzen, Wilhelm Hammersh\u00f8i",
      "year": "2005"
    },
    {
      "author": "Annette Rosenvold Hvidt",
      "pages": "Afb. p. 66. Fig. 69.",
      "title": "Fremkaldelser. Vilhelm Hammersh\u00f8i, Valdemar Sch\u00f8nheyder M\u00f8ller og fotografiet",
      "year": "2021"
    }
  ],
  "longitude": 12.5924591,
  "materials": [
    "canvas"
  ],
  "object_number": "KMS3696",
  "object_type": "Painting",
  "on_display": true,
  "part_of": [],
  "parts": [],
  "people_depicted": [],
  "production": [
    {
      "artist_id": "180_person",
      "birth_year": 1864,
      "death_year": 1916,
      "gender": "male",
      "name": "Vilhelm Hammersh\u00f8i",
      "name_inverted": "Hammersh\u00f8i, Vilhelm",
      "nationality": "Danish",
      "role": null
    }
  ],
  "public_domain": true,
  "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
  "room": "Sal 227",
  "subjects": [],
  "techniques": [
    "Oil on canvas"
  ],
  "texts": [
    {
      "author": "AHV",
      "date": null,
      "kind": "OTHERTEXT",
      "text": "Much of Hammersh\u00f8i\u2019s work shows interiors from his homes. Over the years he would use his changing homes as studio and subject matter. He did not choose his flats at random. In an interview with the magazine Hjemmet (The Home) in 1909..."
    }
  ],
  "title": "Interior in Strandgade, Sunlight on the Floor",
  "titles": [
    {
      "kind": null,
      "language": "engelsk",
      "title": "Interior in Strandgade, Sunlight on the Floor"
    },
    {
      "kind": "previous title",
      "language": "engelsk",
      "title": "A Room in the Artist's Home in Strandgade, Copenhagen, with the Artist's Wife"
    }
  ],
  "url": "https://open.smk.dk/artwork/image/KMS3696",
  "work_status": null,
  "year_from": 1901,
  "year_to": 1901
}
```

### Get several artworks

Get up to 50 artworks by their object numbers in one step, such as a column from a spreadsheet, each with everything 'Search artworks' gives, in the order asked, and the numbers SMK doesn't have.

**Inputs**

- Object numbers (`object_numbers`, text, required): Up to 50 object numbers, one per line or separated by commas, or a list from an earlier step.
- Language (`language`, text): The language of titles, object types and techniques, and of the words searched for. SMK has English titles for its best-known works; the rest stay in Danish. The dropdowns' values are English, so with Danish, type Danish words (maleri for painting). One of: `en` (English), `da` (Danish). Default: `en`.

**Outputs**

- `artworks` (list): The artworks found, in the order asked.
- `count` (number): How many SMK has.
- `not_found` (list): The object numbers SMK doesn't have.
- `requested` (number): How many object numbers were asked for.

**Example output**

```json
{
  "artworks": [
    {
      "added": "2020-03-21",
      "artist": "Cornelis Cornelisz. van Haarlem",
      "artist_id": "1563_person",
      "artists": [
        "Cornelis Cornelisz. van Haarlem"
      ],
      "copyright": null,
      "date": "1588-1590",
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KMS1",
      "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi85ZzU0eG04NjlfS01TMS1jcm9wcGVkLnRpZi5qcDIvZnVsbC9mdWxsLzAvbmF0aXZlLmpwZyIsInB1YmxpY19kb21haW4iOnRydWUsIm9iamVjdF9udW1iZXIiOiJLTVMxIiwibnVtIjoiIn1d/KMS1...",
      "image_height": 5536,
      "image_iiif_id": "https://iip.smk.dk/iiif/jp2/9g54xm869_KMS1-cropped.tif.jp2",
      "image_iiif_info": "https://iip.smk.dk/iiif/jp2/9g54xm869_KMS1-cropped.tif.jp2/info.json",
      "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/9g54xm869_KMS1-cropped.tif.jp2/full/!1024,/0/default.jpg",
      "image_width": 7174,
      "last_changed": "2026-07-15",
      "licence": "Public domain",
      "materials": [
        "canvas"
      ],
      "object_number": "KMS1",
      "object_type": "Painting",
      "on_display": true,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": "Sal 205",
      "techniques": [
        "Oil on canvas"
      ],
      "title": "The Fall of the Titans",
      "url": "https://open.smk.dk/artwork/image/KMS1",
      "year_from": 1588,
      "year_to": 1590
    },
    {
      "added": "2020-03-21",
      "artist": "Vilhelm Hammersh\u00f8i",
      "artist_id": "180_person",
      "artists": [
        "Vilhelm Hammersh\u00f8i"
      ],
      "copyright": null,
      "date": "1901",
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KMS3696",
      "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi8zMTk3eHI4MzFfS01TMzY5Ni50aWYuanAyL2Z1bGwvZnVsbC8wL25hdGl2ZS5qcGciLCJwdWJsaWNfZG9tYWluIjp0cnVlLCJvYmplY3RfbnVtYmVyIjoiS01TMzY5NiIsIm51bSI6IiJ9XQ==/KMS3...",
      "image_height": 20467,
      "image_iiif_id": "https://iip.smk.dk/iiif/jp2/3197xr831_KMS3696.tif.jp2",
      "image_iiif_info": "https://iip.smk.dk/iiif/jp2/3197xr831_KMS3696.tif.jp2/info.json",
      "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/3197xr831_KMS3696.tif.jp2/full/!1024,/0/default.jpg",
      "image_width": 23311,
      "last_changed": "2026-05-18",
      "licence": "Public domain",
      "materials": [
        "canvas"
      ],
      "object_number": "KMS3696",
      "object_type": "Painting",
      "on_display": true,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": "Sal 227",
      "techniques": [
        "Oil on canvas"
      ],
      "title": "Interior in Strandgade, Sunlight on the Floor",
      "url": "https://open.smk.dk/artwork/image/KMS3696",
      "year_from": 1901,
      "year_to": 1901
    }
  ],
  "count": 2,
  "not_found": [
    "KMS0"
  ],
  "requested": 3
}
```

### List an artist's artworks

List an artist's works in SMK's collection, a page at a time, each with everything 'Search artworks' gives.

**Inputs**

- Artist ID (`artist_id`, text, required): SMK's ID for the artist, such as 180_person (or just 180). 'Search artists' gives it, and every artwork gives its artist's.
- Language (`language`, text): The language of titles, object types and techniques, and of the words searched for. SMK has English titles for its best-known works; the rest stay in Danish. The dropdowns' values are English, so with Danish, type Danish words (maleri for painting). One of: `en` (English), `da` (Danish). Default: `en`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.
- Results per page (`per_page`, number): How many to return on a page, up to 50. From 1 to 50. Default: `20`.

**Outputs**

- `artist_id` (text): SMK's ID for the artist, such as '180_person'. 'Get an artist' and 'List an artist's artworks' take it.
- `artworks` (list): Their artworks on this page.
- `count` (number): How many are on this page.
- `more_available` (true/false): Whether there is a next page.
- `name` (text): The artist's name.
- `not_found` (list): Object numbers on this page SMK lists for them but couldn't read.
- `page` (number): This page's number, from 1.
- `per_page` (number): How many a page holds.
- `total` (number): How many match in all.

**Example output**

```json
{
  "artist_id": "180_person",
  "artworks": [
    {
      "added": "2020-03-21",
      "artist": "Vilhelm Hammersh\u00f8i",
      "artist_id": "180_person",
      "artists": [
        "Vilhelm Hammersh\u00f8i"
      ],
      "copyright": null,
      "date": "1896",
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KMS1542",
      "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi9qcTA4NXAzMTNfS01TMTU0Mi50aWYucmVjb25zdHJ1Y3RlZC50aWYuanAyL2Z1bGwvZnVsbC8wL25hdGl2ZS5qcGciLCJwdWJsaWNfZG9tYWluIjp0cnVlLCJvYmplY3RfbnVtYmVyIjoiS01TMTU0M...",
      "image_height": 5349,
      "image_iiif_id": "https://iip.smk.dk/iiif/jp2/jq085p313_KMS1542.tif.reconstructed.tif.jp2",
      "image_iiif_info": "https://iip.smk.dk/iiif/jp2/jq085p313_KMS1542.tif.reconstructed.tif.jp2/info.json",
      "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/jq085p313_KMS1542.tif.reconstructed.tif.jp2/full/!1024,/0/default.jpg",
      "image_width": 5379,
      "last_changed": "2026-07-29",
      "licence": "Public domain",
      "materials": [
        "canvas"
      ],
      "object_number": "KMS1542",
      "object_type": "Painting",
      "on_display": false,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": null,
      "techniques": [
        "Oil on canvas"
      ],
      "title": "Amalienborg Square, Copenhagen",
      "url": "https://open.smk.dk/artwork/image/KMS1542",
      "year_from": 1896,
      "year_to": 1896
    },
    {
      "added": "2020-03-21",
      "artist": "Vilhelm Hammersh\u00f8i",
      "artist_id": "180_person",
      "artists": [
        "Vilhelm Hammersh\u00f8i"
      ],
      "copyright": null,
      "date": "1893-1894",
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KMS3358",
      "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi82bTMxMXM3NXdfS01TMzM1OC1jcm9wcGVkLnRpZi5qcDIvZnVsbC9mdWxsLzAvbmF0aXZlLmpwZyIsInB1YmxpY19kb21haW4iOnRydWUsIm9iamVjdF9udW1iZXIiOiJLTVMzMzU4IiwibnVtIjoiI...",
      "image_height": 4541,
      "image_iiif_id": "https://iip.smk.dk/iiif/jp2/6m311s75w_KMS3358-cropped.tif.jp2",
      "image_iiif_info": "https://iip.smk.dk/iiif/jp2/6m311s75w_KMS3358-cropped.tif.jp2/info.json",
      "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/6m311s75w_KMS3358-cropped.tif.jp2/full/!1024,/0/default.jpg",
      "image_width": 5887,
      "last_changed": "2026-04-20",
      "licence": "Public domain",
      "materials": [
        "canvas"
      ],
      "object_number": "KMS3358",
      "object_type": "Painting",
      "on_display": true,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": "Sal 227",
      "techniques": [
        "Oil on canvas"
      ],
      "title": "Artemis",
      "url": "https://open.smk.dk/artwork/image/KMS3358",
      "year_from": 1893,
      "year_to": 1894
    }
  ],
  "count": 2,
  "more_available": true,
  "name": "Vilhelm Hammersh\u00f8i",
  "not_found": [],
  "page": 1,
  "per_page": 2,
  "total": 64
}
```

### Pick random artworks

Pick artworks at random, with SMK's highlights coming up more often: by default photographed public domain works, ready to show and reuse. The same seed, such as today's date, gives the same picks, for an artwork of the day.

**Inputs**

- How many (`count`, number): How many artworks to pick, up to 20. From 1 to 20. Default: `1`.
- Search words (`query`, text): Words to find in an artwork's record, such as skagen. Put a phrase in double quotes ("fall of the titans") and a hyphen before a word to leave it out. Leave empty to list everything the other fields allow.
- Object type (`object_type`, text): Only artworks of this type, such as painting, drawing or etching: one of the commonest, or any other typed as SMK names it. Leave empty for any.
- Public domain only (`public_domain_only`, true/false): Only artworks in the public domain, whose images are free to use for any purpose. Default: `true`.
- With an image only (`with_image_only`, true/false): Only artworks SMK has photographed. Default: `true`.
- Seed (`seed`, text): Any text, such as a date: the same seed picks the same artworks. Leave empty for new picks every time.
- Language (`language`, text): The language of titles, object types and techniques, and of the words searched for. SMK has English titles for its best-known works; the rest stay in Danish. The dropdowns' values are English, so with Danish, type Danish words (maleri for painting). One of: `en` (English), `da` (Danish). Default: `en`.

**Outputs**

- `artworks` (list): The artworks picked.
- `count` (number): How many were picked.
- `seed` (text): The seed used: give it again to get the same picks.
- `total` (number): How many artworks the picks were made from.

**Example output**

```json
{
  "artworks": [
    {
      "added": "2020-03-21",
      "artist": "Frans Hals",
      "artist_id": "2604_person",
      "artists": [
        "Frans Hals"
      ],
      "copyright": null,
      "date": "1647-1648",
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=DEP7",
      "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi9ndDU0a3IwN21fREVQNy50aWYuanAyL2Z1bGwvZnVsbC8wL25hdGl2ZS5qcGciLCJwdWJsaWNfZG9tYWluIjp0cnVlLCJvYmplY3RfbnVtYmVyIjoiREVQNyIsIm51bSI6IiJ9XQ==/DEP7.jpg",
      "image_height": 3877,
      "image_iiif_id": "https://iip.smk.dk/iiif/jp2/gt54kr07m_DEP7.tif.jp2",
      "image_iiif_info": "https://iip.smk.dk/iiif/jp2/gt54kr07m_DEP7.tif.jp2/info.json",
      "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/gt54kr07m_DEP7.tif.jp2/full/!1024,/0/default.jpg",
      "image_width": 2953,
      "last_changed": "2025-07-11",
      "licence": "Public domain",
      "materials": [
        "oak"
      ],
      "object_number": "DEP7",
      "object_type": "Painting",
      "on_display": false,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": null,
      "techniques": [
        "Oil on oak"
      ],
      "title": "Portrait of Ren\u00e9 Descartes (1596-1650)",
      "url": "https://open.smk.dk/artwork/image/DEP7",
      "year_from": 1647,
      "year_to": 1648
    },
    {
      "added": "2020-03-21",
      "artist": "Vilhelm Kyhn",
      "artist_id": "1115_person",
      "artists": [
        "Vilhelm Kyhn"
      ],
      "copyright": null,
      "date": "1849",
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KMS4014",
      "image_download": "https://api.smk.dk/api/v1/thumbnail/2446c84d-2aeb-4b75-8523-74804db4e7b0.jpg",
      "image_height": 1138,
      "image_iiif_id": null,
      "image_iiif_info": null,
      "image_thumbnail": "https://api.smk.dk/api/v1/thumbnail/2446c84d-2aeb-4b75-8523-74804db4e7b0.jpg",
      "image_width": 1600,
      "last_changed": "2025-07-11",
      "licence": "Public domain",
      "materials": [
        "canvas",
        "Paper"
      ],
      "object_number": "KMS4014",
      "object_type": "Painting",
      "on_display": false,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": null,
      "techniques": [
        "Oil on paper, mounted on canvas"
      ],
      "title": "The Coast at Frederiksund. Sketch",
      "url": "https://open.smk.dk/artwork/image/KMS4014",
      "year_from": 1849,
      "year_to": 1849
    }
  ],
  "count": 2,
  "seed": "2026-10-24",
  "total": 39517
}
```

### Search artists

Find artists in SMK's collection by name, nationality, gender and the year they were born. Each comes with their artist ID, dates, nationality and how many of their works SMK has.

**Inputs**

- Name (`query`, text): Words in the artist's name, such as hammershøi or anna ancher. Leave empty to list artists by the other fields.
- Nationality (`nationality`, text): Only artists of this nationality, such as Danish. Leave empty for any.
- Gender (`gender`, text): Only female, male or unknown artists. Leave empty for any. One of: `female`, `male`, `unknown`.
- Born from year (`born_from_year`, number): Only artists born in or after this year. From 1 to 2100.
- Born to year (`born_to_year`, number): Only artists born in or before this year. From 1 to 2100.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.
- Results per page (`per_page`, number): How many to return on a page, up to 100. From 1 to 100. Default: `20`.

**Outputs**

- `artists` (list): The artists on this page.
- `count` (number): How many are on this page.
- `more_available` (true/false): Whether there is a next page.
- `page` (number): This page's number, from 1.
- `per_page` (number): How many a page holds.
- `total` (number): How many match in all.

**Example output**

```json
{
  "artists": [
    {
      "artist_id": "180_person",
      "artwork_count": 64,
      "birth_year": 1864,
      "born": "1864-05-15",
      "death_year": 1916,
      "died": "1916-02-13",
      "forename": "Vilhelm",
      "gender": "male",
      "name": "Vilhelm Hammersh\u00f8i",
      "name_inverted": "Hammersh\u00f8i, Vilhelm",
      "nationality": "Danish",
      "surname": "Hammersh\u00f8i"
    },
    {
      "artist_id": "647_person",
      "artwork_count": 25,
      "birth_year": 1873,
      "born": "1873-08-10",
      "death_year": 1948,
      "died": "1948-02-27",
      "forename": "Svend",
      "gender": "male",
      "name": "Svend Hammersh\u00f8i",
      "name_inverted": "Hammersh\u00f8i, Svend",
      "nationality": "Danish",
      "surname": "Hammersh\u00f8i"
    }
  ],
  "count": 2,
  "more_available": false,
  "page": 1,
  "per_page": 2,
  "total": 2
}
```

### Search artworks

Search SMK's collection of over 200,000 paintings, prints, drawings and sculptures by words and by object type, technique, material, artist, nationality, department and the years they were made, keeping only public domain, photographed or displayed works if you like. Each comes with its artist, date, image links and whether its images are free to reuse.

**Inputs**

- Search words (`query`, text): Words to find in an artwork's record, such as skagen. Put a phrase in double quotes ("fall of the titans") and a hyphen before a word to leave it out. Leave empty to list everything the other fields allow.
- Object type (`object_type`, text): Only artworks of this type, such as painting, drawing or etching: one of the commonest, or any other typed as SMK names it. Leave empty for any.
- Technique (`technique`, text): Only artworks made this way, such as oil on canvas or woodcut: one of the commonest, or any other typed as SMK names it. Leave empty for any.
- Material (`material`, text): Only artworks made of this, such as canvas or bronze. Leave empty for any.
- Artist (`artist`, text): Only artworks by this artist: one of the 200 with the most works at SMK, a name typed exactly as SMK writes it (Vilhelm Hammershøi), or an artist ID from 'Search artists' (180_person). Leave empty for any.
- Artist's nationality (`artist_nationality`, text): Only artworks by artists of this nationality, such as danish or dutch. Leave empty for any.
- Department (`department`, text): Only artworks one of SMK's departments looks after, such as the Royal Collection of Paintings and Sculptures. Leave empty for all.
- Made from year (`made_from_year`, number): Only artworks made in or after this year. One dated loosely (1800 to 1810) counts when its dates overlap. Leave empty for no limit. From 1 to 2100.
- Made to year (`made_to_year`, number): Only artworks made in or before this year. Leave empty for no limit. From 1 to 2100.
- Public domain only (`public_domain_only`, true/false): Only artworks in the public domain, whose images are free to use for any purpose. Default: `false`.
- With an image only (`with_image_only`, true/false): Only artworks SMK has photographed. Default: `false`.
- On display only (`on_display_only`, true/false): Only artworks on display at SMK now. Default: `false`.
- Search in (`search_in`, text): Where the search words are looked for: anywhere (the default), or only in titles, artists' names, object numbers or techniques and materials. One of: `anywhere` (Anywhere in the record), `titles`, `artists` (Artists' names), `object_number` (Object numbers), `techniques` (Techniques and materials). Default: `anywhere`.
- Sort by (`sort`, text): The order of the results. Best match comes first by default. One of: `relevance` (Best match), `production_date` (Date made), `acquired` (Date acquired by SMK), `added` (Date added to SMK's online collection), `changed` (Date the record last changed), `object_number` (Object number). Default: `relevance`.
- Order (`sort_order`, text): Newest or highest first, or oldest or lowest first. One of: `desc` (Descending (newest or highest first)), `asc` (Ascending (oldest or lowest first)). Default: `desc`.
- Language (`language`, text): The language of titles, object types and techniques, and of the words searched for. SMK has English titles for its best-known works; the rest stay in Danish. The dropdowns' values are English, so with Danish, type Danish words (maleri for painting). One of: `en` (English), `da` (Danish). Default: `en`.
- Page (`page`, number): Which page of results to return, from 1. From 1 to 10000. Default: `1`.
- Results per page (`per_page`, number): How many to return on a page, up to 100. From 1 to 100. Default: `20`.

**Outputs**

- `artworks` (list): The artworks on this page.
- `count` (number): How many are on this page.
- `more_available` (true/false): Whether there is a next page.
- `page` (number): This page's number, from 1.
- `per_page` (number): How many a page holds.
- `total` (number): How many match in all.

**Example output**

```json
{
  "artworks": [
    {
      "added": "2024-07-10",
      "artist": "Svend Hammersh\u00f8i",
      "artist_id": "647_person",
      "artists": [
        "Svend Hammersh\u00f8i"
      ],
      "copyright": null,
      "date": "1902-1903",
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KMS9216",
      "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi96azUxdm44NWJfa21zOTIxNi50aWYuanAyL2Z1bGwvZnVsbC8wL25hdGl2ZS5qcGciLCJwdWJsaWNfZG9tYWluIjp0cnVlLCJvYmplY3RfbnVtYmVyIjoiS01TOTIxNiIsIm51bSI6IiJ9XQ==/KMS9...",
      "image_height": 6591,
      "image_iiif_id": "https://iip.smk.dk/iiif/jp2/zk51vn85b_kms9216.tif.jp2",
      "image_iiif_info": "https://iip.smk.dk/iiif/jp2/zk51vn85b_kms9216.tif.jp2/info.json",
      "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/zk51vn85b_kms9216.tif.jp2/full/!1024,/0/default.jpg",
      "image_width": 8012,
      "last_changed": "2026-10-06",
      "licence": "Public domain",
      "materials": [
        "canvas"
      ],
      "object_number": "KMS9216",
      "object_type": "Painting",
      "on_display": false,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": null,
      "techniques": [
        "Oil on canvas"
      ],
      "title": "Landskab",
      "url": "https://open.smk.dk/artwork/image/KMS9216",
      "year_from": 1902,
      "year_to": 1903
    },
    {
      "added": "2020-03-21",
      "artist": "Vilhelm Hammersh\u00f8i",
      "artist_id": "180_person",
      "artists": [
        "Vilhelm Hammersh\u00f8i"
      ],
      "copyright": null,
      "date": "1890",
      "has_image": true,
      "iiif_manifest": "https://api.smk.dk/api/v1/iiif/manifest?id=KMS6692",
      "image_download": "https://api.smk.dk/api/v1/download/W3siaW1nX3VybCI6Imh0dHBzOi8vaWlwLnNtay5kay9paWlmL2pwMi8yajYyczc4OXdfS01TNjY5Mi50aWYucmVjb25zdHJ1Y3RlZC50aWYuanAyL2Z1bGwvZnVsbC8wL25hdGl2ZS5qcGciLCJwdWJsaWNfZG9tYWluIjp0cnVlLCJvYmplY3RfbnVtYmVyIjoiS01TNjY5M...",
      "image_height": 3764,
      "image_iiif_id": "https://iip.smk.dk/iiif/jp2/2j62s789w_KMS6692.tif.reconstructed.tif.jp2",
      "image_iiif_info": "https://iip.smk.dk/iiif/jp2/2j62s789w_KMS6692.tif.reconstructed.tif.jp2/info.json",
      "image_thumbnail": "https://iip-thumb.smk.dk/iiif/jp2/2j62s789w_KMS6692.tif.reconstructed.tif.jp2/full/!1024,/0/default.jpg",
      "image_width": 2808,
      "last_changed": "2026-07-29",
      "licence": "Public domain",
      "materials": [
        "canvas"
      ],
      "object_number": "KMS6692",
      "object_type": "Painting",
      "on_display": false,
      "public_domain": true,
      "rights_url": "https://creativecommons.org/publicdomain/mark/1.0/",
      "room": null,
      "techniques": [
        "Oil on canvas"
      ],
      "title": "Self-Portrait",
      "url": "https://open.smk.dk/artwork/image/KMS6692",
      "year_from": 1890,
      "year_to": 1890
    }
  ],
  "count": 2,
  "more_available": true,
  "page": 1,
  "per_page": 2,
  "total": 52
}
```
