The goal of europeanaR is to provide tools to access Linked Open Data published by Europeana. Gain access to millions of entries related to artworks, books, music, and videos on art, newspapers, archaeology, fashion, science, sport, and much more. This thesaurus of cultural heritage can be used in numerous creative ways like for example building applications, data analysis, Statistical and Deep Learning.
You can install the development version of europeanaR from GitHub with:
# install.packages("devtools") ::install_github("AleKoure/europeanaR")devtools
Sign up for your free API key and get developing here! When you get you personal key set it as environmental variable.
Alternatively, you can edit
.Renviron by inserting your
personal key to the environmental variable
The Search API provides a way to search for metadata records and media on the Europeana repository, for instance give me all results for the word “Vermeer”. The basic API call to the search API can return up to 100 items.
library(europeanaR) library(data.table) <- query_search_api("Vermeer", rows = 10, reusability = "open") resp #transform to tabular data <- tidy_search_items(resp) resp_tidy #get preview of first items <- resp_tidy[type == "IMAGE"][1, edmPreview]first_image
The API call repeats in case of an error, and it is designed to be kind to the server, see here. The retrieved metadata are given in JSON format and are parsed into an R object using jsonlite. In addition, these data can be transformed in tabular format and are compatible also with the data.table package for fast data manipulation operations.
The response richness can be controlled by using the
profile query parameter. Also, get bulk downloads of
metadata and associated media files by using the functions
<- tidy_cursored_search("Vermeer", max_items = 500, bulk_and_rich profile = "rich")
The Europeana services documentation can be found here. See the vignettes section and other resources at the package homepage for more information and examples.