/about

? radovan

Radovan is a meta search engine aggregating 13 open access sources of (mostly academic) texts.

The results inherit the order in which they are displayed on the original page and are grouped accordingly. This instance of Radovan currently harvests 10 hits per source.

The goal is to preserve as much metadata from the origins as possible. Not all sources provide the same quantity/quality of metadata. On top of that some might get lost during standardization.

? api

Radovan has a simple api, now at version 2.0, which returns json. Or - to be more exact - metadata in bibjson.

search single item

endpoint:
/radovan_api/search/single

parameters:
author, title, year, isbn, doi, sources

sample query:
/radovan_api/search/single?author=haraway&title=cyborg&year=&isbn=&doi=&sources=0+1+2+3

You can query the api to get a dictionary of current sources and their ids:
/radovan_api/sources

bulk search

It is possible to pass a bibjson file to the API and execute a bulk search.

endpoint:
/radovan_api/search/bulk

sample query (with python requests):
headers = {'Content-type': 'application/json', 'Accept': 'text/plain'}
results = requests.get('/radovan_api/search/bulk', json=bibjson_data, headers=headers)

v 1.0

The initial version of the API (1.0) is available at radovan_api/v1.0/simple/items and radovan_api/v1.0/bulk respectively.

? code

The code is hosted on github.

It's easy to get your own instance up and running with docker-compose. It's licensed under GPLv3.

? issues

Radovan is in beta. Issues are to be expected at this point. Report them here.

The queries should take no longer than 10 seconds. If they do something has gone wrong. Some sources are slower than others. Generally aaaaarg and MLA Core create most of the lag.

? more sources

Suggest more sources to be added here. The more diverse the better.

? privacy

The server does not log ips, queries or any other identifiers, but it does log errors ie. where the code breaks if/when it breaks.

? attribution

Radovan is a character from a comic book created by Matjaž Schmidt in the 1980s. In that story Radovan from planet Beta is a researcher from outer space interested in - out of all things and creatures - Earthlings. If he was appalled by our attitude towards the environment, then he would likely be taken aback by the state of academic publishing. Or maybe not, because he'd lack access.

Fourty years on Radovan's distant cousin Radovan (from planet Meta) comes to Earth in the form of this search engine to help sort out the mess.

The project was made possible by Coventry University, in particular the Centre for Post-Digital Cultures, where this site is hosted.