Nomisma.org APIs

<!DOCTYPE html> <html lang="en"> <head>  <meta charset="utf-8"></meta> <meta name="viewport" content="width=device-width, initial-scale=1"></meta> <title>Nomisma.org APIs</title> <link rel="icon" type="image/svg+xml" href="/images/favicon.svg"></link> <script type="text/javascript" src="https://code.jquery.com/jquery-latest.min.js"></script>  <link rel="stylesheet" href="https://netdna.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css"></link> <script type="text/javascript" src="https://netdna.bootstrapcdn.com/bootstrap/3.3.6/js/bootstrap.min.js"></script> <link rel="stylesheet" href="/css/style.css"></link>  <title>Nomisma.org APIs | Nomisma.org</title> <meta name="generator" content="Jekyll v4.2.0" /> <meta property="og:title" content="Nomisma.org APIs" /> <meta property="og:locale" content="en_US" /> <meta name="description" content="Nomisma.org is a collaborative project to provide stable digital representations of numismatic concepts according to the principles of Linked Open Data." /> <meta property="og:description" content="Nomisma.org is a collaborative project to provide stable digital representations of numismatic concepts according to the principles of Linked Open Data." /> <link rel="canonical" href="http://nomisma.org/documentation/apis/" /> <meta property="og:url" content="http://nomisma.org/documentation/apis/" /> <meta property="og:site_name" content="Nomisma.org" /> <meta name="twitter:card" content="summary" /> <meta property="twitter:title" content="Nomisma.org APIs" /> <script type="application/ld+json"> {"@type":"WebPage","url":"http://nomisma.org/documentation/apis/","headline":"Nomisma.org APIs","description":"Nomisma.org is a collaborative project to provide stable digital representations of numismatic concepts according to the principles of Linked Open Data.","@context":"https://schema.org"}</script>  </head> <body> <div class="navbar navbar-default navbar-static-top" role="navigation"> <div class="container-fluid"> <div class="navbar-header"> <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> <span class="sr-only">Toggle navigation</span> <span class="icon-bar"/> <span class="icon-bar"/> <span class="icon-bar"/> </button> <a class="navbar-brand logo-nav" href="/"> <img style="height: 32px;" src="/images/nomisma-horizontal.svg" alt="nomisma.org"/> </a> </div> <div class="navbar-collapse collapse"> <ul class="nav navbar-nav"> <li> <a href="/browse">Browse IDs</a> </li> <li> <a href="/about">About</a> </li> <li class="dropdown"> <a href="#" class="dropdown-toggle" data-toggle="dropdown">Who We Are <b class="caret"></b></a> <ul class="dropdown-menu"> <li> <a href="/about/scientific_committee">Scientific Committee</a> </li> <li> <a href="/about/working_groups">Working Groups</a> </li> <li> <a href="/editor/">Editors</a> </li> </ul> </li> <li class="dropdown"> <a href="#" class="dropdown-toggle" data-toggle="dropdown">Research Tools <b class="caret"></b></a> <ul class="dropdown-menu"> <li> <a href="/research/distribution">Typological Distribution</a> </li> <li> <a href="/research/metrical">Measurement Analysis</a> </li> </ul> </li> <li class="dropdown"> <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a> <ul class="dropdown-menu"> <li> <a href="/ontology">Ontology</a> </li> <li> <a href="https://nomisma.hypotheses.org/the-nomisma-org-cookbook">Cookbook</a> </li> <li> <a href="/nuds">Numismatic Description Schema (NUDS)</a> </li> <li> <a href="/documentation/apis">APIs</a> </li> <li> <a href="/documentation/contribute">Contribute Data</a> </li> <li> <a href="https://www.zotero.org/groups/4411268/digital_numismatics">Digital Numismatics Bibliography</a> </li> <li> <a href="/documentation/sparql">SPARQL Examples</a> </li> </ul> </li> <li> <a href="#" class="dropdown-toggle" data-toggle="dropdown">Get Data <b class="caret"></b></a> <ul class="dropdown-menu"> <li> <a href="/data">Overview</a> </li> <li> <a href="/datasets">Partner Datasets</a> </li> <li> <a href="/sparql">SPARQL</a> </li> </ul> </li> </ul> <div class="col-sm-3 col-md-3 pull-right"> <form class="navbar-form" role="search" action="/browse" method="get"> <div class="input-group"> <input type="text" class="form-control" placeholder="Search IDs" name="q" id="srch-term"></input> <div class="input-group-btn"> <button class="btn btn-default" type="submit"> <i class="glyphicon glyphicon-search"></i> </button> </div> </div> </form> </div> </div> </div> </div> <div class="container-fluid content"> <div class="row"> <div class="col-md-12"> <h1 id="api-documentation">API Documentation</h1> <p>This page contains documentation for using web services provided by Nomisma and how to access machine readable serializations through REST and content negotiation.</p> <ul> <li><a href="#apis">APIs</a></li> <li><a href="#reconciliation">OpenRefine Reconciliation Service</a></li> </ul> <h2 id="apis">APIs</h2> <table class="table"> <thead> <tr> <th style="width:50%">API</th> <th>XML</th> <th>JSON</th> <th>Turtle</th> </tr> </thead> <tbody> <tr> <td> <a href="#avgAxis">avgAxis</a> </td> <td> <a href="/apis/avgAxis?constraints=nmo:hasTypeSeriesItem <http://numismatics.org/ocre/id/ric.1(2).aug.1A>">XML</a> </td> <td> <a href="/apis/avgAxis?constraints=nmo:hasTypeSeriesItem <http://numismatics.org/ocre/id/ric.1(2).aug.1A>&format=json">JSON</a> </td> <td /> </tr> <tr> <td> <a href="#avgDiameter">avgDiameter</a> </td> <td> <a href="/apis/avgDiameter?constraints=nmo:hasTypeSeriesItem <http://numismatics.org/ocre/id/ric.1(2).aug.1A>">XML</a> </td> <td> <a href="/apis/avgDiameter?constraints=nmo:hasTypeSeriesItem <http://numismatics.org/ocre/id/ric.1(2).aug.1A>&format=json">JSON</a> </td> <td /> </tr> <tr> <td> <a href="#avgWeight">avgWeight</a> </td> <td> <a href="/apis/avgWeight?constraints=nmo:hasTypeSeriesItem <http://numismatics.org/ocre/id/ric.1(2).aug.1A>">XML</a> </td> <td> <a href="/apis/avgWeight?constraints=nmo:hasTypeSeriesItem <http://numismatics.org/ocre/id/ric.1(2).aug.1A>&format=json">JSON</a> </td> <td /> </tr> <tr> <td> <a href="#closingDate">closingDate</a> </td> <td> <a href="/apis/closingDate?identifiers=http://numismatics.org/crro/id/rrc-385.4|http://numismatics.org/crro/id/rrc-409.2|http://numismatics.org/ocre/id/ric.1(2).aug.1A">XML</a> </td> <td> <a href="/apis/closingDate?identifiers=http://numismatics.org/crro/id/rrc-385.4|http://numismatics.org/crro/id/rrc-409.2|http://numismatics.org/ocre/id/ric.1(2).aug.1A&format=json">JSON</a> </td> <td /> </tr> <tr> <td> <a href="#getLabel">getLabel</a> </td> <td> <a href="/apis/getLabel?uri=http://nomisma.org/id/ar&lang=fr">XML</a> </td> <td> <a href="/apis/getLabel?uri=http://nomisma.org/id/ar&lang=fr&format=json">JSON</a> </td> <td /> </tr> <tr> <td> <a href="#getFindspots">getFindspots</a> </td> <td /> <td> <a href="/apis/getFindspots?id=denarius">GeoJSON</a> </td> <td /> </tr> <tr> <td> <a href="#getHoards">getHoards</a> </td> <td /> <td> <a href="/apis/getHoards?id=denarius">GeoJSON</a> </td> <td /> </tr> <tr> <td> <a href="#getMints">getMints</a> </td> <td /> <td> <a href="/apis/getMints?id=denarius">GeoJSON</a> </td> <td /> </tr> <tr> <td> <a href="#getRdf">getRdf</a> </td> <td> <a href="/apis/getRdf?identifiers=rome|augustus|av|aureus">RDF/XML</a> </td> <td> <a href="/apis/getRdf?identifiers=rome|augustus|av|aureus&format=json">JSON-LD</a> </td> <td> <a href="/apis/getRdf?identifiers=rome|augustus|av|aureus&format=ttl">RDF/TTL</a> </td> </tr> <tr> <td> <a href="#dieCounts">dieCounts</a> </td> <td /> <td> <a href="/apis/dieCounts">JSON</a> </td> <td /> </tr> </tbody> </table> <div id="avgAxis"> <h3>Average Axis</h3> <p>Get average axis for given SPARQL query.<br /> <b>Webservice Type</b> : REST<br /> <b>Url</b> : nomisma.org/avgAxis?<br /> <b>Parameters</b> : constraints (following predicate - object format. multiple contraints separated by ' AND '. See examples below), format ('json' or 'xml', default 'xml')<br /> <b>Result</b> : returns a decimal number in a response wrapper.<br /> <b>Examples</b>: <a href="/apis/avgAxis?constraints=dcterms:source nm:ric AND nmo:hasMint nm:rome AND nmo:hasDenomination nm:denarius">http://nomisma.org/apis/avgAxis?constraints=dcterms:source nm:ric AND nmo:hasMint nm:rome AND nmo:hasDenomination nm:denarius</a> <br /> <a href="/apis/avgAxis?constraints=nmo:hasTypeSeriesItem <http://numismatics.org/ocre/id/ric.1(2).aug.1A>">http://nomisma.org/apis/avgWeight?constraints=nmo:hasTypeSeriesItem <http://numismatics.org/ocre/id/ric.1(2).aug.1A></a> </p> </div> <div id="avgDiameter"> <h3>Average Diameter</h3> <p>Get average diameter for given SPARQL query.<br /> <b>Webservice Type</b> : REST<br /> <b>Url</b> : nomisma.org/avgDiameter?<br /> <b>Parameters</b> : constraints (following predicate - object format. multiple contraints separated by ' AND '. See examples below), format ('json' or 'xml', default 'xml')<br /> <b>Result</b> : returns a decimal number in a response wrapper.<br /> <b>Examples</b>: <a href="/apis/avgDiameter?constraints=dcterms:source nm:ric AND nmo:hasMint nm:rome AND nmo:hasDenomination nm:denarius">http://nomisma.org/apis/avgDiameter?constraints=dcterms:source nm:ric AND nmo:hasMint nm:rome AND nmo:hasDenomination nm:denarius</a> <br /> <a href="/apis/avgDiameter?constraints=nmo:hasTypeSeriesItem <http://numismatics.org/ocre/id/ric.1(2).aug.1A>">http://nomisma.org/apis/avgDiameter?constraints=nmo:hasTypeSeriesItem <http://numismatics.org/ocre/id/ric.1(2).aug.1A></a> </p> </div> <div id="avgWeight"> <h3>Average Weight</h3> <p>Get average weight for given SPARQL query.<br /> <b>Webservice Type</b> : REST<br /> <b>Url</b> : nomisma.org/apis/avgWeight?<br /> <b>Parameters</b> : constraints (following predicate - object format. multiple contraints separated by ' AND '. See examples below), format ('json' or 'xml', default 'xml')<br /> <b>Result</b> : returns a decimal number in a response wrapper.<br /> <b>Examples</b>: <a href="/apis/avgWeight?constraints=dcterms:source nm:ric AND nmo:hasMint nm:rome AND nmo:hasDenomination nm:denarius">http://nomisma.org/apis/avgWeight?constraints=dcterms:source nm:ric AND nmo:hasMint nm:rome AND nmo:hasDenomination nm:denarius</a> <br /> <a href="/apis/avgWeight?constraints=nmo:hasTypeSeriesItem <http://numismatics.org/ocre/id/ric.1(2).aug.1A>">http://nomisma.org/apis/avgWeight?constraints=nmo:hasTypeSeriesItem <http://numismatics.org/ocre/id/ric.1(2).aug.1A></a> </p> </div> <div id="closingDate"> <h3>Closing Date</h3> <p>Get the closing date of a hoard based on coin type URIs provided in the request parameter.<br /> <b>Webservice Type</b> : REST<br /> <b>Url</b> : nomisma.org/apis/closingDate?<br /> <b>Parameters</b> : identifiers (coin type URIs divided by a pipe '|'), format ('json' or 'xml', default 'xml')<br /> <b>Result</b> : returns an integer which represents the year. Negative numbers refer to B.C. dates.<br /> <b>Examples</b>: <a href="/apis/closingDate?identifiers=http://numismatics.org/crro/id/rrc-385.4|http://numismatics.org/crro/id/rrc-409.2|http://numismatics.org/ocre/id/ric.1(2).aug.1A">http://nomisma.org/apis/closingDate?identifiers=http://numismatics.org/crro/id/rrc-385.4|http://numismatics.org/crro/id/rrc-409.2|http://numismatics.org/ocre/id/ric.1(2).aug.1A</a> </p> </div> <div id="getFindspots"> <h3>Get Findspots</h3> <p>Get all individual find spots for a given skos:Concept defined by the id parameter or for a given coin type (nmo:TypeSeriesItem) defined by the coinType parameter<br /> <b>Webservice Type</b> : REST<br /> <b>Url</b> : nomisma.org/apis/getFindspots?<br /> <b>Parameters</b> : id (of Nomisma ID) OR coinType (full URI for a coin type) OR symbol (full URI for a symbol [monogram, mint mark, etc.])<br /> <b>Result</b> : returns geoJSON for features (points or polygons)<br /> <b>Examples</b>: <a href="/apis/getFindspots?id=denarius">apis/getFindspots?id=denarius</a>, <a href="/apis/getFindspots?coinType=http://numismatics.org/crro/id/rrc-408.1a">apis/getFindspots?coinType=http://numismatics.org/crro/id/rrc-408.1a</a>, <a href="/apis/getFindspots?symbol=http://numismatics.org/ocre/symbol/monogram.ric.10.marcian.1">apis/getFindspots?symbol=http://numismatics.org/ocre/symbol/monogram.ric.10.marcian.1</a> </p> </div> <div id="getHoards"> <h3>Get Hoards</h3> <p>Get all hoards associated with a given skos:Concept defined by the id parameter or for a given coin type (nmo:TypeSeriesItem) defined by the coinType parameter. If the skos:Concept is a hoard, then only one point is returned.<br /> <b>Webservice Type</b> : REST<br /> <b>Url</b> : nomisma.org/apis/getHoards?<br /> <b>Parameters</b> : id (of Nomisma ID) OR coinType (full URI for a coin type) OR symbol (full URI for a symbol [monogram, mint mark, etc.])<br /> <b>Result</b> : returns geoJSON for features (points or polygons)<br /> <b>Examples</b>: <a href="/apis/getHoards?id=denarius">apis/getHoards?id=denarius</a>, <a href="/apis/getHoards?coinType=http://numismatics.org/crro/id/rrc-408.1a">apis/getHoards?coinType=http://numismatics.org/crro/id/rrc-408.1a</a>, <a href="/apis/getHoards?symbol=http://numismatics.org/ocre/symbol/monogram.ric.10.marcian.1">apis/getHoards?symbol=http://numismatics.org/ocre/symbol/monogram.ric.10.marcian.1</a> </p> </div> <div id="getMints"> <h3>Get Mints</h3> <p>Get all minting locations (may be nmo:Mint or nmo:Region) associated with a given skos:Concept defined by the id parameter. If the skos:Concept is a mint or region, then only one point or polygon is returned.<br /> <b>Webservice Type</b> : REST<br /> <b>Url</b> : nomisma.org/apis/getMints?<br /> <b>Parameters</b> : id (of Nomisma ID) OR symbol (full URI for a symbol [monogram, mint mark, etc.])<br /> <b>Result</b> : returns geoJSON for features (points or polygons)<br /> <b>Examples</b>: <a href="/apis/getMints?id=denarius">apis/getMints?id=denarius</a>, <a href="/apis/getMints?symbol=http://numismatics.org/ocre/symbol/monogram.ric.10.marcian.1">apis/getMints?symbol=http://numismatics.org/ocre/symbol/monogram.ric.10.marcian.1</a> </p> </div> <div id="getLabel"> <h3>Get Label</h3> <p>Get the label of a Nomisma ID given its URI and language code.<br /> <b>Webservice Type</b> : REST<br /> <b>Url</b> : nomisma.org/apis/getLabel?<br /> <b>Parameters</b> : uri (of Nomisma ID), lang (two-letter ISO language code), format ('json' or 'xml', default 'xml')<br /> <b>Result</b> : returns the label in given language, or English as default.<br /> <b>Examples</b>: <a href="/apis/getLabel?uri=http://nomisma.org/id/ar&lang=fr">apis/getLabel?uri=http://nomisma.org/id/ar&lang=fr</a> </p> </div> <div id="getRDF"> <h3>Get RDF</h3> <p>Aggregate RDF for Nomisma ids. The default stream is in RDF/XML, but Turtle and JSON-LD are available.<br /> <b>Webservice Type</b> : REST<br /> <b>Url</b> : nomisma.org/apis/getRdf?<br /> <b>Parameters</b> : identifiers (Nomisma ids divided by a pipe '|'), format ('xml', 'ttl', 'json'; default 'xml')<br /> <b>Result</b> : RDF/XML, RDF/TTL. Other RDF formats will be supported eventually.<br /> <b>Examples</b>: <a href="/apis/getRdf?identifiers=rome|augustus|av|aureus">apis/getRdf?identifiers=rome|augustus|av|aureus</a> </p> </div> <div id="dieCounts"> <h3>Die Counts</h3> <p>The Die Counts API delivers a JSON response with available named graphs that correspond to die studies and formulas.<br /> <b>Webservice Type</b> : REST<br /> <b>Url</b> : nomisma.org/apis/dieCounts<br /> <b>Parameters</b> : The calculation formula (e.g., 'esty') is appended to the URL pattern, and the 'dieStudy' parameter corresponds to a named graph URI reflecting the scholar, and the 'type' parameter corresponds to a coin type URI.<br /> <b>Result</b> : JSON response, according to JSend.<br /> <b>Examples</b>: <a href="/apis/dieCounts">apis/dieCounts</a>, <a href="/apis/dieCounts/esty?dieStudy=http%3A%2F%2Fnomisma.org%2Feditor%2Frschaefer&type=http%3A%2F%2Fnumismatics.org%2Fcrro%2Fid%2Frrc-383.1">apis/dieCounts/esty?dieStudy=http%3A%2F%2Fnomisma.org%2Feditor%2Frschaefer&type=http%3A%2F%2Fnumismatics.org%2Fcrro%2Fid%2Frrc-383.1</a> </p> </div> <hr /> <h2 id="reconciliation">OpenRefine Reconciliation Service</h2> <p><strong>Service URI:</strong> <a href="http://nomisma.org/apis/reconcile">http://nomisma.org/apis/reconcile</a></p> <p>Nomisma supports the following reconciliation services for OpenRefine:</p> <ul> <li>Main Reconciliation Service</li> <li>Preview API</li> <li>Entity Suggestion API (for autosuggest on matching terms)</li> </ul> <p>All API responses are in JSON. Please see the <a href="https://github.com/OpenRefine/OpenRefine/wiki/Reconciliation-Service-Api">API documentation</a> and <a href="https://github.com/OpenRefine/OpenRefine/wiki/Reconciliation">usage documentation</a> for more details. The blog post, <em><a href="http://numishare.blogspot.com/2017/10/nomisma-launches-openrefine.html">Nomisma launches OpenRefine reconciliation service</a></em>, contains further information about this particular implementation in Nomisma.</p> </div> </div> </div> <div id="footer"> <div class="container-fluid"> <p><a href="http://creativecommons.org/licenses/by/3.0/"><img alt="Creative Commons License" style="border-width:0" src="http://i.creativecommons.org/l/by/3.0/88x31.png"/></a><br/>Unless specified otherwise, content in <a href="http://nomisma.org" xmlns:dc="http://purl.org/dc/elements/1.1/">Nomisma.org</a> is licensed under a <a xmlns:cc="http://creativecommons.org/ns#" href="http://creativecommons.org/licenses/by/3.0/" >Creative Commons Attribution 3.0 License</a>.</p> <p>Please support Nomisma.org by <a href="https://numismatics.org/giving/">Giving to the American Numismatic Society</a>.</p> </div> </div> </body> </html>

CINXE.COM

Nomisma.org APIs