Interoperability through Library APIs

Library Technology ServicesOpen House

7/30/15

Metadata Digital Content

Inventory Data Sets

API API API APIs

InterestingWeb Apps

The Opportunity

18M titles, authors, subjects, locations, etc

45M Images, books, audio, video

holdingsavailability

scientific datageospatialFaculty papersetc.

Semantic Web

Metadata

http://openmetadata.lib.harvard.edu/

Digital Content

http://library.harvard.edu/digital-collections

How to re-use this stuff?

APIs

Library API landscape• Library Cloud - Unified Metadata API

• Combines silos of descriptive metadata into a single Web Service API• Descriptive info like title, creator, subject – what you see in HOLLIS

• PRESTO – bibliographic item data API• HOLLIS search• Bibliographic data from HOLLIS• PUBMED, DOI, VIA data• Item availability (checked out?)

• Digital content delivery API• International Image Interoperability Framework (IIIF)• DRS delivery services (paged objects, audio, documents)

• In the future: Semantic Web APIs (grant funded development)• Linked Open Data• RDF Triples (no more “records”), SPARQL API

Guiding principles

Support innovation, interoperability, and reuse through:

• Standard HTTP web service API protocols - REST, SPARQL, JSON, XML

• Community supported metadata schemas – e.g. MODS, MARC, Dublin

Core, RDF

• Community supported digital content APIs - IIIF

• Open access

Available today: Library Cloud

● A queryable metadata hub (solr indexed) of Harvard library holdings

● 13M HOLLIS records, 4M visual image records, 2M archival and special collections items

● A pipeline for updating and enriching records● Deployed in Amazon Web Services● Open source software

Library Cloud

5/5/15

books

images

archives

More...

Ingest

DPLA, OCLC

Innovation apps

LD4L BIBFRAME

Normalize EnhanceDistribute

APIOAI-PMH

Metadatasources

AWS Queue pipeline API Consumers

Library Cloud API

http://api.lib.harvard.edu/v2/items?title=peanuts&name=SchulzFaceting

http://api.lib.harvard.edu/v2/items.json?title=bees&facets=name,resourceType

Search on a facethttp://api.lib.harvard.edu/v2/items?title=bees&resourceType=“still image”

Api documentation - https://wiki.harvard.edu/confluence/display/LibraryStaffDoc/LibraryCloud+Item+API

IIIFInternational Image Interoperability Framework

• Opens Harvard library digital content for reuse over the Web and allows Harvard to reuse external content• A content delivery Web API (the digital book or digital image)• Not a discovery API (title, author, subject)

Sample Use CasesTeaching: Displaying a “Virtual manuscript” where Harvard holds some pages and Yale holds other pagesResearch: Comparison of a Harvard and British Library copy of the same workLibrary or Museum: Creating on-line collections that include material from multiple institutions

IIIF

• Harvard University• Bibliothèque Nationale de France• British Library• Oxford University• Stanford University• Johns Hopkins University• University of Fribourg• Saint Louis University• Drew University• TextGrid• Los Alamos National Laboratory

• Yale University• Cambridge University• ARTstor• Cornell University• Princeton University• Walters Art Museum• National Library of Norway• The National Archives (UK)• DPLA• Europeana• … and more – see http://iiif.io/community.html

• Community driven (http:iiif.io)• Defined APIs for digital object linking and reuse• Plug & Play software (such as Mirador)

Mirador

IIIF APIs at the Library

• Image API http://ids.lib.harvard.edu/ids/iiif/5981214/0,0,1200,1200/pct:50/full/native.jpg

• Presentation APIhttp://iiif.lib.harvard.edu/manifests/drs:5981093 Uses the Shared Canvas data model and W3C Open Annotation

• Mirador uses both APIs

PRESTO

• Availability for Moby Dickhttp://webservices.lib.harvard.edu/rest/v2/classic/holdings/006954671

• HOLLIS+ Search for Moby Dick

http://webservices.lib.harvard.edu/rest/v2/hollisplus/search/dc/?q=“Moby Dick”

Metadata(Titles, Authors,

Subjects, etc)

Digital Images

InventoryHoldings,

availability, etc

Data SetsSocial science, astronomy, GIS

Library Cloud API IIIF API PRESTO API Open APIs

InterestingWeb App

OPEN APIS - Third parties can reuse, embed, and repurpose library data…

HOLLISVIAOASIS…

Harvard DRSHarvard Canvas?HarvardX?

AlephHOLLIS+…

DataverseHGLDASH

Data sources 5/5/15

Examples● Mirador● Digital collection builder● DRS metadata migration tool — to efficiently retrieve

descriptive metadata for migrated digital objects● Library hackathon apps

o On an Amazon page, a button tells you if the book is in Harvard Library

o Visualization of library content via Google Fusiono List Harvard of relevant items for a feminist web siteo Search the Library from Android phoneo Which library is best for a particular subject?

http://which-harvard-library.hankswaydwa15.me/

The Future

Tim Berners-Lee’s 4 Rules for the Semantic Web

1. Use URIs as names for things 2. Use HTTP URIs so that people can look up

those names. 3. When someone looks up a URI, provide

useful information, using the standards (RDF*, SPARQL)

4. Include links to other URIs, so that they can discover more things.

Semantic Web API (linked data grant project)

• Uses RDF, the language of the web

• thisBook “has title” “Moby Dick”– “thisBook” is a URI:

http://id.lib.harvard.edu/aleph/006954671/catalog

– “has title” is a URI: http://purl.org/dc/elements/1.1/title

– “Moby Dick” is a URI: http://www.melville.org/hmmoby.htm

• One uniform API for querying and inferencing (SPARQL)

http://lod-cloud.net/

Thank you!

Reference - API DocumentationAPI Documentation

Library Cloud https://wiki.harvard.edu/confluence/display/LibraryStaffDoc/Library+Cloud

PRESTO http://hul.harvard.edu/ois/systems/webservices/#lookup

Dataverse http://thedata.harvard.edu/guides/dataverse-api-main.html

Course reserves https://github.com/harvard-library/ecru/blob/master/ecru_url_patterns.md

DRS Delivery Services

http://hul.harvard.edu/ois/ for Image Delivery Service, File Delivery Service, Streaming Delivery Service, Full Text Search Service

DASH http://openmetadata.lib.harvard.edu/content/digital-access-scholarship-harvard-dash-dataset

Appendix B - Bulk download documentation

Dataset Documentation

Bibliographic data set http://openmetadata.lib.harvard.edu/bibdata

Virtual Collection OAI-PMH data provider

http://hul.harvard.edu/ois/systems/ctools/vc-harvesting.html

Harvard Geospatial Library OAI data provider

http://thedata.harvard.edu/guides/dataverse-api-main.html#data-sharing-api