Semantically Similar is an API that retrieves a similar item for a given item from the collections of the Rijksmuseum Amsterdam and Nederlandse Museums of World Cultures, using SPARQL to query the collection data.
The API is built as a Flask app and is containerised with Docker. This repository is set up to automatically trigger builds on Docker Hub, so that installation can be done by:
[sudo] docker pull bencomp/semantically-similar
Port 80 is exposed, so you would probably want to map it when starting a container, for example to port 2345:
[sudo] docker run --name lod_api -p 2345:80 bencomp/semantically-similar
The API has three similar endpoints, to find items in both museums' collections that share some aspect. (To call all returned items semantically similar is not necessarily correct.)
The URI of the input must be provided in the
uri query parameter.
Find items from the same year
/year endpoint is currently the only working endpoint.
It tries to find the year of the creation date and uses that to query
for other items from that year.
Find items from the same location of origin
/location endpoint is currently not working correctly.
It tries to find the item's location of creation and uses that to query
for other items from that location.
Find items created with the same techniques
/technique endpoint is currently not working correctly.
It tries to find the item's means of creation and uses that to query
for other items created with the same technique.
GPLv3, or later.