`gallery`

Licensed images with credits.

Version 1 · schema gallery.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
`items[]`	`object[]`	yes
`items[].title`	`string`	yes
`items[].url`	`url`	yes	WebKnox media URL: https://webknox.com/media/v1/<host>/<path>. Treat it as opaque.
`items[].width`	`integer \| null`
`items[].height`	`integer \| null`
`items[].credit`	`string`	yes
`items[].license`	`string`	yes
`items[].source_url`	`url`	yes

Example

A recorded answer to “Show me pictures of the northern lights”. Open it in the Answer Lab to see every layout and style.

Response

1{
2  "v": 2,
3  "id": "ans_0g2ckbcmj15qlmgn",
4  "matched": true,
5  "locale": "en",
6  "skill": "images",
7  "confidence": 0.9,
8  "text": "Here are some pictures of northern lights.\n039 Northern lights over Mývatn (Iceland) Photo by Giles Laurent (Giles Laurent, CC BY-SA 4.0): https://commons.wikimedia.org/wiki/File:039_Northern_lights_over_M%C3%BDvatn_(Iceland)_Photo_by_Giles_Laurent.jpg\nMaardu Northern lights — Estonia, 2022 (Maxim Bilovitskiy, CC BY 4.0): https://commons.wikimedia.org/wiki/File:Maardu_Northern_lights_%E2%80%94_Estonia,_2022.jpg\nAurora borealis over Eielson Air Force Base, Alaska (United States Air Force photo by Senior Airman Joshua Strang, Public domain): https://commons.wikimedia.org/wiki/File:Aurora_borealis_over_Eielson_Air_Force_Base,_Alaska.jpg\nAurora australis dancing over an LED illuminated igloo (Ross Burgener, Public domain): https://commons.wikimedia.org/wiki/File:Aurora_australis_dancing_over_an_LED_illuminated_igloo.jpg\nAurora and perseids (Stephan Sprinz, CC BY 4.0): https://commons.wikimedia.org/wiki/File:Aurora_and_perseids.jpg\nMulticolored aurora borealis pillar over Brastad (W.carter, CC BY-SA 4.0): https://commons.wikimedia.org/wiki/File:Multicolored_aurora_borealis_pillar_over_Brastad.jpg",
9  "speech": "Here are some pictures of northern lights.",
10  "card": {
11    "type": "gallery",
12    "version": 1,
13    "data": {
14      "query": "northern lights",
15      "items": [
16        {
17          "title": "039 Northern lights over Mývatn (Iceland) Photo by Giles Laurent",
18          "url": "https://webknox.com/media/v1/thumb.wikimedia.org/wikipedia/commons/thumb/9/99/039_Northern_lights_over_M%C3%BDvatn_%28Iceland%29_Photo_by_Giles_Laurent.jpg/960px-039_Northern_lights_over_M%C3%BDvatn_%28Iceland%29_Photo_by_Giles_Laurent.jpg",
19          "width": 960,
20          "height": 640,
21          "credit": "Giles Laurent",
22          "license": "CC BY-SA 4.0",
23          "source_url": "https://commons.wikimedia.org/wiki/File:039_Northern_lights_over_M%C3%BDvatn_(Iceland)_Photo_by_Giles_Laurent.jpg"
24        },
25        {
26          "title": "Maardu Northern lights — Estonia, 2022",
27          "url": "https://webknox.com/media/v1/thumb.wikimedia.org/wikipedia/commons/thumb/e/e7/Maardu_Northern_lights_%E2%80%94_Estonia%2C_2022.jpg/960px-Maardu_Northern_lights_%E2%80%94_Estonia%2C_2022.jpg",
28          "width": 960,
29          "height": 434,
30          "credit": "Maxim Bilovitskiy",
31          "license": "CC BY 4.0",
32          "source_url": "https://commons.wikimedia.org/wiki/File:Maardu_Northern_lights_%E2%80%94_Estonia,_2022.jpg"
33        },
34        {
35          "title": "Aurora borealis over Eielson Air Force Base, Alaska",
36          "url": "https://webknox.com/media/v1/thumb.wikimedia.org/wikipedia/commons/thumb/d/d3/Aurora_borealis_over_Eielson_Air_Force_Base%2C_Alaska.jpg/960px-Aurora_borealis_over_Eielson_Air_Force_Base%2C_Alaska.jpg",
37          "width": 960,
38          "height": 626,
39          "credit": "United States Air Force photo by Senior Airman Joshua Strang",
40          "license": "Public domain",
41          "source_url": "https://commons.wikimedia.org/wiki/File:Aurora_borealis_over_Eielson_Air_Force_Base,_Alaska.jpg"
42        },
43        {
44          "title": "Aurora australis dancing over an LED illuminated igloo",
45          "url": "https://webknox.com/media/v1/thumb.wikimedia.org/wikipedia/commons/thumb/4/40/Aurora_australis_dancing_over_an_LED_illuminated_igloo.jpg/960px-Aurora_australis_dancing_over_an_LED_illuminated_igloo.jpg",
46          "width": 960,
47          "height": 636,
48          "credit": "Ross Burgener",
49          "license": "Public domain",
50          "source_url": "https://commons.wikimedia.org/wiki/File:Aurora_australis_dancing_over_an_LED_illuminated_igloo.jpg"
51        },
52        {
53          "title": "Aurora and perseids",
54          "url": "https://webknox.com/media/v1/thumb.wikimedia.org/wikipedia/commons/thumb/3/31/Aurora_and_perseids.jpg/960px-Aurora_and_perseids.jpg",
55          "width": 960,
56          "height": 639,
57          "credit": "Stephan Sprinz",
58          "license": "CC BY 4.0",
59          "source_url": "https://commons.wikimedia.org/wiki/File:Aurora_and_perseids.jpg"
60        },
61        {
62          "title": "Multicolored aurora borealis pillar over Brastad",
63          "url": "https://webknox.com/media/v1/thumb.wikimedia.org/wikipedia/commons/thumb/2/23/Multicolored_aurora_borealis_pillar_over_Brastad.jpg/960px-Multicolored_aurora_borealis_pillar_over_Brastad.jpg",
64          "width": 960,
65          "height": 1440,
66          "credit": "W.carter",
67          "license": "CC BY-SA 4.0",
68          "source_url": "https://commons.wikimedia.org/wiki/File:Multicolored_aurora_borealis_pillar_over_Brastad.jpg"
69        },
70        {
71          "title": "Aurora in Abisko near Torneträsk",
72          "url": "https://webknox.com/media/v1/thumb.wikimedia.org/wikipedia/commons/thumb/a/a6/Aurora_in_Abisko_near_Tornetr%C3%A4sk.jpg/960px-Aurora_in_Abisko_near_Tornetr%C3%A4sk.jpg",
73          "width": 960,
74          "height": 640,
75          "credit": "Pavel.shyshkouski",
76          "license": "CC BY-SA 4.0",
77          "source_url": "https://commons.wikimedia.org/wiki/File:Aurora_in_Abisko_near_Tornetr%C3%A4sk.jpg"
78        },
79        {
80          "title": "Faint aurora, a meteorite and some clouds over Tuntorp",
81          "url": "https://webknox.com/media/v1/thumb.wikimedia.org/wikipedia/commons/thumb/d/df/Faint_aurora%2C_a_meteorite_and_some_clouds_over_Tuntorp.jpg/960px-Faint_aurora%2C_a_meteorite_and_some_clouds_over_Tuntorp.jpg",
82          "width": 960,
83          "height": 609,
84          "credit": "W.carter",
85          "license": "CC BY-SA 4.0",
86          "source_url": "https://commons.wikimedia.org/wiki/File:Faint_aurora,_a_meteorite_and_some_clouds_over_Tuntorp.jpg"
87        }
88      ]
89    }
90  },
91  "sources": [
92    {
93      "name": "Wikimedia Commons",
94      "url": "https://commons.wikimedia.org",
95      "license": "per image"
96    }
97  ],
98  "follow_ups": [],
99  "actions": [],
100  "usage": {
101    "billable": true
102  }
103}