OpenCitations - Querying Data

<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="utf-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <link rel="icon" href="/static/favicon.ico" /> <title>OpenCitations - Querying Data</title>  <link href="/static/css/bootstrap.min.css" rel="stylesheet" /> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.10.0/font/bootstrap-icons.css" />  <link href="/static/css/font-awesome.min.css" rel="stylesheet" />  <link href="/static/css/ie10-viewport-bug-workaround.css" rel="stylesheet" />  <link href="/static/css/cover.css" rel="stylesheet" />   </head> <body> <div class="cover-container"> <div class="masthead clearfix"> <nav class="navbar"> <div class="navbar-header"> <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <h3 class="masthead-brand"> <a class="navbar-brand" href="/"> <img src="/static/img/logo.png" height=50 alt="Logo" class="d-inline-block align-top"> </a> </h3> </div> <div class="navbar-collapse collapse"> <div class="masthead-search"> <form class="input-group" action="/index/search" method="get"> <input type="text" class="form-control oc-purple" placeholder="Search for a DOI, e.g. 10.1162/qss_a_00023" name="text"> <input type="hidden" name="rule" value="citeddoi"> <div class="input-group-btn"> <button class="btn btn-default oc-purple" type="submit"><i class="glyphicon glyphicon-search"></i></button> </div> </form> </div> <div class="masthead-pages"> <ul class="nav masthead-nav navbar-nav"> <li> <a href="/"> Home </a> <li> <a href="/about"> About </a> <li> <a href="/membership"> Help us </a> <li> <a href="/model"> Data Model </a> <li> <a href="/datasets"> Datasets </a> <li class="active"> <a href="/querying"> Querying Data </a> <li> <a href="/tools"> Tools </a> <li> <a href="/download"> Download </a> <li> <a href="/publications"> Publications </a> </li> </ul> </div> </div> </nav> </div> <div class="cover left"> <h3>Querying Data</h3> <p><span class="oc-purple">Open</span><span class="oc-blue">Citations</span> provides three main mechanisms to query the data it provides. </p> <ul> <li> <p><strong><span class="oc-purple">Open</span><span class="oc-blue">Citations</span> SPARQL endpoints.</strong> <span class="oc-purple">Open</span><span class="oc-blue">Citations</span> made available a <a href="https://www.w3.org/TR/sparql11-query/">SPARQL</a> endpoint for all the datasets released. When such a SPARQL endpoint is accessed with a browser, it shows an editor GUI generated with <a href="https://yasgui.org/">YASGUI</a>. Of course, any SPARQL endpoint can additionally be queried using the <a href="https://www.w3.org/TR/sparql11-protocol/">SPARQL Protocol</a>, e.g. via <code>curl</code>. The SPARQL endpoints available are:</p> <ul> <li><p><a href="/index/sparql"><span class="oc-purple">Open</span><span class="oc-blue">Citations</span> Index SPARQL endpoint</a>;</p></li> <li><p><a href="/meta/sparql"><span class="oc-purple">Open</span><span class="oc-blue">Citations</span> Meta SPARQL endpoint</a>.</p></li> </ul> </li> <li> <p><strong><span class="oc-purple">Open</span><span class="oc-blue">Citations</span> REST APIs.</strong> All the data in any of the <span class="oc-purple">Open</span><span class="oc-blue">Citations</span> datasets can be retrieved by using an HTTP REST API. The rationale of making REST APIs available in addition to the SPARQL endpoints was to provide convenient access to the data included in the <span class="oc-purple">Open</span><span class="oc-blue">Citations</span> datasets for Web developers and users who are not necessarily experts in Semantic Web technologies. All the REST APIs made available by <span class="oc-purple">Open</span><span class="oc-blue">Citations</span>, has been implemented by means of <a href="https://github.com/opencitations/ramose">RAMOSE, the Restful API Manager Over SPARQL Endpoints</a>, which is a Python application that allows one to simply create a REST API over any SPARQL endpoint by means of a simple configuration file that execute a SPARQL query dependently of the particular API call specified. The REST APIs available are:</p> <ul> <li><p><a href="/index/api/v2"><span class="oc-purple">Open</span><span class="oc-blue">Citations</span> Index REST API</a>;</p></li> <li><p><a href="/meta/api/v1"><span class="oc-purple">Open</span><span class="oc-blue">Citations</span> Meta REST API</a>.</p></li> </ul> <p><strong>If you are going to use the REST APIs within an application/code, we encourage you to first get the <a href="/accesstoken">OpenCitations Access Token</a> and specify it in the "authorization" header of your REST API call. Obtaining the token takes only a few seconds and needs to happen only once. It costs you nothing, however, it could help <span class="oc-purple">Open</span><span class="oc-blue">Citations</span> a lot. Thank you!</strong></p> </li> <li> <p><strong><span class="oc-purple">Open</span><span class="oc-blue">Citations</span> Search Interfaces.</strong> <span class="oc-purple">Open</span><span class="oc-blue">Citations</span> has additionally developed user-friendly text search interfaces and browsing interfaces that can be used to search data in all the <span class="oc-purple">Open</span><span class="oc-blue">Citations</span> datasets and to visualise and browse them, respectively. These two interfaces have been developed by means of <a href="https://github.com/opencitations/oscar">OSCAR, the <span class="oc-purple">Open</span><span class="oc-blue">Citations</span> RDF Search Application</a>, and <a href="https://github.com/opencitations/lucinda">LUCINDA, the <span class="oc-purple">Open</span><span class="oc-blue">Citations</span> RDF Resource Browser</a>, that provide a configurable layer over SPARQL endpoints that permit one easily to create Web interfaces for querying and visualising the results of SPARQL queries. The search interfaces available are:</p> <ul> <li><p><a href="/index/search"><span class="oc-purple">Open</span><span class="oc-blue">Citations</span> Index Search Interface</a>.</p></li> </ul> </li> </ul> </div> </div> <footer> <div class="container"> <div class="row"> <div id="disi" class="col-xs-12 col-sm-2"> <p> <a href="http://www.unibo.it"><img src="/static/img/unibo.png" /></a> </div> <div id="ficlit" class="col-xs-12 col-sm-2"> <p> <a href="http://www.ficlit.unibo.it"><img src="/static/img/ficlit.png" /></a></p> </div> <div id="openscholarlymetadata" class="col-xs-12 col-sm-2"> <p> <a href="https://openscholarlymetadata.org"><img src="/static/img/openscholarlymetadata.png" /></a></p> </div>  </div> </div> <p> <a class="policy oc-purple" href="/policy">Privacy Policies</a> <span class="separator"></span> <a class="social oc-purple" href="mailto:contact@opencitations.net"><i class="fa fa-envelope" aria-hidden="true"></i></a> <a class="social oc-purple" href="http://www.twitter.com/opencitations"><i class="fa fa-twitter" aria-hidden="true"></i></a> <a class="social oc-blue" href="http://github.com/opencitations"><i class="fa fa-github" aria-hidden="true"></i></a> <a class="social oc-blue" href="https://www.linkedin.com/company/opencitations/"><i class="fa fa-linkedin" aria-hidden="true"></i></a> <a class="social oc-blue" href="https://opencitations.hypotheses.org/"><i class="fa fa-newspaper-o" aria-hidden="true"></i></a> <a class="social oc-blue" href="https://scicomm.xyz/@opencitations"><i class="bi bi-mastodon" aria-hidden="true"></i></a> </p> </footer>   <script src="/static/js/jquery.min.js"><![CDATA[ ]]></script> <script>window.jQuery || document.write('<script src="/static/js/jquery.min.js"><\/script>')</script> <script src="/static/js/bootstrap.min.js"><![CDATA[ ]]></script>  <script src="/static/js/ie10-viewport-bug-workaround.js"><![CDATA[ ]]></script>  <script src="/static/js/cookies.js"></script> </body> </html>

CINXE.COM

OpenCitations - Querying Data