Trismegistos Data Services

<!DOCTYPE html> <html lang="en" dir="ltr"> <head> <link rel="icon" href="/img/favicon.ico"/> <meta charset="utf-8"> <meta name="generator" content="Adobe GoLive" /> <meta name="viewport" content="initial-scale=1, maximum-scale=1"> <title>Trismegistos Data Services</title> <link rel="stylesheet" href="/dataservices/style.css"> <link rel="stylesheet" href="/css/layout_head_foot.css"> <link rel="stylesheet" href="/css/biscuit_notification.css"> <script src="../js/jquery-3.1.1.min.js"></script> <script src="../js/resp_header.js"></script> <script src="/js/deliciousmunchies_warning.js"></script> <script src="https://www.google.com/cse/brand?form=cse-search-box&lang=en"></script> </head>  <script> var _paq = window._paq = window._paq || []; /* tracker methods like "setCustomDimension" should be called before "trackPageView" */ _paq.push(['trackPageView']); _paq.push(['enableLinkTracking']); (function() { var u="//trismegistos.org/"; _paq.push(['setTrackerUrl', u+'matomo.php']); _paq.push(['setSiteId', '7']); var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s); })(); </script>  <body>  <header> <div class="wrapper header-flex"> <nav class="menu"> <ul class="active"> <li id="logo"><a href="/">TM Home</a></li> <li><a href="#top">Trismegistos Data Services</a></li> </ul> <a class="toggle-nav" href="#">☰</a> </nav> <div id="header-right-section"> <div class="search-form"> <form action="https://www.google.com/cse"> <input type="hidden" name="cx" value="004850043031813354276:eez6dkoyu_y"> <input type="hidden" name="ie" value="UTF-8"> <input type="text" name="q" placeholder="Can we help you?"> <button>Go</button> </form> </div>  </div> </div>  </div>  </header>  <div id="top" class="one-div"> <div class="container first-container"> <h1 class="first-container">Trismegistos Data Services</h1> <div class="flex"> <div class="flex-item"> <p>The team behind Trismegistos is proud to present the new Data Services portal, developed in the Linked Open Data framework of <a href="http://be.dariah.eu/" target="_blank">DARIAH-BE</a> and <a href="https://be.dariah.eu/news/open-humanities-gets-infrastructural-boost-flanders" target="_blank">CLARIAH-VL</a>. On this portal you can find a general overview of the services we offer. We've made a set of public methods, which can be used by researchers, students, webdesigners and so forth who wish to work with our data. We offer you open access to our data on a <a href="https://creativecommons.org/licenses/by-sa/4.0/" target="_blank">CC BY-SA 4.0 license</a>.</p> <p><strong>What data is on offer?</strong> Well, we're glad you ask. Here's a short overview of the open services, you can find a more detailed explanation in the documentation page of each endpoint.</p> <a href="http://be.dariah.eu/project/trismegistos" target="_blank"><img src="http://be.dariah.eu/sites/all/themes/dariah_be/logo.png" alt="DARIAH-BE" width="200px"></a> <a href="http://be.dariah.eu/project/trismegistos" target="_blank"><img src=" https://be.dariah.eu/sites/default/files/styles/front_article/public/New%20Project.jpg" alt="DARIAH-BE" height="100px"></a> </div>  <div class="flex-item2"> <p><a href="#texmatcher">TexRelations Matcher</a></p> <p><a href="#geomatcher">GeoRelations Matcher</a></p> <p><a href="#georesponder">GeoResponder</a></p> <p><a href="#geordf">GeoRDF & RDF-extended</a></p> <p><a href="#geotabledump">Geo table dump</a></p> <p><a href="#perresponder">PerResponder</a></p> <p><a href="#perrdf"> PerRDF</a></p> </div>  </div>  </div>  <div id="services" class="container center-align"> <h2 id="texmatcher">TexRelations Matcher</h2> <p class="long-text">The <a href="../dataservices/texrelations/documentation/"target="_blank">TexRelations Matcher</a> is a cross-matching tool to find links to other projects with information about Ancient World texts; this API offers you a JSON, XML and URI-based JSON response in no time and helps you identify related records of 79 other projects. You can use the TM Text ID or any ID coming from one of our partners and find all the other IDs of that same text curated by one of those other projects.</p> <div class="goto-top"><img src="../img/arrowtop.png" /><a href="#top">Back to top</a></div> <h2 id="geomatcher">GeoRelations Matcher</h2> <p class="long-text">The <a href="../dataservices/georelations/documentation" target="_blank">GeoRelations Matcher</a> is a tool based on the same principle as the TexRelations Matcher. It enables you to find other place IDs from partner projects based on any ID from another partner project. This API offers you a JSON, XML and URI-based JSON response in no time. This is a great way to help you organize your own place IDs and look for lacking information in your own database.</p> <p class="long-text">At this moment we offer links to 20 other projects.</p> <div class="goto-top"><img src="../img/arrowtop.png" /><a href="#top">Back to top</a></div> <h2 id="georesponder">GeoResponder</h2> <p class="long-text"><a href="../dataservices/georesponder" target="_blank">This tool</a> is great for people working with geographical data. As an endpoint it can be accessed directly, however we've integrated it in the <a href="../geo/index.php" target="_blank">TM Places </a>portal.</p> <p class="long-text">This tool will show you a GeoJSON response for the TM Geo ID you're looking for. GeoJSON is a standardized file format and easily parsable in scripting languages such as Python and JavaScript to provide a more rich user experience, or applications such as database software to pull in our data. Be sure to check out this Memo on <a href="https://tools.ietf.org/html/rfc7946.html" target="_blank">the RFC7946 GeoJSON format</a>.</p> <div class="goto-top"><img src="../img/arrowtop.png" /><a href="#top">Back to top</a></div> <h2 id="geordf">GeoRDF & RDF-extended</h2> <p class="long-text">This is to be considered a supplementary service to the GeoResponder tool, making the TM Geo data available for linked data projects. There are two separate endpoints: <a href="/dataservices/rdf/geo/index.php" target="_blank">www.trismegistos.org/dataservices/rdf/geo/index.php</a> and <a href="/dataservices/rdf/geo/extended_index.php" target="_blank">www.trismegistos.org/dataservices/rdf/geo/extended_index.php</a>. Both endpoints take an argument <code>?id=</code> followed by the TM Geo ID you're interested in. For convenience this endpoint is also accessible directly via the <a href="../geo/index.php" target="_blank">TM Places </a>portal. Simply go the stable URI of the place you're interested in and append /rdf or /rdfe to the url. These will take you to the default RDF or extended RDF endpoint. </p> <p class="long-text"> e.g. the stable URI for Karyanda is: <a href="/place/3409" target="_blank">www.trismegistos.org/place/3409</a> The TM Geo ID is thus 3409. Using this ID to access the RDF directly can be done via: <a href="/dataservices/rdf/geo/index.php?id=3409" target="_blank">www.trismegistos.org/dataservices/rdf/geo/index.php?id=3409</a>; the direct access to the extended RDF is: <a href="/dataservices/rdf/geo/extended_index.php?id=3409" target="_blank">www.trismegistos.org/dataservices/rdf/geo/extended_index.php?id=3409</a>. Both of these endpoints are also easily accessible through appending <code>/rdf</code> for the default RDF response or <code>/rdfe</code> for the extended RDF response. To follow up on the example of Karyanda: the default RDF can be viewed at <a href="/place/3409/rdf" target="_blank">www.trismegistos.org/place/3409/rdf</a>; whereas the extended response can be viewed at <a href="/place/3409/rdfe" target="_blank">www.trismegistos.org/place/3409/rdfe</a>.</p> <p class="long-text">The extended RDF response (rdfe) offers more data compared to the default RDF response. It outputs text attestations and provides information about each individual attestation of the requested place, and if available it will provide a similar response for authors. </p> <p class="long-text"><strong>Warning: </strong> All of these responses are made server-side, so places that have been attested in thousands of texts take more time to serialize. To keep response times low, the server is configured to only process the first 1000 texts and the first 1000 authors related to a place. Keep this in mind when processing the responses.</p> <div class="goto-top"><img src="../img/arrowtop.png" /><a href="#top">Back to top</a></div> <h2 id="geotabledump">Geo table dump</h2> <p class="long-text">Matching record by record is too slow for you? No problem, we've got you covered! For large scale projects that need a customized dump file of TM Places we recommend them to use the <a href="../dataservices/tabledump" target="_blank"> Geographical data dump tool</a>. Users can customize the response fields by simply checking the data that interests you and choose a CSV or JSON response format. This is the ideal starting point to import our data in another database. Just be sure to follow the <a href="https://creativecommons.org/licenses/by-sa/4.0/" target="_blank">CC BY-SA guidelines</a>.</p> <div class="goto-top"><img src="../img/arrowtop.png" /><a href="#top">Back to top</a></div> <h2 id="perresponder">PerResponder</h2> <p class="long-text"><a href="../dataservices/rdf/per/documentation/" target="_blank">This tool</a> is useful for people working with prosopographical data. As an endpoint it can be accessed directly and we also integrated it in the <a href="../per/search.php" target="_blank">TM People </a>portal.</p> <p class="long-text">This tool will show you a JSON response for the TM Person ID you're looking for.</p> <div class="goto-top"><img src="../img/arrowtop.png" /><a href="#top">Back to top</a></div> <h2 id="perrdf"> PerRDF</h2> <p class="long-text"> We also developed an online endpoint to retrieve person-related data in the RDF format. The default data available at <a href="/dataservices/rdf/per/index.php" target="_blank">www.trismegistos.org/dataservices/rdf/per/index.php</a>. This endpoint takes one mandatory argument <code>?id=</code> followed by the TM Per_ID you're interested in. Optionally you can provide a secondary argument to control file-downloading behavior. By appending <code>&dl=0</code> you ask your browser to display the file, whereas providing <code>&dl=1</code> will ask your browser to download the file directly. This behaviour depends on your browser and how certain functionalities are implemented, as such not every browser behaves in this way. Currently only <em>Mozilla Firefox</em> behaves as intended.</p> <div class="goto-top"><img src="../img/arrowtop.png" /><a href="#top">Back to top</a></div> </div>  </div>    <footer> <div class="wrapper"> <div class="flex"> <section class="footer-col"> <a href="../about">About Trismegistos</a> </section> <section class="footer-col"> <a href="../about_how_to_cite.php">How to cite</a><br> </section> <section class="footer-col"> <a href="../terms-of-use.html">Terms & conditions</a> </section> <section class="footer-col"> Contact: <script language="JavaScript"> var username = "mark.depauw"; var hostname = "kuleuven.be"; var linktext = "<i class='fa fa-envelope' aria-hidden='true'></i>"; document.write("<a class='social' href='" + "mail" + "to:" + username + "@" + hostname + "'>" + linktext + "</a>"); </script> <a class="social" href="http://www.facebook.com/TrismegistosTM" target="_blank"><i class="fa fa-facebook-square fa-lg aria-hidden="true""></i></a> <a class="social" href="https://bsky.app/profile/TrismegistosTM.bsky.social" target="_blank"><img id="bluesky-logo" src="/img/bluesky.png"/></a> </section> <section class="footer-col"> Last update: <div id='updateplaceholder'></div> </section> <script> var xmlhttp = new XMLHttpRequest(); xmlhttp.open("GET", '/lastupdate.txt', false); xmlhttp.send(); if (xmlhttp.status==200) { result = xmlhttp.responseText; document.getElementById('updateplaceholder').innerHTML = result; } </script> <section class="footer-col"> <img id="kul-logo" src="/img/KUL_logo.png"/> </section> <section id="cc-license" class="footer-col"> <a rel="license" target="blank" href="https://creativecommons.org/licenses/by-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-sa/4.0/88x31.png" /></a> </section> </div> </div>  </footer>  <div id='cookie_warning_box'> <p class="cookie-text">This site uses cookies to provide you with the best user experience. By using Trismegistos, you accept <a href='/terms-of-use.html'>our terms and conditions</a>, including the use of cookies.</p> <div id='close_cookie_warning' onClick='close_cookie_warning()'>X CLOSE</div> </div>  </body> </html>

CINXE.COM

Trismegistos Data Services