A documentação para programadores está em inglês.
Tipo de cartão
artwork.search
Artworks for a subject, an artist or constraints (type, medium, period, museum, shape), each with its museum, and filters that say how many artworks each option leaves. Public-domain museums only (The Met, the Rijksmuseum), so every image may be shown.
Version 1 · schema artwork.search.v1.schema.json
Layouts
Every card type has full. Pick a layout with the element's layout attribute, render.layout, or a theme.
Fields
The fields of card.data. Values a source doesn't provide are null; new optional fields can appear within version 1.
| Field | Type | Required | Notes |
|---|---|---|---|
query | string | yes | What was searched for, in English, without the words the filters took ("ships at sea"). Empty when only filters were asked for. |
filters | object | yes | Types, mediums and museums: any of the chosen (or). Period and shape: one each. All of them together (and). |
filters.types[] | string[] | yes | Types (painting, drawing, print, photograph, …), any of them. |
filters.mediums[] | string[] | yes | Materials and techniques (oil_paint, watercolor, ink, …), any of them. |
filters.museums[] | enum[] | yes | Museums, any of them. |
filters.period | object | yes | Made from min to max (years, negative before the common era; either may be null). Artworks without a year are left out while either is set. |
filters.period.min | integer | null | yes | |
filters.period.max | integer | null | yes | |
filters.shape | enum | yes | landscape: clearly wider than tall; portrait: clearly taller; square: about as wide as tall. · landscape · portrait · square |
sort | enum | yes | match: best match first; oldest, newest: by year, artworks without a year last. match · oldest · newest |
total | integer | yes | How many artworks match, of which results holds the first limit. |
capped | boolean | yes | true when the search looked only at the 1,000 most relevant artworks of the index (or a sample of it, for a search without words): total and the counts are over those of them that pass the filters, and more may match (show the total with a "+"). |
limit | integer | yes | How many results were asked for: 24, or more after a refine asked for more. |
results[] | object[] | yes | |
results[].id | integer | yes | The art index's id for the artwork. |
results[].title | string | yes | As the museum gives it (the Rijksmuseum's prints and drawings are often titled in Dutch). |
results[].image | image | null | yes | The work's image, with its width and height when known. Show it whole where you can (the WebKnox renderer crops only in its overlay tile). |
results[].image.url | url | yes | WebKnox media URL: https://webknox.com/media/v1/<host>/<path>. Treat it as opaque. |
results[].image.width | integer | null | ||
results[].image.height | integer | null | ||
results[].image.credit | string | yes | |
results[].image.license | string | yes | |
results[].image.source_url | url | yes | |
results[].artist | string | null | yes | |
results[].year | integer | null | yes | When it was made (the end of its dating). |
results[].types[] | string[] | yes | |
results[].mediums[] | string[] | yes | |
results[].museum | string | yes | |
results[].url | url | null | yes | The work's page at the museum, or its Wikidata item when the museum's page is not known. |
facets | object | yes | For every option: how many artworks there would be with it alone chosen in its section and every other section's filters as they are. Types and mediums: the most common ones among the artworks, most first, the chosen ones always included. |
facets.types[] | object[] | yes | By type. |
facets.types[].value | string | yes | A value of the art index: painting, oil_paint, watercolor. |
facets.types[].label | string | yes | |
facets.types[].count | integer | yes | |
facets.mediums[] | object[] | yes | By medium. |
facets.mediums[].value | string | yes | A value of the art index: painting, oil_paint, watercolor. |
facets.mediums[].label | string | yes | |
facets.mediums[].count | integer | yes | |
facets.museums[] | object[] | yes | By museum. |
facets.museums[].value | string | yes | A value of the art index: painting, oil_paint, watercolor. |
facets.museums[].label | string | yes | |
facets.museums[].count | integer | yes | |
facets.period | null | object | yes | |
facets.period.min | integer | yes | |
facets.period.max | integer | yes | |
facets.period.bins[] | integer[] | yes | |
facets.shape | object | yes | By shape. |
facets.shape.landscape | integer | ||
facets.shape.portrait | integer | ||
facets.shape.square | integer | ||
relax[] | object[] | yes | Only when nothing matches: applied filters that, dropped alone, bring artworks back, with how many. Empty otherwise. |
relax[].filter | object | yes | One applied filter: a type, medium or museum with its value, or the period or shape (value null). |
relax[].filter.kind | enum | yes | type · medium · museum · period · shape |
relax[].filter.value | string | null | yes | |
relax[].count | integer | yes | |
credit | string | yes | Where the artworks and images come from ("Artworks and images: Rijksmuseum, public domain"). Show it with the results. |
Example
A recorded answer to “Show me artworks of ships at sea”. Open it in the Answer Lab to see every layout and style.
{
"v": 2,
"id": "ans_4xar2or4qqwgdxwc",
"matched": true,
"locale": "en",
"skill": "artwork_search",
"confidence": 0.9,
"text": "23 artworks for ships at sea. The best matches: Ship at Sea (Albert Ernest Markes, 1901); Ships in a Turbulent Sea (Johannes Christiaan Schotel, 1826); Ship (from McGuire Scrapbook) (Edmund C. Coates, 1839); Oorlogsschip met volle zeilen bij een kust (anonymous, 1625); Ships and Sailors (Thomas Rowlandson, 1827).",
"speech": "I found 23 artworks for ships at sea. The first is Ship at Sea by Albert Ernest Markes, from 1901.",
"card": {
"type": "artwork.search",
"version": 1,
"data": {
"query": "ships at sea",
"filters": {
"types": [],
"mediums": [],
"museums": [],
"period": {
"min": null,
"max": null
},
"shape": null
},
"sort": "match",
"total": 23,
"capped": false,
"limit": 24,
"results": [
{
"id": 26194594,
"title": "Ship at Sea",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/ship_at_sea_albert_ernest_markes_1901.webp",
"width": 3628,
"height": 2274,
"credit": "The Met",
"license": "Public domain",
"source_url": "https://www.metmuseum.org/art/collection/search/340838"
},
"artist": "Albert Ernest Markes",
"year": 1901,
"types": [
"Drawing"
],
"mediums": [],
"museum": "The Met",
"url": "https://www.metmuseum.org/art/collection/search/340838"
},
{
"id": 26241454,
"title": "Ships in a Turbulent Sea",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/ships_in_a_turbulent_sea_johannes_christiaan_schotel_1826.webp",
"width": 2884,
"height": 2087,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/SK-A-1131"
},
"artist": "Johannes Christiaan Schotel",
"year": 1826,
"types": [
"Painting"
],
"mediums": [
"Canvas",
"Oil paint",
"Paint"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/SK-A-1131"
},
{
"id": 26509488,
"title": "Ship (from McGuire Scrapbook)",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/ship_from_mcguire_scrapbook_edmund_c_coates_1839.webp",
"width": 1840,
"height": 1800,
"credit": "The Met",
"license": "Public domain",
"source_url": "https://www.metmuseum.org/art/collection/search/10490"
},
"artist": "Edmund C. Coates",
"year": 1839,
"types": [
"Drawing"
],
"mediums": [],
"museum": "The Met",
"url": "https://www.metmuseum.org/art/collection/search/10490"
},
{
"id": 25494886,
"title": "Oorlogsschip met volle zeilen bij een kust",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/oorlogsschip_met_volle_zeilen_bij_een_kust_anonymous902_1625.webp",
"width": 2500,
"height": 1748,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/RP-P-1966-391"
},
"artist": "anonymous",
"year": 1625,
"types": [
"Print"
],
"mediums": [
"Paper",
"Engraving"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/RP-P-1966-391"
},
{
"id": 25590208,
"title": "Ships and Sailors",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/ships_and_sailors_thomas_rowlandson_1827.webp",
"width": 2916,
"height": 1681,
"credit": "The Met",
"license": "Public domain",
"source_url": "https://www.metmuseum.org/art/collection/search/358678"
},
"artist": "Thomas Rowlandson",
"year": 1827,
"types": [
"Drawing"
],
"mediums": [],
"museum": "The Met",
"url": "https://www.metmuseum.org/art/collection/search/358678"
},
{
"id": 26008396,
"title": "Rough Sea with Ships",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/rough_sea_with_ships_ludolf_bakhuysen_1697.webp",
"width": 2500,
"height": 2010,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/SK-A-2315"
},
"artist": "Ludolf Bakhuysen",
"year": 1697,
"types": [
"Painting"
],
"mediums": [
"Canvas",
"Oil paint",
"Paint"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/SK-A-2315"
},
{
"id": 26068504,
"title": "Ship Flag",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/ship_flag_anonymous971_1865.webp",
"width": 3000,
"height": 2369,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/NG-MC-1889-85-2"
},
"artist": "anonymous",
"year": 1865,
"types": [],
"mediums": [
"Cotton",
"Silk",
"Silver",
"Embroidering"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/NG-MC-1889-85-2"
},
{
"id": 26495314,
"title": "Ships off the Coast",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/ships_off_the_coast_jacob_gerritz_loef_1652.webp",
"width": 2500,
"height": 1787,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/SK-A-1383"
},
"artist": "Jacob Gerritz Loef",
"year": 1652,
"types": [
"Painting"
],
"mediums": [
"Oil paint",
"Paint"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/SK-A-1383"
},
{
"id": 27031922,
"title": "Plate 1: seaport with ships, from \"Seascapes\" (Paysages maritimes)",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/plate_1_seaport_with_ships_from_seascapes_paysages_maritimes_stefano_della_bella_1649.webp",
"width": 4000,
"height": 2400,
"credit": "The Met",
"license": "Public domain",
"source_url": "https://www.metmuseum.org/art/collection/search/377305"
},
"artist": "Stefano della Bella",
"year": 1649,
"types": [
"Print"
],
"mediums": [],
"museum": "The Met",
"url": "https://www.metmuseum.org/art/collection/search/377305"
},
{
"id": 26789220,
"title": "A Ship at Sea",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/a_ship_at_sea_ludolf_backhuysen_1708.webp",
"width": 2647,
"height": 3845,
"credit": "The Met",
"license": "Public domain",
"source_url": "https://www.metmuseum.org/art/collection/search/335058"
},
"artist": "Ludolf Backhuysen",
"year": 1708,
"types": [
"Drawing"
],
"mediums": [],
"museum": "The Met",
"url": "https://www.metmuseum.org/art/collection/search/335058"
},
{
"id": 25651550,
"title": "Matrozen poseren op het dek van een schip",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/matrozen_poseren_op_het_dek_van_een_schip_anonymous798_1920.webp",
"width": 2500,
"height": 1280,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/RP-F-F10427"
},
"artist": "anonymous",
"year": 1920,
"types": [
"Print",
"Stereograph"
],
"mediums": [
"Cardboard",
"Paper"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/RP-F-F10427"
},
{
"id": 25451366,
"title": "Schepen op zee",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/schepen_op_zee_joost_van_geel_1666.webp",
"width": 2500,
"height": 1270,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/RP-P-1885-A-9467"
},
"artist": "Joost van Geel",
"year": 1666,
"types": [
"Print"
],
"mediums": [
"Paper",
"Engraving",
"Etching"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/RP-P-1885-A-9467"
},
{
"id": 25152120,
"title": "Een schip op volle zee",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/een_schip_op_volle_zee_anonymous570_1800.webp",
"width": 3000,
"height": 1902,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/AK-RAK-1991-11-G"
},
"artist": "anonymous",
"year": 1800,
"types": [],
"mediums": [
"Ink",
"Paper"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/AK-RAK-1991-11-G"
},
{
"id": 26540186,
"title": "Plate 1: soldiers waiting to board a ship, from 'Various Embarkations' (Divers embarquements)",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/plate_1_soldiers_waiting_to_board_a_ship_from_various_embarkations_divers_embarquements_stefano_della_bella_1652.webp",
"width": 4000,
"height": 1940,
"credit": "The Met",
"license": "Public domain",
"source_url": "https://www.metmuseum.org/art/collection/search/377750"
},
"artist": "Stefano della Bella",
"year": 1652,
"types": [
"Print"
],
"mediums": [],
"museum": "The Met",
"url": "https://www.metmuseum.org/art/collection/search/377750"
},
{
"id": 26828322,
"title": "Schepen op een woelige zee",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/schepen_op_een_woelige_zee_johannes_christiaan_schotel_1838.webp",
"width": 2500,
"height": 1781,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/RP-T-1889-A-2010"
},
"artist": "Johannes Christiaan Schotel",
"year": 1838,
"types": [
"Drawing"
],
"mediums": [
"Brush",
"Chalk",
"Paper"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/RP-T-1889-A-2010"
},
{
"id": 26648834,
"title": "Schepen op zee",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/schepen_op_zee_hendrik_numan_1788.webp",
"width": 2500,
"height": 1854,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/RP-P-OB-30.176"
},
"artist": "Hendrik Numan",
"year": 1788,
"types": [
"Print"
],
"mediums": [
"Paper"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/RP-P-OB-30.176"
},
{
"id": 25842966,
"title": "Ships at Anchor on a Quiet Sea",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/ships_at_anchor_on_a_quiet_sea_jan_van_de_cappelle_1679.webp",
"width": 2930,
"height": 2261,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/SK-A-4042"
},
"artist": "Jan van de Cappelle",
"year": 1679,
"types": [
"Painting"
],
"mediums": [
"Canvas",
"Oil paint",
"Paint"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/SK-A-4042"
},
{
"id": 26268276,
"title": "Verschillende schepen op zee, ca. 1550",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/verschillende_schepen_op_zee_ca_1550_frans_huys_1562.webp",
"width": 3960,
"height": 2867,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/RP-P-1997-159"
},
"artist": "Frans Huys",
"year": 1562,
"types": [
"Print"
],
"mediums": [
"Paper",
"Engraving",
"Etching"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/RP-P-1997-159"
},
{
"id": 25219510,
"title": "An ordinary ship travelling between Douvre and Calais (Naviere ordinaire qui passe de Douvre a Calais), ship in the sea at center, other boats to left and right, a ship to left in the background, from 'Views of seaports' (Vues de ports de mar)",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/an_ordinary_ship_travelling_between_douvre_and_calais_naviere_ordinaire_qui_passe_de_douvre_a_calais_ship_in_the_sea_at_center_other_boats_to_left_and_right_a_ship_to_left.webp",
"width": 3420,
"height": 2179,
"credit": "The Met",
"license": "Public domain",
"source_url": "https://www.metmuseum.org/art/collection/search/413350"
},
"artist": "Stefano della Bella",
"year": 1647,
"types": [
"Print"
],
"mediums": [],
"museum": "The Met",
"url": "https://www.metmuseum.org/art/collection/search/413350"
},
{
"id": 25729258,
"title": "Ships off a Coast",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/ships_off_a_coast_adam_willaerts_1628.webp",
"width": 2500,
"height": 1333,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/SK-A-1430"
},
"artist": "Adam Willaerts",
"year": 1628,
"types": [
"Painting"
],
"mediums": [
"Oil paint",
"Paint"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/SK-A-1430"
},
{
"id": 25273022,
"title": "Sea Stores",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/sea_stores_thomas_rowlandson_1812.webp",
"width": 2622,
"height": 3659,
"credit": "The Met",
"license": "Public domain",
"source_url": "https://www.wikidata.org/wiki/Q97853105"
},
"artist": "Thomas Rowlandson",
"year": 1812,
"types": [
"Print"
],
"mediums": [],
"museum": "The Met",
"url": "https://www.wikidata.org/wiki/Q97853105"
},
{
"id": 26402462,
"title": "At Sea – Signalling a Passing Steamer – Drawn by Winslow Homer (Every Saturday, Vol. II, New Series)",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/at_sea_signalling_a_passing_steamer_drawn_by_winslow_homer_every_saturday_vol_ii_new_series_winslow_homer_1871.webp",
"width": 3188,
"height": 2486,
"credit": "The Met",
"license": "Public domain",
"source_url": "https://www.metmuseum.org/art/collection/search/369663"
},
"artist": "Winslow Homer",
"year": 1871,
"types": [
"Print"
],
"mediums": [],
"museum": "The Met",
"url": "https://www.metmuseum.org/art/collection/search/369663"
},
{
"id": 25472994,
"title": "Koopvaardijschip op zee, ca. 1600",
"image": {
"url": "https://webknox.com/media/v1/img.artsearch.io/artworks/koopvaardijschip_op_zee_ca_1600_anonymous869_1649.webp",
"width": 2628,
"height": 2007,
"credit": "Rijksmuseum",
"license": "Public domain",
"source_url": "https://www.rijksmuseum.nl/en/collection/RP-P-OB-80.496"
},
"artist": "anonymous",
"year": 1649,
"types": [
"Print"
],
"mediums": [
"Paper",
"Engraving"
],
"museum": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl/en/collection/RP-P-OB-80.496"
}
],
"facets": {
"types": [
{
"value": "print",
"label": "Print",
"count": 11
},
{
"value": "drawing",
"label": "Drawing",
"count": 5
},
{
"value": "painting",
"label": "Painting",
"count": 5
},
{
"value": "stereograph",
"label": "Stereograph",
"count": 1
}
],
"mediums": [
{
"value": "paper",
"label": "Paper",
"count": 8
},
{
"value": "oil_paint",
"label": "Oil paint",
"count": 5
},
{
"value": "paint",
"label": "Paint",
"count": 5
},
{
"value": "engraving",
"label": "Engraving",
"count": 4
},
{
"value": "canvas",
"label": "Canvas",
"count": 3
},
{
"value": "etching",
"label": "Etching",
"count": 2
},
{
"value": "brush",
"label": "Brush",
"count": 1
},
{
"value": "cardboard",
"label": "Cardboard",
"count": 1
},
{
"value": "chalk",
"label": "Chalk",
"count": 1
},
{
"value": "cotton",
"label": "Cotton",
"count": 1
},
{
"value": "embroidering",
"label": "Embroidering",
"count": 1
},
{
"value": "ink",
"label": "Ink",
"count": 1
},
{
"value": "silk",
"label": "Silk",
"count": 1
},
{
"value": "silver",
"label": "Silver",
"count": 1
}
],
"museums": [
{
"value": "met",
"label": "The Met",
"count": 9
},
{
"value": "rijksmuseum",
"label": "Rijksmuseum",
"count": 14
}
],
"period": {
"min": 1562,
"max": 1920,
"bins": [
1,
0,
2,
5,
2,
2,
0,
0,
1,
2,
4,
1,
1,
2
]
},
"shape": {
"landscape": 20,
"portrait": 2,
"square": 1
}
},
"relax": [],
"credit": "Artworks and images: The Met and Rijksmuseum, public domain"
}
},
"sources": [
{
"name": "The Met",
"url": "https://www.metmuseum.org",
"license": "Public domain"
},
{
"name": "Rijksmuseum",
"url": "https://www.rijksmuseum.nl",
"license": "Public domain"
}
],
"follow_ups": [],
"actions": [],
"usage": {
"billable": true
}
}