CINXE.COM
About the Site and API 芦 Georgia Historic Newspapers
<!DOCTYPE html> <html lang="en"> <head profile="http://dublincore.org/documents/2008/08/04/dc-html/"> <meta charset="utf-8"> <meta http-equiv="Content-Type" content="text/html" /> <meta http-equiv="Content-Language" content="en-us" /> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <link href="/static/images/favicon.e04f06a289da.png" rel="icon" sizes="192x192"> <link rel="search" href="/search/pages/opensearch.xml" type="application/opensearchdescription+xml" title="Georgia Historic Newspapers Page Search" /> <meta name="author" content="Digital Library of Georgia"> <meta name="description" content="Free archive of digitized historic newspapers from Georgia 1763鈥損resent"> <title> About the Site and API 芦 Georgia Historic Newspapers </title> <!-- CSS --> <link rel="stylesheet" href="/static/CACHE/css/output.5d02637eedf9.css" type="text/css"> <!-- JavaScript --> <script src="/static/vendor/jquery/jquery.min.8fb8fee4fcc3.js"></script> <script src="/static/vendor/bootstrap/js/bootstrap.min.2f34b630ffe3.js"></script> <script> $(function() { $('ul.nav > li > a[href="' + document.location.pathname + '"]') .parent().addClass('active'); }); </script> <script type="text/javascript"> function pageSpecificHeaderChanges() { // We sometimes (currently just on the homepage) add an alternative // skip link to replace the #maincontent skip link. In this case // the #maincontent link gets hidden (including from screen readers) // with CSS. However, some accessiblity tools assume it is erroneously // hidden and flag it. Here we remove the already-hidden link from // the DOM to prevent such false positives. $('.skiplink[href="#maincontent"]:hidden').remove(); // Open ONI includes a basic script for adding the active class for nav // elements that whose href is the current URL. This handles some cases // where we want the element highlighted but the URL is not exact. // whitelist of classes that represent legitimate pages so we don't run on 404s, etc if (!$('#std_box, .static-page-body, .search_results_body, .places-browse, .type-browse').length) return; // handle selecting dropdown menus when the current page is a subitem $('.dropdown-menu a[href]').each(function (i, el) { if (document.location.pathname.startsWith($(el).attr('href'))) { $(el).closest('ul.nav > li').addClass('active'); } }); // handle selecting "Browse Issues By Date" and "View Front Pages" // when not on first page of either of those views // Will be the button URL plus one more numerical path component. $('ul.nav>li>a#page_nav_issues[href]').each(function(i, el){ if ((new RegExp('^' + $(el).attr('href') + '/?[0-9]*/?$')).exec(document.location.pathname)) { $(el).parent().addClass('active'); } }); } $(pageSpecificHeaderChanges); </script> <script async src="https://www.googletagmanager.com/gtag/js?id=G-292KXH39NG"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'G-292KXH39NG'); </script> <!-- Page Content Metadata --> </head> <body> <header class="site_header"> <a class="skiplink sr-only sr-only-focusable" href="#maincontent"> Skip to main content </a> <script type="text/javascript"> (function () { const bannersDismissed = (localStorage['bannersDismissed'] && JSON.parse(localStorage['bannersDismissed'])) || {}; function showBanner(banner) { $(banner).removeClass('hide'); $(banner).on('close.bs.alert', function() { bannersDismissed[$(banner).text()] = true; localStorage['bannersDismissed'] = JSON.stringify(bannersDismissed); }); } $('.banner.hide').each(function(i, banner) { if (!bannersDismissed[$(banner).text()]) showBanner(banner); }); })(); </script> <div class="topbar"> <div class="container"> <div class="row desktop-logos"> <div class="col-xs-7 dlg-header-logo"> <a href="http://dlg.galileo.usg.edu/"><img src="/static/images/logos-desktop/logo-dlg.617ec8e0c477.svg" alt="Digital Library of Georgia: Sharing Georgia's History & Culture Online" class="img-responsive" width="307.852" height="33"></a> </div> <div class="col-xs-5 galileo-header-logo"> <a href="https://www.galileo.usg.edu/" class="galileo-logo"><img src="/static/images/logos-desktop/logo-galileo.7ba4e970a22b.svg" alt="GALILEO" class="img-responsive" width="166.258" height="22"></a> <a href="https://libs.uga.edu/" class="ugalibs-logo"><img src="/static/images/logos-desktop/logo-uga.93866ee50614.svg" alt="University Libraries, University of Georgia" class="img-responsive" width="171.062" height="33"></a> </div> </div> <div class="row mobile-logos"> <div class="col-xs-4 dlg-mobile-logo-column"> <a href="http://dlg.galileo.usg.edu/" aria-label="DLG Homepage Link" title="DLG Homepage Link"> <img src="/static/images/logos-mobile/logo-dlg.86f86b6661f8.svg" alt="Digital Library of Georgia Logo" width="30.916" height="35"> <span>Digital Library of Georgia</span> </a> </div> <div class="col-xs-4 galileo-mobile-logo-column"> <a href="https://www.galileo.usg.edu/" class="galileo-logo" aria-label="GALILEO Homepage Link" title="GALILEO Homepage Link"> <img src="/static/images/logos-mobile/logo-galileo.c2bef70f7d5e.svg" alt="GALILEO Logo" width="78.851" height="35"> <span>GALILEO</span> </a> </div> <div class="col-xs-4 uga-mobile-logo-column"> <a href="https://libs.uga.edu/" class="ugalibs-logo" aria-label="UGA Libraries Homepage Link" title="UGA Libraries Homepage Link"> <img src="/static/images/logos-mobile/logo-uga.f720937f2d22.svg" alt="UGA University Libraries Logo" width="24.102" height="35"> <span>UGA Libraries</span> </a> </div> </div> </div> </div> <div class="header_title"> <div class="container"> <h1 class="title"><a href="/">Georgia Historic Newspapers</a></h1> </div> </div> <div class="modal harmful-content-modal" tabindex="-1" role="dialog" aria-labelledby="harmful-content-modal-title"> <div class="modal-dialog" role="document"> <div class="modal-content"> <div class="modal-header"> <button type="button" class="close" data-dismiss="modal" aria-label="Close"> <span aria-hidden="true">×</span> </button> <h2 class="modal-title" id="harmful-content-modal-title">Potentially Harmful Content</h2> </div> <div class="modal-body"> <p>Some content (or its descriptions) found on this site may be harmful and difficult to view. These materials may be graphic or reflect biases. In some cases, they may conflict with strongly held cultural values, beliefs or restrictions. We provide access to these materials to preserve the historical record, but we do not endorse the attitudes, prejudices, or behaviors found within them.</p> </div> <div class="modal-footer"> <a href="/about/harmful_content" type="button" class="btn btn-secondary more-harmful-content-info-button">Find out more</a> <button type="button" class="btn btn-primary" data-dismiss="modal">Close</button> </div> </div> </div> </div> <script type="text/javascript"> (function (){ function setModalSeenCookie() { var cookieExpDate = (new Date(Date.now() + 90 * 24 * 60 * 60 * 1000)).toUTCString(); document.cookie = 'harmful_content_modal_seen=1;expires=' + cookieExpDate + ';path=/;Secure;SameSite=Lax'; } if (document.cookie.indexOf('harmful_content_modal_seen=1') > -1) { setModalSeenCookie(); // push back expiration date return; } $('.more-harmful-content-info-button').click(setModalSeenCookie); $('.harmful-content-modal').modal({ open: true }).on('hide.bs.modal', setModalSeenCookie); })(); </script> <nav class="navbar navbar-default dlg-navbar"> <div class="container"> <div class="navbar-header"> <button type="button" class="navbar-toggle collapsed" aria-expanded="false" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1"> <span class="sr-only">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> </div> <div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1"> <ul class="nav navbar-nav"> <li><a href="/">Home</a></li> <li> <a href="/search/advanced/"> Advanced Search </a> </li> <li> <a href="#" class="dropdown-toggle" data-toggle="dropdown" aria-expanded="false"> Browse <span class="caret"></span> </a> <ul class="dropdown-menu"> <li><a href="/newspapers/">Browse by Title</a></li> <li><a href="/issues/">Browse by Date</a></li> <li><a href="/cities">Browse by City</a></li> <li><a href="/counties">Browse by County</a></li> <li><a href="/types">Browse by Type</a></li> </ul> </li> </ul> <ul class="nav navbar-nav navbar-right"> <li> <a href="#" class="dropdown-toggle" data-toggle="dropdown" aria-expanded="false"> News <span class="caret"></span> </a> <ul class="dropdown-menu" role="menu" aria-labelledby=""> <li role="menu" role="presentation"> <a href="https://blog.dlg.galileo.usg.edu/?tag=forthcoming-newspapers" role="menuitem">Forthcoming Newspapers</a> </li> <li role="menu" role="presentation"> <a href="https://blog.dlg.galileo.usg.edu/?tag=newspaper-releases" role="menuitem">Newspaper Releases</a> </li> </ul> </li> <li> <a href="#" class="dropdown-toggle" data-toggle="dropdown" aria-expanded="false"> About <span class="caret"></span> </a> <ul class="dropdown-menu" role="menu" aria-labelledby=""> <li role="menu" role="presentation"> <a href="/about" role="menuitem">The Site</a> </li> <li role="menu" role="presentation"> <a href="/about/participate" role="menuitem">Participate</a> </li> <li role="menu" role="presentation"> <a href="/about/harmful_content" role="menuitem">Harmful Content</a> </li> <li role="menu" role="presentation"> <a href="/about/contact" role="menuitem">Contact Us</a> </li> <li role="menu" role="presentation"> <a href="/about/resources" role="menuitem">Additional Resources</a> </li> <li role="menu" role="presentation"> <a href="/about/copyright" role="menuitem">Copyright & Reuse</a> </li> <li role="menu" role="presentation"> <a href="/about/partners" role="menuitem">Partners</a> </li> <li role="menu" role="presentation"> <a href="/about/api" role="menuitem">GHN API</a> </li> <li role="menu" role="presentation"> <a href="https://sites.google.com/view/ghn-presskits" role="menuitem">Press Kit</a> </li> </ul> </li> <li> <a href="#" class="dropdown-toggle" data-toggle="dropdown" aria-expanded="false"> Help <span class="caret"></span> </a> <ul class="dropdown-menu" role="menu" aria-labelledby=""> <li role="menu" role="presentation"> <a href="/help/browsing" role="menuitem">Browsing</a> </li> <li role="menu" role="presentation"> <a href="/help/searching" role="menuitem">Searching</a> </li> <li role="menu" role="presentation"> <a href="/help/viewing" role="menuitem">Viewing</a> </li> <li role="menu" role="presentation"> <a href="/help/clipping" role="menuitem">Clipping</a> </li> <li role="menu" role="presentation"> <a href="/help/faq" role="menuitem">FAQ</a> </li> </ul> </li> </ul> <div> </div> </div></div> <div class="container-fluid top-nav-search"> <div class="container"> <form method="get" action="/search/pages/results/" role="search"> <div class="input-group"> <div class="input-group-addon"><label for="search-newspaper-contents">Search</label></div> <input id="search-newspaper-contents" class="form-control" type="text" name="proxtext"> <span class="input-group-btn"> <button type="submit" class="btn btn-primary" aria-label="Submit search" title="Submit search"> <span class="glyphicon glyphicon-search" aria-hidden="true"></span> </button> </span> </div> </form> </div> </div> </div> </div> </nav> </header> <div class="main_content"> <div class="container"> <ol class="breadcrumb"> <li> <a href="/">Home</a> </li> <li> <a href="/about">About</a> </li> <li> <a href="/about/api">GHN API</a> </li> </ol> <div id="maincontent"></div> <div class="static-page-body"> <h2 id="about-the-site-and-api">About the Site and API</h2> <h3 id="introduction">Introduction</h3> <p>Open ONI provides access to information about digitized newspaper pages. To encourage a wide range of potential uses, we designed several different views of the data we provide, all of which are publicly visible. Each uses common Web protocols, and access is not restricted in any way. You do not need to apply for a special key to use them. Together they make up an extensive application programming interface (API) which you can use to explore all of our data in many ways.</p> <p>Details about these interfaces are below. In case you want to dive right in, though, we use HTML link conventions to advertise the availability of these views. If you are a software developer or researcher or anyone else who might be interested in programmatic access to the data in Open ONI, we encourage you to look around the site, "view source" often, and follow where the different links take you to get started.</p> <p>For more information about the open source Open ONI software please see <a href="https://github.com/open-oni/open-oni">Open ONI on GitHub</a>. Also, please consider subscribing to the <a href="http://listserv.loc.gov/archives/chronam-users.html">chronam-users</a> discussion list if you want to discuss how to use or extend the software or data from its APIs.</p> <h3 id="the-api">The API</h3> <h4 id="jump-to">Jump to:</h4> <ul> <li><a href="#searching-newspaper-pages-using-opensearch">Search</a> the newspaper directory and digitized page contents using OpenSearch.</li> <li><a href="#link-to-open-oni-resources">Link</a> using our stable URL pattern for Open ONI resources.</li> <li><a href="#iiif-views">IIIF</a> views of Open ONI resources.</li> <li><a href="#linked-data">Linked Data</a> views of Open ONI resources.</li> <li><a href="#bulk-data">Bulk Data</a> for research and external services.</li> <li><a href="#cors-and-jsonp-support">CORS and JSONP</a> support for your JavaScript applications.</li> </ul> <h4 id="searching-newspaper-pages-using-opensearch">Searching newspaper pages using OpenSearch</h4> <p>Searching newspaper pages is possible via OpenSearch. This is advertised in a LINK header element of the site's HTML template as "Open ONI Page Search", using <a href="https://gahistoricnewspapers.galileo.usg.edu/search/pages/opensearch.xml">this OpenSearch Description document</a>.</p> <ul> <li>andtext: the search query</li> <li>format: 'html' (default), or 'json', or 'atom' (optional)</li> <li>page: for paging results (optional)</li> </ul> <p>Examples:</p> <ul> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/search/pages/results/?andtext=thomas">https://gahistoricnewspapers.galileo.usg.edu/search/pages/results/?andtext=thomas</a><br /> search for "thomas", HTML response</li> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/search/pages/results/?andtext=thomas&format=atom">https://gahistoricnewspapers.galileo.usg.edu/search/pages/results/?andtext=thomas&format=atom</a><br /> search for "thomas", Atom response</li> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/search/pages/results/?andtext=thomas&format=atom&page=11">https://gahistoricnewspapers.galileo.usg.edu/search/pages/results/?andtext=thomas&format=atom&page=11</a><br /> search for "thomas", Atom response, starting at page 11</li> </ul> <p><a href="#introduction">Return to Top</a></p> <h4 id="link-to-open-oni-resources">Link to Open ONI Resources</h4> <p>Open ONI uses links that follow a straightforward pattern. You can use this pattern to construct links into specific newspaper titles, to any of its available issues and their editions, and even to specific pages. These links can be readily bookmarked and shared on other sites.</p> <p>We are committed to supporting this link pattern over time, so even if we change how the site works, we will redirect any requests to the system using this specific pattern.</p> <p>The link pattern uses <a href="http://www.loc.gov/marc/lccn.html">LCCNs</a>, dates, issue numbers, edition numbers, and page sequence numbers.</p> <p>Examples:</p> <ul> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/">https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/</a><br /> title information for LCCN sn 86069873</li> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1/">https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1/</a><br /> first available edition from Dec. 30, 1865</li> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1/seq-1/">https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1/seq-1/</a><br /> first available page from first edition, January 5, 1900</li> </ul> <p><a href="#introduction">Return to Top</a></p> <h4 id="iiif-views">IIIF Views</h4> <p>In addition to the use of JSON in OpenSearch results, there are also <a href="http://iiif.io/">IIIF</a> Presentation API and Image API JSON views available for various resources. These IIIF views are typically linked from their HTML representation using the <link> element. For example:</p> <ul> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351.json">https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351.json</a><br /> title information for LCCN sn86069873 as an IIIF Collection</li> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1.json">https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1.json</a><br /> first available edition from January 5, 1900 as an IIIF Manifest</li> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1/seq-1.json">https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1/seq-1.json</a><br /> first available page from first edition, January 5, 1900 as an IIIF Canvas</li> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/newspapers.json">https://gahistoricnewspapers.galileo.usg.edu/newspapers.json</a><br /> a list of all newspaper titles for which there is digital content represented as a IIIF Collection</li> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/reports/batches.json">/reports/batches.json</a><br /> a list of all batches of content that have been loaded</li> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/reports/batches/batch_dlc_fairview_ver01.json">https://gahistoricnewspapers.galileo.usg.edu/reports/batches/batch_dlc_fairview_ver01.json</a><br /> detailed information about a specific batch as a IIIF Collection</li> </ul> <p><a href="#introduction">Return to Top</a></p> <h4 id="linked-data">Linked Data</h4> <p><a href="http://linkeddata.org/">Linked Data</a> allows us to connect the information in Open ONI directly to related data on the Web explicitly. Open ONI provides several Linked Data views to make it easy to connect with other information resources and to process and analyze newspaper information with conceptual precision.</p> <p>We use concepts like Title (defined in <a href="http://dublincore.org/documents/dcmi-terms/">DCMI Metadata Terms</a>) and Issue (defined in <a href="http://bibliontology.com/">the Bibliographic Ontology</a>) to describe newspaper titles and issues available in the data. Using these concepts, defined in existing ontologies, can help to ensure that what we mean by "title" and "issue" is consistent with the intent of other publishers of linked data.</p> <p>These elements are used in RDF views of several types of pages, ranging from a list of the newspaper titles available on the site and information about each, to enumerations of all the pages that make up each issue and all of the files available for each page.</p> <p>Examples:</p> <ul> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351.rdf">https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351.rdf</a>: information about <a href="https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/">The colored American.</a></li> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1.rdf">https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1.rdf</a>: information about <a href="https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1/">The colored American. [1865-12-30]</a></li> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1/seq-1.rdf">https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1/seq-1.rdf</a>: details about all of the files associated with the <a href="https://gahistoricnewspapers.galileo.usg.edu/lccn/sn82014351/1865-12-30/ed-1/seq-1/">The colored American. (Augusta, Ga.) 1865-1866, December 30, 1865, Image 1</a></li> <li><a href="https://gahistoricnewspapers.galileo.usg.edu/newspapers.rdf">https://gahistoricnewspapers.galileo.usg.edu/newspapers.rdf</a>: list of <a href="https://gahistoricnewspapers.galileo.usg.edu/newspapers/">available newspaper titles</a></li> </ul> <p>Comparing the RDF versions of the links above with their HTML counterpart links, you might notice that the URI pattern we follow for these views is to remove the final slash, replacing it with ".rdf". We follow this pattern to comply with best practices for publishing linked data, and also to keep the URIs easy to understand and use.</p> <p>For each of the HTML pages with a linked data counterpart in RDF, we provide links to those alternate views from the HTML page using the LINK header element. This can support automating the process of using the RDF data in tools like bookmarklets, plugins, and scripts, and it also helps us to advertise the availability of the additional views. In many views, such as newspaper page images, we also provide LINK elements pointing to the various available files (image, text, OCR coordinate XML) for each available page or other potentially useful information. We encourage you to explore the entire site and to look for and use these LINK elements. Just follow your nose, and view the source.</p> <p>In addition to the concepts describe above, we use concepts from several other vocabularies in describing materials and also in linking to related data available on other sites. These additional vocabularies and external sites include:</p> <ul> <li><a href="http://dbpedia.org/">DBpedia</a></li> <li><a href="http://purl.org/dc/elements/1.1/">Dublin Core</a> and <a href="http://dublincore.org/documents/dcmi-terms/">DCMI Terms</a></li> <li><a href="http://purl.org/vocab/frbr/core#">FRBR concepts in RDF</a></li> <li><a href="http://sws.geonames.org/">GeoNames</a></li> <li><a href="http://lccn.loc.gov/">LCCN Permalink</a></li> <li><a href="http://www.lingvoj.org/">lingvoj.org</a></li> <li><a href="http://www.openarchives.org/ore/">OAI-ORE</a> (more about aggregations below)</li> <li><a href="http://www.w3.org/2002/07/owl#">OWL</a></li> <li><a href="http://metadataregistry.org/schema/show/id/1.html">RDA</a></li> <li><a href="http://www.worldcat.org/">WorldCat</a></li> </ul> <p>We are grateful to all of these providers and we hope we can follow their lead in encouraging additional connections between data and vocabulary providers. Please be aware that how we use these vocabularies will likely change over time, as they continue to develop, and as new vocabularies are introduced.</p> <p><a href="#introduction">Return to Top</a></p> <h4 id="bulk-data">Bulk Data</h4> <p>In certain situations the granular access provided by the API may be somewhat constraining. For example, perhaps you are a researcher who would like to try out new indexing techniques on the millions of pages of OCR data. Or perhaps you are a service provider and anticipate needing to support a high volume of fulltext searches across the corpus, and do not want the Open ONI API as an external dependency. To support these and other potential use cases we are beginning to provide bulk access to the underlying data sets. The initial bulk data sets include:</p> <ul> <li>Batches: each batch of digitized content is made available via the Batches <a href="https://gahistoricnewspapers.galileo.usg.edu/reports/batches">HTML</a>, <a href="https://gahistoricnewspapers.galileo.usg.edu/reports/batches/feed">Atom</a> and <a href="https://gahistoricnewspapers.galileo.usg.edu/reports/batches.json">JSON</a> views. These views provide links to where the files comprising the batch can be fetched with a web crawling tool like <a href="http://www.gnu.org/software/wget/">wget</a>.</li> <li>OCR Bulk Data: the complete set of OCR XML and text files that make up the newspaper collection are made available as compressed archive files. These files are listed in the <a href="https://gahistoricnewspapers.galileo.usg.edu/ocr/">OCR</a> report, and are also made available via <a href="https://gahistoricnewspapers.galileo.usg.edu/ocr/feed/">Atom</a> and <a href="https://gahistoricnewspapers.galileo.usg.edu/ocr.json">JSON</a> feeds that will allow you to build automated workflows for updating your local collection.</li> </ul> <p><a href="#introduction">Return to Top</a></p> <h4 id="cors-and-jsonp-support">CORS and JSONP Support</h4> <p>To help you integrate Open ONI into your JavaScript applications, the OpenSearch and AutoSuggest JSON responses support both <a href="http://www.w3.org/TR/cors/">Cross-Origin Resource Sharing (CORS)</a> and <a href="http://en.wikipedia.org/wiki/JSONP">JSON with Padding (JSONP)</a>. CORS and JSONP allow your JavaScript applications to talk to services without the need to proxy the requests yourself.</p> <h5 id="cors-example">CORS Example</h5> <pre><code>curl -i 'http://chroniclingamerica.loc.gov/suggest/titles/?q=manh' HTTP/1.1 200 OK Date: Mon, 28 Mar 2011 19:45:34 GMT Expires: Tue, 29 Mar 2011 19:45:37 GMT ETag: "7d786bec2ca003d86009f8ccdfd72912" Cache-Control: max-age=86400 Access-Control-Allow-Origin: * Access-Control-Allow-Headers: X-Requested-With Content-Length: 7045 Last-Modified: Mon, 28 Mar 2011 19:45:37 GMT Content-Type: application/x-suggestions+json [ "manh", [ "Manhasset life. (Manhasset, N.Y.) 19??-19??", "Manhasset mail. (Manhasset, N.Y.) 1927-1986" ], [ "sn97063690", "sn95071148" ], [ "http://chroniclingamerica.loc.gov/lccn/sn97063690/", "http://chroniclingamerica.loc.gov/lccn/sn95071148/" ] ] </code></pre> <h5 id="jsonp-example">JSONP Example</h5> <pre><code>curl -i 'http://chroniclingamerica.loc.gov/suggest/titles/?q=manh&callback=suggest' HTTP/1.1 200 OK Date: Mon, 28 Mar 2011 19:45:34 GMT Expires: Tue, 29 Mar 2011 19:45:37 GMT ETag: "7d786bec2ca003d86009f8ccdfd72912" Cache-Control: max-age=86400 Access-Control-Allow-Origin: * Access-Control-Allow-Headers: X-Requested-With Content-Length: 7045 Last-Modified: Mon, 28 Mar 2011 19:45:37 GMT Content-Type: application/x-suggestions+json suggest([ "manh", [ "Manhasset life. (Manhasset, N.Y.) 19??-19??", "Manhasset mail. (Manhasset, N.Y.) 1927-1986" ], [ "sn97063690", "sn95071148" ], [ "http://chroniclingamerica.loc.gov/lccn/sn97063690/", "http://chroniclingamerica.loc.gov/lccn/sn95071148/" ] ]); </code></pre> <p>CORS is arguably a more elegant solution, and is supported by most modern browsers. However JSONP might be a better option if your application needs legacy browser support.</p> </div> </div> </div> <footer id="footer"> <div class="container"> <div class="row main-row"> <div class="col-sm-8"> <div class="footer-panel"> <h2>Are you interested in including a title in the archive?</h2> <a href="/about/participate" class="btn btn-primary">Get Involved</a> </div> </div> <div class="col-sm-4"> <h2 class="social-heading">Follow Us!</h2> <ul class="social-icons"> <li> <a href="https://www.facebook.com/DigitalLibraryofGeorgia" title="Visit DLG on Facebook"> <span aria-hidden="true"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" height="36"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc. --><path d="M512 256C512 114.6 397.4 0 256 0S0 114.6 0 256C0 376 82.7 476.8 194.2 504.5V334.2H141.4V256h52.8V222.3c0-87.1 39.4-127.5 125-127.5c16.2 0 44.2 3.2 55.7 6.4V172c-6-.6-16.5-1-29.6-1c-42 0-58.2 15.9-58.2 57.2V256h83.6l-14.4 78.2H287V510.1C413.8 494.8 512 386.9 512 256h0z"/></svg> </span> </a> </li> <li> <a href="https://twitter.com/diglibga" title="Visit DLG on Twitter/X"> <span aria-hidden="true"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" height="36"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc. --><path d="M389.2 48h70.6L305.6 224.2 487 464H345L233.7 318.6 106.5 464H35.8L200.7 275.5 26.8 48H172.4L272.9 180.9 389.2 48zM364.4 421.8h39.1L151.1 88h-42L364.4 421.8z"/></svg> </span> </a> </li> <li> <a href="http://blog.dlg.galileo.usg.edu/" title="Visit DLG's Blog"> <span aria-hidden="true"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512" height="36"><!--! Font Awesome Free 6.5.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc. --><path d="M64 32C28.7 32 0 60.7 0 96V416c0 35.3 28.7 64 64 64H384c35.3 0 64-28.7 64-64V96c0-35.3-28.7-64-64-64H64zM96 136c0-13.3 10.7-24 24-24c137 0 248 111 248 248c0 13.3-10.7 24-24 24s-24-10.7-24-24c0-110.5-89.5-200-200-200c-13.3 0-24-10.7-24-24zm0 96c0-13.3 10.7-24 24-24c83.9 0 152 68.1 152 152c0 13.3-10.7 24-24 24s-24-10.7-24-24c0-57.4-46.6-104-104-104c-13.3 0-24-10.7-24-24zm0 120a32 32 0 1 1 64 0 32 32 0 1 1 -64 0z"/></svg> </span> </a> </li> </ul> </div> </div> <div class="row"> <div class="footer-blurb"> <p>Some content (or its descriptions) found on this site may be harmful and difficult to view. These materials may be graphic or reflect biases. In some cases, they may conflict with strongly held cultural values, beliefs or restrictions. We provide access to these materials to preserve the historical record, but we do not endorse the attitudes, prejudices, or behaviors found within them. <a href="/about/harmful_content">Read our statement on potentially harmful content.</a></p> <p>The Georgia Historic Newspapers database is a project of the Digital Library of Georgia in partnership with GALILEO and the University of Georgia Libraries. The project is supported with federal LSTA funds administered by the Institute of Museum and Library Services through the Georgia Public Library Service, a unit of the Board of Regents of the University System of Georgia.</p> <p><a href="https://about.galileo.usg.edu/about/accessibility">Accessibility</a> | Powered by <a href="https://open-oni.github.io/">Open ONI</a></p> </div> </div> </div> </footer> </body> </html>