Content:
Access to APIs
To start using the API, you first need to obtain an API key by sending a request to tord.nilsen@nasjonalmuseet.no or dag.hensten@nasjonalmuseet.no.
Unique identifiers
The JSON document for an object contains two identifers: NmId and _id.
NmId is the identifier used by our managementsystem. This value can contain ampersand(&) and is not suitable in urls
_id is MongoDB’s primary key and is NmId where ampersand (&) is replaced with underscore (_) and is used as parameter.
All fields and parameters are camelCased
Base URL
Base URL is https://api.nasjonalmuseet.no/v1/
Please notice version-no. Currently on v1
Collection API GET /v1/collection/object?_id=[Object Number]&lang=[Language]&api_key=[key] gives access to a simplified information about an object.
Parameter
Format
Notes
_id
a-z/0-9
Object number assigned to the object
lang
no or en
Language parameter
api_key
a-z/0-9
Your API-key, mandatory for every request
Example request Collection API :
https://api.nasjonalmuseet.no/v1/collection/object?lang=no&_id=NG.M.00939&api_key=[key] Example response Collection API :
{
"data": [
{
"_id": "NG.M.00939",
"nmId": "NG.M.00939",
"objectName": "['Maleri']",
"technique": [
"Tempera",
"Fettstift"
],
"materials": [
"Papplate"
],Show More
"dimensions": [
{
"DimensionsType": "Bredde",
"DimSizeUnit": "cm",
"DimensionsCategory": "Hovedmål",
"DimensionNum": 73.5
},
{
"DimensionsType": "Høyde",
"DimSizeUnit": "cm",
"DimensionsCategory": "Hovedmål",
"DimensionNum": 91.0
},
{
"DimensionsType": "Bredde",
"DimSizeUnit": "cm",
"DimensionsCategory": "Rammemål",
"DimensionNum": 95.0
},
{
"DimensionsType": "Dybde",
"DimSizeUnit": "cm",
"DimensionsCategory": "Rammemål",
"DimensionNum": 6.5
},
{
"DimensionsType": "Høyde",
"DimSizeUnit": "cm",
"DimensionsCategory": "Rammemål",
"DimensionNum": 113.1
}
],
"dimenstionsType": [
"B",
"r",
"e",
"d",
"d",
"e"
],
"keywords": [
"Bildende kunst"
],
"classification": [
"532 - Bildende kunst"
],
"objectType": [
"Billedkunst"
],
"owner": [
{
"FullName": "Nasjonalmuseet for kunst, arkitektur og design",
"PersonType": [
"Institusjon"
],
"Id": "47704",
"LastName": [
"Nasjonalmuseet for kunst, arkitektur og design"
],
"UrlSegment": "nasjonalmuseet-for-kunst-arkitektur-og-design"
}
],
"MultiMedia": [
{
"Photocredit": [
"Høstland, Børre"
],
"LastModified": [
"2021-01-06T18:29:35.4990000"
],
"Usage": [
"Standard-bilde"
],
"ImageDimensions": {
"Height": "4000",
"Width": "3223"
},
"Id": 47488,
"MultimediaType": [
"Fotostation"
],
"Thumbnail": true,
"OriginalFile": [
"113298.tif"
],
"DocumentName": [
],
"Created": [
"2019-07-18T13:46:04.6010000"
]
},
{
"LastModified": [
"2021-01-06T18:14:12.6400000"
],
"Usage": [
"Detaljbilde"
],
"ImageDimensions": {
"Height": "1495",
"Width": "2000"
},
"Id": 43925,
"MultimediaType": [
"Fotostation"
],
"Thumbnail": false,
"OriginalFile": [
"54318.tif"
],
"DocumentName": [
],
"Created": [
"2019-07-18T13:51:42.4290000"
]
},
{
"LastModified": [
"2021-01-06T18:22:38.0720000"
],
"Usage": [
"Detaljbilde"
],
"ImageDimensions": {
"Height": "1495",
"Width": "2000"
},
"Id": 45775,
"MultimediaType": [
"Fotostation"
],
"Thumbnail": false,
"OriginalFile": [
"54321.tif"
],
"DocumentName": [
],
"Created": [
"2019-07-18T13:51:42.4290000"
]
},
{
"LastModified": [
"2021-01-06T18:26:59.1280000"
],
"Usage": [
"Detaljbilde"
],
"ImageDimensions": {
"Height": "2000",
"Width": "1511"
},
"Id": 46848,
"MultimediaType": [
"Fotostation"
],
"Thumbnail": false,
"OriginalFile": [
"54319.tif"
],
"DocumentName": [
],
"Created": [
"2019-07-18T13:51:42.4290000"
]
},
{
"LastModified": [
"2021-01-06T18:28:34.9480000"
],
"Usage": [
"Detaljbilde"
],
"ImageDimensions": {
"Height": "2000",
"Width": "1511"
},
"Id": 47243,
"MultimediaType": [
"Fotostation"
],
"Thumbnail": false,
"OriginalFile": [
"54320.tif"
],
"DocumentName": [
],
"Created": [
"2019-07-18T13:51:42.4290000"
]
}
]
}
],
"code": 200,
"message": "nam_object data retrieved successfully"
}
Collection Details API
GET /collection/object/details/?_id=[Object Number]&lang=[Language]&api_key=[key] gives access to detailed information about an object.
Parameter
Format
Notes
_id
a-z/0-9
Object number assigned to the object
lang
no or en
Language parameter
api_key
a-z/0-9
Your API-key, mandatory for every request
Example request Collection API :
https://api.nasjonalmuseet.no/v1/collection/object/details/?lang=no&_id=NG.M.00939&api_key=[key]Example response Collection Details API
{
"data": [
{
"_id": "NG.M.00939",
"MetaData": {
"OrgUnit": [
"Billedkunstsamlingene"
],
"AccessionTypeNMK": [
"Ervervelse"
],
"Owner": [
{
"FullName": "Nasjonalmuseet for kunst, arkitektur og design",
"PersonType": [
"Institusjon"
],
"Id": "47704",
"LastName": [
"Nasjonalmuseet for kunst, arkitektur og design"
],
"UrlSegment": "nasjonalmuseet-for-kunst-arkitektur-og-design"
}
],
"BarcodeNumber": [
"G-34275"
],
"Keywords": [
"Bildende kunst"
],
"Materials": [
"Papplate"
],
"IsArtwork": [
true
],
"CataloguingLevel": [
"Enkeltobjekt"
],
"ObjectTitle": [
{
"Type": "",
"Title": "Skrik",
"Alternatives": [
{
"Title": "The Scream",
"Lang": "ENG"
}
]
}
],
"ObjectType": [
"Billedkunst"
],
"SubjectType": [
"Landskap",
"Portrett"
],Show More
"Copyrights": [
{
"PersonManagerRef": 0,
"PersonRef": 56154,
"PersonRefMetaData": {
"FirstName": [
"Edvard"
],
"FullName": "Edvard Munch",
"PersonType": [
"Person"
],
"Id": "56154",
"LastName": [
"Munch"
],
"UrlSegment": "edvard-munch"
},
"CopyrightsStatus": "Inaktiv",
"DateTo": "2014-01-23T00:00:00Z"
}
],
"Classification": [
"532 - Bildende kunst"
],
"Production": [
{
"ProductionType": "Produsert",
"LevelCertainty": "sikker",
"PersonRef": 56154,
"DateToBegin": "1893-01-01T00:00:00Z",
"DateFromEnd": "1893-12-31T00:00:00Z",
"DateFrom": "1893",
"DateFromBegin": "1893-01-01T00:00:00Z",
"PerRole": "Kunstner",
"PersonRefMetaData": {
"FirstName": [
"Edvard"
],
"FullName": "Edvard Munch",
"PersonType": [
"Person"
],
"Id": "56154",
"LastName": [
"Munch"
],
"UrlSegment": "edvard-munch"
},
"PlaceRef": 0,
"DateToEnd": "1893-12-31T00:00:00Z",
"DateTo": "1893"
}
],
"SubjectRelatedPersons": [
],
"Multimedia": [
{
"Photocredit": [
"Høstland, Børre"
],
"LastModified": [
"2021-01-06T18:29:35.4990000"
],
"Usage": [
"Standard-bilde"
],
"ImageDimensions": {
"Height": "4000",
"Width": "3223"
},
"Id": 47488,
"MultimediaType": [
"Fotostation"
],
"Thumbnail": true,
"OriginalFile": [
"113298.tif"
],
"DocumentName": [
],
"Created": [
"2019-07-18T13:46:04.6010000"
]
},
{
"LastModified": [
"2021-01-06T18:14:12.6400000"
],
"Usage": [
"Detaljbilde"
],
"ImageDimensions": {
"Height": "1495",
"Width": "2000"
},
"Id": 43925,
"MultimediaType": [
"Fotostation"
],
"Thumbnail": false,
"OriginalFile": [
"54318.tif"
],
"DocumentName": [
],
"Created": [
"2019-07-18T13:51:42.4290000"
]
},
{
"LastModified": [
"2021-01-06T18:22:38.0720000"
],
"Usage": [
"Detaljbilde"
],
"ImageDimensions": {
"Height": "1495",
"Width": "2000"
},
"Id": 45775,
"MultimediaType": [
"Fotostation"
],
"Thumbnail": false,
"OriginalFile": [
"54321.tif"
],
"DocumentName": [
],
"Created": [
"2019-07-18T13:51:42.4290000"
]
},
{
"LastModified": [
"2021-01-06T18:26:59.1280000"
],
"Usage": [
"Detaljbilde"
],
"ImageDimensions": {
"Height": "2000",
"Width": "1511"
},
"Id": 46848,
"MultimediaType": [
"Fotostation"
],
"Thumbnail": false,
"OriginalFile": [
"54319.tif"
],
"DocumentName": [
],
"Created": [
"2019-07-18T13:51:42.4290000"
]
},
{
"LastModified": [
"2021-01-06T18:28:34.9480000"
],
"Usage": [
"Detaljbilde"
],
"ImageDimensions": {
"Height": "2000",
"Width": "1511"
},
"Id": 47243,
"MultimediaType": [
"Fotostation"
],
"Thumbnail": false,
"OriginalFile": [
"54320.tif"
],
"DocumentName": [
],
"Created": [
"2019-07-18T13:51:42.4290000"
]
}
],
"ObjectNumber": [
"NG.M.00939"
],
"MaterialTechnique": [
"Tempera og fettstift på papplate"
],
"TechniqueDecoration": [
],
"Dimensions": [
{
"DimensionsType": "Bredde",
"DimSizeUnit": "cm",
"DimensionsCategory": "Hovedmål",
"DimensionNum": 73.5
},
{
"DimensionsType": "Høyde",
"DimSizeUnit": "cm",
"DimensionsCategory": "Hovedmål",
"DimensionNum": 91.0
},
{
"DimensionsType": "Bredde",
"DimSizeUnit": "cm",
"DimensionsCategory": "Rammemål",
"DimensionNum": 95.0
},
{
"DimensionsType": "Dybde",
"DimSizeUnit": "cm",
"DimensionsCategory": "Rammemål",
"DimensionNum": 6.5
},
{
"DimensionsType": "Høyde",
"DimSizeUnit": "cm",
"DimensionsCategory": "Rammemål",
"DimensionNum": 113.1
}
],
"ProductionLocations": [
],
"SubjectRelatedPlacesParsed": [
],
"PublicDomain": [
true
],
"ObjectName": [
"Maleri"
],
"Creditline": [
"Gave fra Olaf Schou 1910"
],
"Technique": [
"Tempera",
"Fettstift"
],
"SubjectRelatedPlace": [
],
"PreviewDimensionsNo": [
"91 x 73,5 cm"
],
"Labeldate": [
"1893"
]
},
"IndexedDateTime": "2021-03-06T04:02:49.8800401Z",
"NmId": "NG.M.00939"
}
],
"code": 200,
"message": "nam_object data retrieved successfully"
}
Advanced query
collection/queryUses MongoDB query syntax for a more advanced search.
GET /collection/query/?api_key[key]Example request Collection Query API
GET /collection/query/?api_key[key] HTTP/1.1
Host: api.nasjonalmuseet.no
Content-Type: text/plain
Content-Length: 49
{"copyrightStatus" : "Inaktive", "title":"Skrik"}Python request example:
import requests
url = "https://api.nasjonalmuseet.no/v1/collection/query/?api_key=[key]"
payload="{\"MetaData.Copyrights.CopyrightsStatus\" : \"inactive\", \"title\":\"Skrik\"}"
headers = {
'Content-Type': 'text/plain'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)Images Images is stored in folders
/media/tif/
/media/jpeg/
/media/thumbs/
You will find filename in [Multimedia][OriginalFile]