Results¶
These parameters affect how the results from your query (searching or filtering) are returned.
Response Format¶
This affects the format of the data returned to you from a search or filter query. By default a JSON response is returned. However for some uses (especially involving common data science tools), a (reduced) CSV response can be quicker to start exploring the data with, so this can be requested instead.
Comma Seperated Values (CSV) Format¶
CSV responses only contain the following fields:
accessionNumber - The accession number assigned to the museum object once it enters the collection
accessionYear - The year the museum object was accessioned to the collection
systemNumber - The number assigned to the object record by our collection management system
objectType - The type of object
_primaryTitle - The first title assigned to the object (there could be more than one)
_primaryPlace - The first place assigned to the object’s production (there could be more than one)
_primaryMaker__name - The name of the first artist/maker assigned to the object’s production (there could be more than one artist/maker)
_primaryMaker__association - The association between the above artist/maker and the object’s production
_primaryDate - The first production data assigned to the object (there could be more than one date)
_primaryImageId - The first image identifier assigned to the object (see Images) (there could be more than one image)
_currentLocation__textid - The combined controlled identifier and name refering to the gallery location the object is in
_sampleMaterial - One of the materials specified in the object record
_sampleTechnique - One of the techniques specified in the object record
_sampleStyle - One of the styles specified in the object record
_currentLocation__displayName - The name referring to the gallery location the object is on display in (if on display)
_objectContentWarning - Does the object record contain potentially offensive content
_imageContentWarning - Do images of the object depict something potentially offensive or troubling
This is the reduced form of the data available, the fields with a leading _ are constructed by us from the data for ease of use in a CSV format that cannot handle possibly repeating fields. Primary indicates it is considered the most important of the group, Sample indicates all in the group are equally important (so we have picked one at random).
import pandas as pd
object_df = pd.read_csv("https://api.vam.ac.uk/v2/objects/search?q=Derby&page_size=10&response_format=csv")
object_df.sample(5)
accessionNumber | accessionYear | systemNumber | objectType | _primaryTitle | _primaryPlace | _primaryMaker__name | _primaryMaker__association | _primaryDate | _primaryImageId | _sampleMaterial | _sampleTechnique | _sampleStyle | _currentLocation__displayName | _objectContentWarning | _imageContentWarning | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
3 | C.311-2009 | 2009 | O1173325 | Vase | Eastman Imari Vase No.2 | Derby | Eastman, Ken | designer | 2009 | 2009CR0611 | bone china | NaN | NaN | Ceramics, Room 140, Factory Ceramics | False | False |
2 | C.316-2009 | 2009 | O1173330 | Vase | EastmanSnow Leopard Vase No.1 | Derby | Eastman, Ken | designer | 2009 | 2010EH9819 | bone china | NaN | NaN | In store | False | False |
5 | C.318-2009 | 2009 | O1173332 | Vase | Eastman Gold Aves Vase No.7 | Derby | Eastman, Ken | designer | 2009 | 2010EH9821 | bone china | NaN | NaN | In store | False | False |
4 | C.319-2009 | 2009 | O1173333 | Vase | Eastman Gold Aves Vase No.8 | Derby | Eastman, Ken | designer | 2009 | 2010EH9814 | bone china | NaN | NaN | In store | False | False |
8 | C.314-2009 | 2009 | O1173328 | Vase | Eastman Gold Aves Vase No.5 | Derby | Eastman, Ken | designer | 2009 | 2009CR0621 | bone china | NaN | NaN | In store | False | False |
JSON Format¶
import requests
import json
req = requests.get('https://api.vam.ac.uk/v2/objects/search?q="macbeth"')
obj_data = req.json()
obj_info = obj_data["info"]
obj_records = obj_data["records"]
print(json.dumps(obj_info))
{"version": "2.0", "record_count": 668, "record_count_exact": true, "parameters": {}, "page_size": 15, "pages": 45, "page": 1, "image_count": 739}
The records output is quite lengthy, you can click below to reveal it.
print(json.dumps(obj_records, indent=2))
[
{
"systemNumber": "O332022",
"accessionNumber": "T.662-1996",
"objectType": "Jacket",
"_currentLocation": {
"id": "THES50141",
"displayName": "In store",
"type": "storage",
"site": "BH",
"onDisplay": false
},
"_primaryTitle": "",
"_primaryMaker": {
"name": "Macbeths",
"association": "retailer"
},
"_primaryImageId": "2012FJ7350",
"_primaryDate": "1930",
"_primaryPlace": "Great Britain",
"_warningTypes": [],
"_images": {
"_primary_thumbnail": "https://framemark.vam.ac.uk/collections/2012FJ7350/full/!100,100/0/default.jpg",
"_iiif_image_base_url": "https://framemark.vam.ac.uk/collections/2012FJ7350/",
"_iiif_presentation_url": null,
"imageResolution": "low"
}
},
{
"systemNumber": "O726926",
"accessionNumber": "E.38-1943",
"objectType": "Costume design",
"_currentLocation": {
"id": "THES291648",
"displayName": "in storage",
"type": "storage",
"site": "VA",
"onDisplay": false
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "Michael Ayrton",
"association": "artist"
},
"_primaryImageId": null,
"_primaryDate": "1941-early 1942",
"_primaryPlace": "London",
"_warningTypes": [],
"_images": {}
},
{
"systemNumber": "O726924",
"accessionNumber": "E.40-1943",
"objectType": "Costume design",
"_currentLocation": {
"id": "THES291648",
"displayName": "in storage",
"type": "storage",
"site": "VA",
"onDisplay": false
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "Michael Ayrton",
"association": "artist"
},
"_primaryImageId": null,
"_primaryDate": "1941-early 1942",
"_primaryPlace": "London",
"_warningTypes": [],
"_images": {}
},
{
"systemNumber": "O726922",
"accessionNumber": "E.42-1943",
"objectType": "Costume design",
"_currentLocation": {
"id": "THES291648",
"displayName": "in storage",
"type": "storage",
"site": "VA",
"onDisplay": false
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "Michael Ayrton",
"association": "artist"
},
"_primaryImageId": null,
"_primaryDate": "1941-early 1942",
"_primaryPlace": "London",
"_warningTypes": [],
"_images": {}
},
{
"systemNumber": "O726912",
"accessionNumber": "E.52-1943",
"objectType": "Design for a stage set",
"_currentLocation": {
"id": "THES291648",
"displayName": "in storage",
"type": "storage",
"site": "VA",
"onDisplay": false
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "Michael Ayrton",
"association": "artist"
},
"_primaryImageId": "2018KV2981",
"_primaryDate": "1941-early 1942",
"_primaryPlace": "London",
"_warningTypes": [],
"_images": {
"_primary_thumbnail": "https://framemark.vam.ac.uk/collections/2018KV2981/full/!100,100/0/default.jpg",
"_iiif_image_base_url": "https://framemark.vam.ac.uk/collections/2018KV2981/",
"_iiif_presentation_url": null,
"imageResolution": "low"
}
},
{
"systemNumber": "O726910",
"accessionNumber": "E.54-1943",
"objectType": "Design",
"_currentLocation": {
"id": "THES49657",
"displayName": "Prints & Drawings Study Room, level E",
"type": "display",
"site": "VA",
"onDisplay": true
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "Michael Ayrton",
"association": "artist"
},
"_primaryImageId": "2018KV2981",
"_primaryDate": "1941-early 1942",
"_primaryPlace": "London",
"_warningTypes": [],
"_images": {
"_primary_thumbnail": "https://framemark.vam.ac.uk/collections/2018KV2981/full/!100,100/0/default.jpg",
"_iiif_image_base_url": "https://framemark.vam.ac.uk/collections/2018KV2981/",
"_iiif_presentation_url": null,
"imageResolution": "low"
}
},
{
"systemNumber": "O1093415",
"accessionNumber": "CIRC.69-1954",
"objectType": "design",
"_currentLocation": {
"id": "THES49144",
"displayName": "WID Framing Workshop, Level C",
"type": "storage",
"site": "VA",
"onDisplay": false
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "Michael Ayrton",
"association": "artist"
},
"_primaryImageId": "2006AT8074",
"_primaryDate": "1941-early 1942",
"_primaryPlace": "London",
"_warningTypes": [],
"_images": {
"_primary_thumbnail": "https://framemark.vam.ac.uk/collections/2006AT8074/full/!100,100/0/default.jpg",
"_iiif_image_base_url": "https://framemark.vam.ac.uk/collections/2006AT8074/",
"_iiif_presentation_url": null,
"imageResolution": "low"
}
},
{
"systemNumber": "O726909",
"accessionNumber": "E.55-1943",
"objectType": "design",
"_currentLocation": {
"id": "THES49144",
"displayName": "WID Framing Workshop, Level C",
"type": "storage",
"site": "VA",
"onDisplay": false
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "Michael Ayrton",
"association": "artist"
},
"_primaryImageId": "2006AT8072",
"_primaryDate": "1941-early 1942",
"_primaryPlace": "London",
"_warningTypes": [],
"_images": {
"_primary_thumbnail": "https://framemark.vam.ac.uk/collections/2006AT8072/full/!100,100/0/default.jpg",
"_iiif_image_base_url": "https://framemark.vam.ac.uk/collections/2006AT8072/",
"_iiif_presentation_url": null,
"imageResolution": "low"
}
},
{
"systemNumber": "O1094238",
"accessionNumber": "E.349-1912",
"objectType": "Wood block",
"_currentLocation": {
"id": "THES49773",
"displayName": "Prints & Drawings Study Room, room 514a",
"type": "display",
"site": "VA",
"onDisplay": true
},
"_primaryTitle": "",
"_primaryMaker": {
"name": "Macbeth",
"association": "artist"
},
"_primaryImageId": null,
"_primaryDate": "",
"_primaryPlace": "",
"_warningTypes": [],
"_images": {}
},
{
"systemNumber": "O102515",
"accessionNumber": "E.638-2004",
"objectType": "Poster",
"_currentLocation": {
"id": "THES49171",
"displayName": "Prints & Drawings Study Room, level C",
"type": "display",
"site": "VA",
"onDisplay": true
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "Columbia Shakespeare Workshop",
"association": "issued by"
},
"_primaryImageId": null,
"_primaryDate": "1968",
"_primaryPlace": "United States",
"_warningTypes": [],
"_images": {}
},
{
"systemNumber": "O1278360",
"accessionNumber": "S.113-2013",
"objectType": "Drawing",
"_currentLocation": {
"id": "THES49576",
"displayName": "In store",
"type": "storage",
"site": "BH",
"onDisplay": false
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "Keene, Arthur",
"association": "artist"
},
"_primaryImageId": "2017KJ7274",
"_primaryDate": "1967",
"_primaryPlace": "London",
"_warningTypes": [],
"_images": {
"_primary_thumbnail": "https://framemark.vam.ac.uk/collections/2017KJ7274/full/!100,100/0/default.jpg",
"_iiif_image_base_url": "https://framemark.vam.ac.uk/collections/2017KJ7274/",
"_iiif_presentation_url": null,
"imageResolution": "low"
}
},
{
"systemNumber": "O1318896",
"accessionNumber": "S.1336-2015",
"objectType": "Print",
"_currentLocation": {
"id": "THES49576",
"displayName": "In store",
"type": "storage",
"site": "BH",
"onDisplay": false
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "Corbould",
"association": "artist"
},
"_primaryImageId": "2016JC2655",
"_primaryDate": "December 1787",
"_primaryPlace": "Great Britain",
"_warningTypes": [],
"_images": {
"_primary_thumbnail": "https://framemark.vam.ac.uk/collections/2016JC2655/full/!100,100/0/default.jpg",
"_iiif_image_base_url": "https://framemark.vam.ac.uk/collections/2016JC2655/",
"_iiif_presentation_url": "https://iiif.vam.ac.uk/collections/O1318896/manifest.json",
"imageResolution": "high"
}
},
{
"systemNumber": "O1318888",
"accessionNumber": "S.1334-2015",
"objectType": "Print",
"_currentLocation": {
"id": "THES49576",
"displayName": "In store",
"type": "storage",
"site": "BH",
"onDisplay": false
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "Unknown",
"association": "artist"
},
"_primaryImageId": "2016JC2697",
"_primaryDate": "eighteenth century",
"_primaryPlace": "Great Britain",
"_warningTypes": [],
"_images": {
"_primary_thumbnail": "https://framemark.vam.ac.uk/collections/2016JC2697/full/!100,100/0/default.jpg",
"_iiif_image_base_url": "https://framemark.vam.ac.uk/collections/2016JC2697/",
"_iiif_presentation_url": "https://iiif.vam.ac.uk/collections/O1318888/manifest.json",
"imageResolution": "high"
}
},
{
"systemNumber": "O1376465",
"accessionNumber": "S.80-2017",
"objectType": "Print",
"_currentLocation": {
"id": "THES49588",
"displayName": "In store",
"type": "storage",
"site": "BH",
"onDisplay": false
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "The Graphic",
"association": "Publisher"
},
"_primaryImageId": "2017JT7958",
"_primaryDate": "September, 1898",
"_primaryPlace": "London",
"_warningTypes": [],
"_images": {
"_primary_thumbnail": "https://framemark.vam.ac.uk/collections/2017JT7958/full/!100,100/0/default.jpg",
"_iiif_image_base_url": "https://framemark.vam.ac.uk/collections/2017JT7958/",
"_iiif_presentation_url": "https://iiif.vam.ac.uk/collections/O1376465/manifest.json",
"imageResolution": "high"
}
},
{
"systemNumber": "O1376464",
"accessionNumber": "S.79-2017",
"objectType": "Print",
"_currentLocation": {
"id": "THES49588",
"displayName": "In store",
"type": "storage",
"site": "BH",
"onDisplay": false
},
"_primaryTitle": "Macbeth",
"_primaryMaker": {
"name": "The Illustrated London News",
"association": "Publisher"
},
"_primaryImageId": "2017JT7743",
"_primaryDate": "September, 1898",
"_primaryPlace": "London",
"_warningTypes": [],
"_images": {
"_primary_thumbnail": "https://framemark.vam.ac.uk/collections/2017JT7743/full/!100,100/0/default.jpg",
"_iiif_image_base_url": "https://framemark.vam.ac.uk/collections/2017JT7743/",
"_iiif_presentation_url": "https://iiif.vam.ac.uk/collections/O1376464/manifest.json",
"imageResolution": "high"
}
}
]
JSON (prettified) (format)¶
This is the same output as above but indents the JSON response. Useful for debugging JSON in the browser if no JSON viewer support is available
import requests
req = requests.get('https://api.vam.ac.uk/v2/objects/search?q="macbeth"&response_format=prettyjson')
obj_data = req.json()
obj_info = obj_data["info"]
obj_records = obj_data["records"]
obj_records
[{'_primaryTitle': '',
'_primaryImageId': '2012FJ7350',
'_warningTypes': [],
'systemNumber': 'O332022',
'_primaryPlace': 'Great Britain',
'_imagesMeta': [{'assetRef': '2012FJ7350',
'copyright': '©Victoria and Albert Museum, London',
'sensitiveImage': False}],
'_currentLocation': {'textid': 'THES50141 - In store',
'site': 'BH',
'displayName': 'In store',
'onDisplay': False,
'id': 'THES50141',
'type': 'storage'},
'accessionNumber': 'T.662-1996',
'_primaryMaker': {'name': 'Macbeths', 'association': 'retailer'},
'_primaryDate': '1930',
'objectType': 'Jacket',
'_images': {'_primary_thumbnail': 'https://framemark.vam.ac.uk/collections/2012FJ7350/full/!100,100/0/default.jpg',
'_iiif_image_base_url': 'https://framemark.vam.ac.uk/collections/2012FJ7350/',
'_iiif_presentation_url': None,
'imageResolution': 'low'}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': None,
'_warningTypes': [],
'systemNumber': 'O726926',
'_primaryPlace': 'London',
'_imagesMeta': [],
'_currentLocation': {'textid': 'THES291648 - in storage',
'site': 'VA',
'displayName': 'in storage',
'onDisplay': False,
'id': 'THES291648',
'type': 'storage'},
'accessionNumber': 'E.38-1943',
'_primaryMaker': {'name': 'Michael Ayrton', 'association': 'artist'},
'_primaryDate': '1941-early 1942',
'objectType': 'Costume design',
'_images': {}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': None,
'_warningTypes': [],
'systemNumber': 'O726924',
'_primaryPlace': 'London',
'_imagesMeta': [],
'_currentLocation': {'textid': 'THES291648 - in storage',
'site': 'VA',
'displayName': 'in storage',
'onDisplay': False,
'id': 'THES291648',
'type': 'storage'},
'accessionNumber': 'E.40-1943',
'_primaryMaker': {'name': 'Michael Ayrton', 'association': 'artist'},
'_primaryDate': '1941-early 1942',
'objectType': 'Costume design',
'_images': {}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': None,
'_warningTypes': [],
'systemNumber': 'O726922',
'_primaryPlace': 'London',
'_imagesMeta': [],
'_currentLocation': {'textid': 'THES291648 - in storage',
'site': 'VA',
'displayName': 'in storage',
'onDisplay': False,
'id': 'THES291648',
'type': 'storage'},
'accessionNumber': 'E.42-1943',
'_primaryMaker': {'name': 'Michael Ayrton', 'association': 'artist'},
'_primaryDate': '1941-early 1942',
'objectType': 'Costume design',
'_images': {}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': '2018KV2981',
'_warningTypes': [],
'systemNumber': 'O726912',
'_primaryPlace': 'London',
'_imagesMeta': [{'assetRef': '2018KV2981',
'copyright': '(c)Victoria and Albert Museum, London',
'sensitiveImage': False}],
'_currentLocation': {'textid': 'THES291648 - in storage',
'site': 'VA',
'displayName': 'in storage',
'onDisplay': False,
'id': 'THES291648',
'type': 'storage'},
'accessionNumber': 'E.52-1943',
'_primaryMaker': {'name': 'Michael Ayrton', 'association': 'artist'},
'_primaryDate': '1941-early 1942',
'objectType': 'Design for a stage set',
'_images': {'_primary_thumbnail': 'https://framemark.vam.ac.uk/collections/2018KV2981/full/!100,100/0/default.jpg',
'_iiif_image_base_url': 'https://framemark.vam.ac.uk/collections/2018KV2981/',
'_iiif_presentation_url': None,
'imageResolution': 'low'}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': '2018KV2981',
'_warningTypes': [],
'systemNumber': 'O726910',
'_primaryPlace': 'London',
'_imagesMeta': [{'assetRef': '2018KV2981',
'copyright': '(c)Victoria and Albert Museum, London',
'sensitiveImage': False},
{'assetRef': '2006AT8073',
'copyright': '©Victoria & Albert Museum, London',
'sensitiveImage': False}],
'_currentLocation': {'textid': 'THES49657 - Prints & Drawings Study Room, level E',
'site': 'VA',
'displayName': 'Prints & Drawings Study Room, level E',
'onDisplay': True,
'id': 'THES49657',
'type': 'display'},
'accessionNumber': 'E.54-1943',
'_primaryMaker': {'name': 'Michael Ayrton', 'association': 'artist'},
'_primaryDate': '1941-early 1942',
'objectType': 'Design',
'_images': {'_primary_thumbnail': 'https://framemark.vam.ac.uk/collections/2018KV2981/full/!100,100/0/default.jpg',
'_iiif_image_base_url': 'https://framemark.vam.ac.uk/collections/2018KV2981/',
'_iiif_presentation_url': None,
'imageResolution': 'low'}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': '2006AT8074',
'_warningTypes': [],
'systemNumber': 'O1093415',
'_primaryPlace': 'London',
'_imagesMeta': [{'assetRef': '2006AT8074',
'copyright': '©Victoria & Albert Museum, London',
'sensitiveImage': False}],
'_currentLocation': {'textid': 'THES49144 - WID Framing Workshop, Level C',
'site': 'VA',
'displayName': 'WID Framing Workshop, Level C',
'onDisplay': False,
'id': 'THES49144',
'type': 'storage'},
'accessionNumber': 'CIRC.69-1954',
'_primaryMaker': {'name': 'Michael Ayrton', 'association': 'artist'},
'_primaryDate': '1941-early 1942',
'objectType': 'design',
'_images': {'_primary_thumbnail': 'https://framemark.vam.ac.uk/collections/2006AT8074/full/!100,100/0/default.jpg',
'_iiif_image_base_url': 'https://framemark.vam.ac.uk/collections/2006AT8074/',
'_iiif_presentation_url': None,
'imageResolution': 'low'}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': '2006AT8072',
'_warningTypes': [],
'systemNumber': 'O726909',
'_primaryPlace': 'London',
'_imagesMeta': [{'assetRef': '2006AT8072',
'copyright': '©Victoria & Albert Museum, London',
'sensitiveImage': False}],
'_currentLocation': {'textid': 'THES49144 - WID Framing Workshop, Level C',
'site': 'VA',
'displayName': 'WID Framing Workshop, Level C',
'onDisplay': False,
'id': 'THES49144',
'type': 'storage'},
'accessionNumber': 'E.55-1943',
'_primaryMaker': {'name': 'Michael Ayrton', 'association': 'artist'},
'_primaryDate': '1941-early 1942',
'objectType': 'design',
'_images': {'_primary_thumbnail': 'https://framemark.vam.ac.uk/collections/2006AT8072/full/!100,100/0/default.jpg',
'_iiif_image_base_url': 'https://framemark.vam.ac.uk/collections/2006AT8072/',
'_iiif_presentation_url': None,
'imageResolution': 'low'}},
{'_primaryTitle': '',
'_primaryImageId': None,
'_warningTypes': [],
'systemNumber': 'O1094238',
'_primaryPlace': '',
'_imagesMeta': [],
'_currentLocation': {'textid': 'THES49773 - Prints & Drawings Study Room, room 514a',
'site': 'VA',
'displayName': 'Prints & Drawings Study Room, room 514a',
'onDisplay': True,
'id': 'THES49773',
'type': 'display'},
'accessionNumber': 'E.349-1912',
'_primaryMaker': {'name': 'Macbeth', 'association': 'artist'},
'_primaryDate': '',
'objectType': 'Wood block',
'_images': {}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': None,
'_warningTypes': [],
'systemNumber': 'O102515',
'_primaryPlace': 'United States',
'_imagesMeta': [],
'_currentLocation': {'textid': 'THES49171 - Prints & Drawings Study Room, level C',
'site': 'VA',
'displayName': 'Prints & Drawings Study Room, level C',
'onDisplay': True,
'id': 'THES49171',
'type': 'display'},
'accessionNumber': 'E.638-2004',
'_primaryMaker': {'name': 'Columbia Shakespeare Workshop',
'association': 'issued by'},
'_primaryDate': '1968',
'objectType': 'Poster',
'_images': {}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': '2017KJ7274',
'_warningTypes': [],
'systemNumber': 'O1278360',
'_primaryPlace': 'London',
'_imagesMeta': [{'assetRef': '2017KJ7274',
'copyright': '©Victoria & Albert Museum, London',
'sensitiveImage': False}],
'_currentLocation': {'textid': 'THES49576 - In store',
'site': 'BH',
'displayName': 'In store',
'onDisplay': False,
'id': 'THES49576',
'type': 'storage'},
'accessionNumber': 'S.113-2013',
'_primaryMaker': {'name': 'Keene, Arthur', 'association': 'artist'},
'_primaryDate': '1967',
'objectType': 'Drawing',
'_images': {'_primary_thumbnail': 'https://framemark.vam.ac.uk/collections/2017KJ7274/full/!100,100/0/default.jpg',
'_iiif_image_base_url': 'https://framemark.vam.ac.uk/collections/2017KJ7274/',
'_iiif_presentation_url': None,
'imageResolution': 'low'}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': '2016JC2655',
'_warningTypes': [],
'systemNumber': 'O1318896',
'_primaryPlace': 'Great Britain',
'_imagesMeta': [{'assetRef': '2016JC2655',
'copyright': '©Victoria and Albert Museum, London',
'sensitiveImage': False}],
'_currentLocation': {'textid': 'THES49576 - In store',
'site': 'BH',
'displayName': 'In store',
'onDisplay': False,
'id': 'THES49576',
'type': 'storage'},
'accessionNumber': 'S.1336-2015',
'_primaryMaker': {'name': 'Corbould', 'association': 'artist'},
'_primaryDate': 'December 1787',
'objectType': 'Print',
'_images': {'_primary_thumbnail': 'https://framemark.vam.ac.uk/collections/2016JC2655/full/!100,100/0/default.jpg',
'_iiif_image_base_url': 'https://framemark.vam.ac.uk/collections/2016JC2655/',
'_iiif_presentation_url': 'https://iiif.vam.ac.uk/collections/O1318896/manifest.json',
'imageResolution': 'high'}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': '2016JC2697',
'_warningTypes': [],
'systemNumber': 'O1318888',
'_primaryPlace': 'Great Britain',
'_imagesMeta': [{'assetRef': '2016JC2697',
'copyright': '©Victoria and Albert Museum, London',
'sensitiveImage': False}],
'_currentLocation': {'textid': 'THES49576 - In store',
'site': 'BH',
'displayName': 'In store',
'onDisplay': False,
'id': 'THES49576',
'type': 'storage'},
'accessionNumber': 'S.1334-2015',
'_primaryMaker': {'name': 'Unknown', 'association': 'artist'},
'_primaryDate': 'eighteenth century',
'objectType': 'Print',
'_images': {'_primary_thumbnail': 'https://framemark.vam.ac.uk/collections/2016JC2697/full/!100,100/0/default.jpg',
'_iiif_image_base_url': 'https://framemark.vam.ac.uk/collections/2016JC2697/',
'_iiif_presentation_url': 'https://iiif.vam.ac.uk/collections/O1318888/manifest.json',
'imageResolution': 'high'}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': '2017JT7958',
'_warningTypes': [],
'systemNumber': 'O1376465',
'_primaryPlace': 'London',
'_imagesMeta': [{'assetRef': '2017JT7958',
'copyright': '(c)Victoria and Albert Museum, London',
'sensitiveImage': False}],
'_currentLocation': {'textid': 'THES49588 - In store',
'site': 'BH',
'displayName': 'In store',
'onDisplay': False,
'id': 'THES49588',
'type': 'storage'},
'accessionNumber': 'S.80-2017',
'_primaryMaker': {'name': 'The Graphic', 'association': 'Publisher'},
'_primaryDate': 'September, 1898',
'objectType': 'Print',
'_images': {'_primary_thumbnail': 'https://framemark.vam.ac.uk/collections/2017JT7958/full/!100,100/0/default.jpg',
'_iiif_image_base_url': 'https://framemark.vam.ac.uk/collections/2017JT7958/',
'_iiif_presentation_url': 'https://iiif.vam.ac.uk/collections/O1376465/manifest.json',
'imageResolution': 'high'}},
{'_primaryTitle': 'Macbeth',
'_primaryImageId': '2017JT7743',
'_warningTypes': [],
'systemNumber': 'O1376464',
'_primaryPlace': 'London',
'_imagesMeta': [{'assetRef': '2017JT7743',
'copyright': '(c)Victoria and Albert Museum, London',
'sensitiveImage': False}],
'_currentLocation': {'textid': 'THES49588 - In store',
'site': 'BH',
'displayName': 'In store',
'onDisplay': False,
'id': 'THES49588',
'type': 'storage'},
'accessionNumber': 'S.79-2017',
'_primaryMaker': {'name': 'The Illustrated London News',
'association': 'Publisher'},
'_primaryDate': 'September, 1898',
'objectType': 'Print',
'_images': {'_primary_thumbnail': 'https://framemark.vam.ac.uk/collections/2017JT7743/full/!100,100/0/default.jpg',
'_iiif_image_base_url': 'https://framemark.vam.ac.uk/collections/2017JT7743/',
'_iiif_presentation_url': 'https://iiif.vam.ac.uk/collections/O1376464/manifest.json',
'imageResolution': 'high'}}]
Order results by (order_by)¶
This affects the order results are returned, instead of the default ordering of relevancy (please note we boost matches on object titles, object type and person) results. The options available are:
location - The primary location of the object within the museum
artist - The name of the primary artist/maker of the object
place - The placename of the primary place of production of the object
date - The primary date of production of the object
fields_populated - The number of fields within the object record that are not null or empty
import pandas as pd
object_df = pd.read_csv("https://api.vam.ac.uk/v2/objects/search?q=pineapple&page_size=10&response_format=csv&order_by=date")
object_df.head(10)
accessionNumber | accessionYear | systemNumber | objectType | _primaryTitle | _primaryPlace | _primaryMaker__name | _primaryMaker__association | _primaryDate | _primaryImageId | _sampleMaterial | _sampleTechnique | _sampleStyle | _currentLocation__displayName | _objectContentWarning | _imageContentWarning | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | IS.1-2021 | 2021 | O1522050 | Barong | Barong | Philippines | EN Barong Filipino | maker | 2018 | NaN | pineapple fibre | embroidered | NaN | NaN | False | False |
1 | T.38-2018 | 2018 | O1397496 | Bag | NaN | Amsterdam | Mayya Saliba | NaN | 2017 | 2018KX3020 | Pineapple fibre | NaN | NaN | On short term loan out for exhibition | False | False |
2 | E.230-2013 | 2013 | O1259931 | Photograph | Untitled, HG-689-05 | Nigeria | Ojeikere, J. D. 'Okhai (Mr) | photographer | 2005 | NaN | photographic paper | gelatin silver process | art photography | Prints & Drawings Study Room, room 315 | False | False |
3 | E.229-2013 | 2013 | O1259930 | Photograph | Untitled, HG-457-04 | Nigeria | Ojeikere, J. D. 'Okhai (Mr) | photographer | 2004 | NaN | photographic paper | gelatin silver process | art photography | Prints & Drawings Study Room, room 315 | False | False |
4 | E.228-2013 | 2013 | O1259929 | Photograph | Untitled, HG-535-04 | Nigeria | J.D. Okhai Ojeikere | photographer | 2004 | NaN | photographic paper | silver gelatin process | art photography | Prints & Drawings Study Room, room 315 | False | False |
5 | E.227-2013 | 2013 | O1259928 | Photograph | Untitled, HG 423-04 | Nigeria | Ojeikere, J. D. 'Okhai (Mr) | photographer | 2004 | NaN | photographic paper | gelatin silver process | art photography | Prints & Drawings Study Room, room 315 | False | False |
6 | E.575-2007 | 2007 | O140517 | Wallpaper | Pineapple | United Kingdom | Wilkinson, Jenny | designer | ca. 2006 | NaN | paper | printing | NaN | Prints & Drawings Study Room, room 514a | False | False |
7 | T.78:1, 2-2009 | 2009 | O1134866 | Trousers | NaN | Japan | Nishimura, Yoshiko | designer | 2000 | 2013GA4384 | NaN | NaN | NaN | NaN | False | False |
8 | C.10-2001 | 2001 | O56573 | Jug | Millennium Jug of Symbols | London | Malone, Kate | maker | 1999 | 2006BB9711 | stoneware | moulding | NaN | Ceramics, Room 142, The Lydia and Manfred Gorv... | False | False |
9 | B.213:1-1998 | 1998 | O8625 | Fruit bowl | Obstschale | Germany | Bodo | manufacturer | January 1998 - May 1998 | NaN | maple | NaN | NaN | SWPREP | False | False |
import pandas as pd
object_df = pd.read_csv("https://api.vam.ac.uk/v2/objects/search?q=Derby&page_size=10&response_format=csv&order_by=location")
object_df.head(10)
accessionNumber | accessionYear | systemNumber | objectType | _primaryTitle | _primaryPlace | _primaryMaker__name | _primaryMaker__association | _primaryDate | _primaryImageId | _sampleMaterial | _sampleTechnique | _sampleStyle | _currentLocation__displayName | _objectContentWarning | _imageContentWarning | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | S.5026-2009 | 2009 | O1152790 | Token | NaN | London | unknown | maker | ca.1900 | 2014GY2735 | white metal | striking (metal-working) | NaN | Theatre & Performance, Room 106 | False | False |
1 | B.212:1 to 3-2016 | 2016 | O1371504 | cap gun | Space Outlaw Space-Gun | Great Britain | BCM Co. (Derby) Ltd. | manufacturers | 1975-1982 | 2017JU8877 | metal | die-casting | NaN | SWPREP | False | False |
2 | B.9-2017 | 2017 | O1370577 | Skateboard | Roller Derby Skate Board | United States | Roller Derby Skate Corp | manufacturers | 1959/1960 | 2017JX1842 | plywood | NaN | Mid 20th century | SWPREP | False | False |
3 | MISC.30-1963 | 1963 | O1124331 | Horse and coal cart | NaN | NaN | NaN | NaN | 1913 | NaN | NaN | NaN | NaN | SWPREP | False | False |
4 | B.78:1-1995 | 1995 | O38480 | Boots | Doc Martens | United Kingdom | R Griggs Group Ltd | maker | ca. 1982 | 2008BT9831 | NaN | NaN | NaN | SWPREP | False | False |
5 | B.1280:1-1999 | 1999 | O36458 | Electronic game | The Arcade Game You Can Take Anywhere! | Japan | Tomy | manufacturer | ©1978 | NaN | card | printed | NaN | SWPREP | False | False |
6 | B.292-2012 | 2012 | O1256497 | Copybook | NaN | Ashbourne | unknown | publisher | 1810 - 1845 | NaN | paper | printing | NaN | SWPREP | False | False |
7 | B.282-2012 | 2012 | O1256437 | Exercise book | NaN | Derby | Henry Hood | author | 1848 | NaN | ink | handwriting | NaN | SWPREP | False | False |
8 | B.1335:1-1999 | 1999 | O41383 | Hand held game | DERBY DAY | Japan | Tomy | manufacturer | about 1975 | NaN | card | printed | NaN | SWPREP | False | False |
9 | B.528:1-1999 | 1999 | O48094 | Vehicle | SLOPPY JALOPIES™ | United States | Kenner | manufacturer | 1978 | NaN | card | printed | NaN | SWPREP | False | False |
Order direction (order_sort)¶
This affects the order of the results if the order_results_by is in use. The options available are:
asc - Order by ascending alphabetical order (A-Z)
desc - Order by descending alphabetical order (Z-A)
import pandas as pd
object_df = pd.read_csv("https://api.vam.ac.uk/v2/objects/search?q=pineapple&page_size=10&response_format=csv&order_by=date&order_sort=desc")
object_df.head(10)
accessionNumber | accessionYear | systemNumber | objectType | _primaryTitle | _primaryPlace | _primaryMaker__name | _primaryMaker__association | _primaryDate | _primaryImageId | _sampleMaterial | _sampleTechnique | _sampleStyle | _currentLocation__displayName | _objectContentWarning | _imageContentWarning | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | 1745-1888 | 1888 | O148454 | Printed linen | NaN | Germany | unknown | NaN | 1350-1400 | 2009CE2365 | Linen | Printing | NaN | Medieval & Renaissance, Room 64, The Wolfson G... | False | False |
1 | 462-1884 | 1884 | O261299 | Woven silk | NaN | NaN | NaN | NaN | 15th century | 2021MW7305 | NaN | NaN | NaN | In store | False | False |
2 | 1339-1864 | 1864 | O130054 | Woven silk velvet | NaN | Italy | unknown | NaN | ca. 1450 to ca. 1500 | 2009CE2354 | NaN | NaN | NaN | Medieval and Renaissance, Room 10c | False | False |
3 | 759-1875 | 1875 | O118583 | Woven silk | NaN | Italy | Unknown | NaN | second half of the 15th century | 2009CE2353 | Silk | damask | NaN | Medieval and Renaissance, Room 10c | False | False |
4 | 555-1884 | 1884 | O13612 | Velvet | NaN | Italy | Unknown | NaN | second half 15th century | 2011EN9650 | Silk velvet | woven | NaN | In store | False | False |
5 | 1062-1900 | 1900 | O130131 | Cloth of gold | NaN | Italy | Unknown | NaN | ca. 1475 to ca. 1500 | 2009CE2411 | silk | weaving | NaN | Medieval and Renaissance, Room 10c | False | False |
6 | 614:1, 2-1872 | 1872 | O93340 | Cup and cover | Buckelpokal | Augsburg | Unknown | NaN | 1480-1499 | 2006AL0149 | silver | NaN | NaN | Silver, Room 69, The Whiteley Galleries | False | False |
7 | 474-1884 | 1884 | O258572 | Woven silk | NaN | NaN | NaN | NaN | 16th century | NaN | NaN | NaN | NaN | In store | False | False |
8 | T.37-1954 | 1954 | O368043 | Carpet | NaN | Spain | Unknown | NaN | 1500 | 2017KN4295 | NaN | NaN | NaN | In store | False | False |
9 | 5667&A-1859 | 1859 | O364928 | Tapestry | NaN | Arras | unknown | NaN | 1500-1510 | 2019LY8006 | wool | weaving | NaN | In store | False | False |
Page of results (page)¶
This parameter determines which page of results from the matching search are returned. By default the first page is returned, each page containing 20 object records (this can be configured, see below). For example if a search returns 100 objects, you would need to request 5 pages to retrieve them all. Or you could set the page_size to 100 and then they can be requested in one query (see below)
import pandas as pd
object_df = pd.read_csv("https://api.vam.ac.uk/v2/objects/search?q=pineapple&page_size=10&response_format=csv&order_by=date&page=2")
object_df.head(10)
accessionNumber | accessionYear | systemNumber | objectType | _primaryTitle | _primaryPlace | _primaryMaker__name | _primaryMaker__association | _primaryDate | _primaryImageId | _sampleMaterial | _sampleTechnique | _sampleStyle | _currentLocation__displayName | _objectContentWarning | _imageContentWarning | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | T.531:1, 2-1996 | 1996 | O69383 | Bag and purse | Horse Chestnut bag with Conker purse | Great Britain | Gibbs, Emily Jo | maker | 1996 | 2019LJ5345 | silk (textile) | satin weave | NaN | Bags: Inside Out, Room 40 | False | False |
1 | E.642:1-1994 | 1994 | O179711 | NaN | Royal College of Art | Unknown | printer | September 1994 | 2008BT9484 | ink | wood engraving | NaN | Prints & Drawings Study Room, level E | False | False | |
2 | T.128:1 & 2-1996 | 1996 | O84226 | Handbag | 'Florist's Basket' handbag | Great Britain | Guinness, Lulu | designer | 1993 | 2020MR2981 | silk (textile) | satin weave | NaN | Bags: Inside Out, Room 40 | False | False |
3 | T.290-1992 | 1992 | O147912 | Shorts | NaN | Great Britain | Pineapple | designer and maker | 1992 | 2008BT4480 | Lycra | NaN | NaN | In store | False | False |
4 | E.657-1994 | 1994 | O180080 | Waitrose jam label | Great Britain | Hemstock, Clare | artist | 1989 | 2009BW8840 | ink | colour offset lithography | NaN | Prints & Drawings Study Room, level C | False | False | |
5 | E.1052-2000 | 2000 | O46676 | Scrapbook | Book N. 9 | Britain | Eddie Squires | artist | 1987-1991 | NaN | paper | collage | NaN | Prints & Drawings Study Room, level C | False | False |
6 | T.29-2015 | 2015 | O1315879 | Shirt | NaN | London | Scott Crolla | designer | 1981-85 | 2015HT2364 | cotton | printing | NaN | In store | False | False |
7 | S.3966-1994 | 1994 | O1164664 | Poster | NaN | NaN | J&P Atchison | printers (people) | 24/04/1979-12/05/1979 | 2014GY4437 | NaN | NaN | NaN | In store | False | False |
8 | S.3964-1994 | 1994 | O1164662 | Poster | NaN | NaN | Spatt, Leslie E. | photographers | 13/09/1977-01/10/1977 | 2014GY4435 | NaN | NaN | NaN | In store | False | False |
9 | E.231-2013 | 2013 | O1259932 | Photograph | HD849/75 (Abebe) | Nigeria | Ojeikere, J. D. 'Okhai (Mr) | photographer | 1975 | NaN | photographic paper | gelatin silver process | documentary | Photography Centre, Room 101, The Sir Elton Jo... | False | False |
Page size (page_size)¶
This parameter affects the number of results that are returned in response to each query. This defaults to 20, but can be changed upto 100.
import pandas as pd
object_df = pd.read_csv("https://api.vam.ac.uk/v2/objects/search?q=pineapple&page_size=10&response_format=csv&order_by=date&page_size=5")
object_df.head(10)
accessionNumber | accessionYear | systemNumber | objectType | _primaryTitle | _primaryPlace | _primaryMaker__name | _primaryMaker__association | _primaryDate | _primaryImageId | _sampleMaterial | _sampleTechnique | _sampleStyle | _currentLocation__displayName | _objectContentWarning | _imageContentWarning | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 | IS.1-2021 | 2021 | O1522050 | Barong | Barong | Philippines | EN Barong Filipino | maker | 2018 | NaN | pineapple fibre | embroidered | NaN | NaN | False | False |
1 | T.38-2018 | 2018 | O1397496 | Bag | NaN | Amsterdam | Mayya Saliba | NaN | 2017 | 2018KX3020 | Pineapple fibre | NaN | NaN | On short term loan out for exhibition | False | False |
2 | E.230-2013 | 2013 | O1259931 | Photograph | Untitled, HG-689-05 | Nigeria | Ojeikere, J. D. 'Okhai (Mr) | photographer | 2005 | NaN | photographic paper | gelatin silver process | art photography | Prints & Drawings Study Room, room 315 | False | False |
3 | E.229-2013 | 2013 | O1259930 | Photograph | Untitled, HG-457-04 | Nigeria | Ojeikere, J. D. 'Okhai (Mr) | photographer | 2004 | NaN | photographic paper | gelatin silver process | art photography | Prints & Drawings Study Room, room 315 | False | False |
4 | E.228-2013 | 2013 | O1259929 | Photograph | Untitled, HG-535-04 | Nigeria | J.D. Okhai Ojeikere | photographer | 2004 | NaN | photographic paper | silver gelatin process | art photography | Prints & Drawings Study Room, room 315 | False | False |
This option is for use with features on the V&A website and is unlikely to be useful to anyone else.
Transparency of Search (response_transparency)¶
Reserved for future use (see https://web.archive.org/web/20201231025731/https://safiyaunoble.com/)