Using WorldCat Grid Services in Library Applications

1
Using WorldCat Grid Services in Library
Applications

• Roy Tennant
• Senior Program Officer
• OCLC Research

2
(No Transcript)
3
What Are WorldCat Grid Services?

• A pretentious name for something quite simple
• Application Programming Interfaces (APIs)
  structured methods for one application to
  exchange data with another application
• Example services
• Identifier Services (e.g., xISBN, xISSN, etc.)
• Registry Services (e.g., Institution Registry,
  etc.)
• Experimental Services (e.g., Terminologies,
  Metadata Crosswalk, etc.)
• WorldCat Search API

4
(No Transcript)
5
Why WorldCat Grid Services?

• Expose our data and services to other
  applications for both internal and external use
  to
• Gain internal operational efficiencies
• Provide added value to member libraries (free to
  members)
• Develop community to advise us with our network
  service strategy

6
WorldCat Grid Developers Network

• Developers Network (http//worldcat.org/devnet)
• Documentation who are we kidding? (wiki)
• Communication we talk, you listen (blog,
  discussion list)
• Infrastructure for collaboration believe it when
  you see it (wiki, code repository)
• Web services pilots forever beta
• Sponsorship of events AKA beer drinking
  opportunities (e.g., Hackathon)

7
WorldCat Hackathon

• November 7-8
• New York City NYPL Science,
• Industry, and Business Library
• Register now at
• worldcat.org/devnet/

8
(No Transcript)
9
(No Transcript)
10
(No Transcript)
11
(No Transcript)
12
Terminology Services

• Search descriptions of controlled vocabularies
• Search for concepts/headings in a controlled
  vocabulary
• Retrieve a single concept/heading record by its
  identifier
• Retrieve concepts/headings in multiple
  representations including HTML, MARC XML, Zthes,
  and SKOS
• Search using SRU CQL syntax

13
Terminology Services Vocabularies
14
(No Transcript)
15
110 Million Records 1.3 Billion Holdings
16
The WorldCat Search API

• Used by applications, not by people
• OpenSearch and SRU searches
• XML responses RSS, Atom, MARC21 XML, Dublin Core
• RESTful all request parameters are sent in a
  URL
• Hackable (in a good way) remove parts of the
  URL and get something useful in return can guess
  at appropriate URL elements

17
The WorldCat Search API

• A broad range of indexes, including a way to
  limit searches by holding library, for
  authenticated users
• Other users search a smaller set of indexes,
  similar to those in the WorldCat.org advanced
  search

18
The WorldCat Search API

• Sort by relevance, author, title, date, library
  count, and more
• List libraries that hold a title
• Sort libraries geographically
• Get standard citations APA, Chicago, Harvard,
  MLA, and Turabian

19
Implementers Overview
The Search API overview describes all of its
features with working examples, links to other
resources, and more. Find the overview on the
OCLC Developers Network site at
http//worldcat.org/devnet/.
20
Test Requests and Responses
The URI Evaluator offers an easy way to test API
requests and evaluate their responses.
21
Anatomy of a Search API Request
http//
worldcat.org/
webservices/catalog/search/
worldcat/
opensearch?
qcivil20war
formatrss
Defaults allow for simpler URLs http//worldcat.o
rg/webservices/catalog/search/?querycivil20war

• Start with the protocol
• Add the host name
• Name the type of service resource
• Name the database to be searched
• Choose the search protocol
• Include search terms
• Select the format of the response

22
An OpenSearch Response
lt?xml version"1.0" encoding"UTF-8"
standalone"no"?gt ltrss xmlnscontent"http//purl.
org/rss/1.0/modules/content/" xmlnsatom"http//
www.w3.org/2005/Atom" xmlnsopensearch"http//a9.
com/-/spec/opensearch/1.1/" xmlnssrw"http//www
.loc.gov/zing/srw/" version"2.0"gt ltchannelgt ltti
tlegtOCLC Worldcat Search civil
warlt/titlegt ltlinkgthttp//worldcat.org/webservices/
catalog/search/worldcat/ opensearch?qcivilwaram
pstart1ampcount10ampformatrsslt/linkgt ltdesc
riptiongtSearch results for "civil war" at
http//worldcat.org/ webservices/cataloglt/descript
iongt ltopensearchtotalResultsgt253694lt/opensearcht
otalResultsgt ltopensearchstartIndexgt1lt/opensearch
startIndexgt ltopensearchitemsPerPagegt10lt/opensearc
hitemsPerPagegt ltatomlink rel"search"
type"application/opensearchdescriptionxml"
href"http//worldcat.org/ webservices/catalog/ope
nsearch.description.xml"/gt ltopensearchQuery
role"request" searchTerms"civil war"
startPage"1"/gt ltitemgt lttitlegtThe red badge of
courage an episode of the American Civil
Warlt/titlegt ltauthorgt ltnamegtCrane, Stephen,
1871-1900.lt/namegt lt/authorgt ltlinkgthttp//worldcat
.org/oclc/8114241lt/linkgt ltguid isPermaLink"false"
gthttp//worldcat.org/oclc/8114241lt/guidgt ltcontent
encodedgtCrane, Stephen newly edited from
Crane's original manuscript by Henry Binder.
ltugtThe red badge of courage an episode of
the American Civil Warlt/ugt. New York
Norton, 1982.lt/contentencodedgt lt/itemgt
Heres the result size ltopensearchtotalResultsgt
253694 lt/opensearchtotalResultsgt
Heres an MLA-formatted citation ltcontentencode
dgt Crane, Stephen newly edited from Crane's
original manuscript by Henry Binder.
ltugtThe red badge of courage an episode
of the American Civil Warlt/ugt. New York
Norton, 1982. lt/contentencodedgt
Heres a title of one record in the
result lttitlegt The red badge of courage an
episode of the American Civil War lt/titlegt
Heres a link to the record in WorldCat.org ltlin
kgt http//worldcat.org/oclc/8114241 lt/linkgt
23
An SRU Response
lt?xml version"1.0" encoding"UTF-8"
standalone"no"?gt lt?xml-stylesheet
type"text/xsl" href"/webservices/catalog/xsl/sea
rchRetrieveResponse.xsl"?gt ltsearchRetrieveResponse
xmlns"http//www.loc.gov/zing/srw/"
xmlnsxsi"http//www.w3.org/2001/XMLSchema-insta
nce"gt ltversiongt1.1lt/versiongt ltnumberOfRecordsgt2674
68lt/numberOfRecordsgt ltrecordsgt ltrecordgt ltrecordSch
emagtinfosrw/schema/1/marcxml-v1.1lt/recordSchemagt
ltrecordPackinggtxmllt/recordPackinggt ltrecordDatagt ltr
ecord xmlns"http//www.loc.gov/MARC21/slim" ltcont
rolfield tag"001"gt8114241lt/controlfieldgt ltcontrol
field tag"008"gt811217s1982 nyu b 000 1 eng
lt/controlfieldgt ltdatafield tag"020" ind1" "
ind2" "gtltsubfield code"a"gt0393013456lt/subfieldgtlt
/datafieldgt ltdatafield tag"020" ind1" " ind2"
"gtltsubfield code"a"gt9780393013450lt/subfieldgtlt/dat
afieldgt ltdatafield tag"020" ind1" " ind2"
"gtltsubfield code"a"gt0380641135
(pbk.)lt/subfieldgtlt/datafieldgt ltdatafield
tag"020" ind1" " ind2" "gtltsubfield
code"a"gt9780380641130 (pbk.)lt/subfieldgtlt/datafiel
dgt ltdatafield tag"100" ind1"1" ind2"
"gt ltsubfield code"a"gtCrane, Stephen,lt/subfieldgt
ltsubfield code"d"gt1871-1900.lt/subfieldgt lt/datafi
eldgt ltdatafield tag"245" ind1"1"
ind2"4"gt ltsubfield code"a"gtThe red badge of
courage lt/subfieldgt ltsubfield code"b"gtan
episode of the American Civil War
/lt/subfieldgt ltsubfield code"c"gtStephen Crane
newly edited from Crane's original manuscript by
Henry Binder.lt/subfieldgt lt/datafieldgt ltdatafield
tag"260" ind1" " ind2" "gt ltsubfield
code"a"gtNew York lt/subfieldgt ltsubfield
code"b"gtNorton,lt/subfieldgt ltsubfield
code"c"gtc1982.lt/subfieldgt lt/datafieldgt
Here are some ISBNs ltdatafield tag"020"
ind1" " ind2" "gt ltsubfield code"a"gt 0393013456
lt/subfieldgt lt/datafieldgt ltdatafield tag"020"
ind1" " ind2" "gt ltsubfield code"a"gt 97803930134
50 lt/subfieldgt lt/datafieldgt
Heres the result size ltnumberOfRecordsgt 267468
lt/numberOfRecordsgt
24
Library Locations
lt?xml version"1.0" encoding"UTF-8"
standalone"no"?gt ltholdings xmlnsxsi"http//www.
w3.org/2001/XMLSchema-instance"
xsinoNamespaceSchemaLocation"http//www.loc.gov
/standards/iso20775/N121_ISOholdings_v4.xsd"gt lthol
dinggt ltinstitutionIdentifiergt ltvaluegtOROlt/valuegt lt
typeOrSourcegt ltpointergthttp//worldcat.org/registr
y/institutions/lt/pointergt lt/typeOrSourcegt lt/instit
utionIdentifiergt ltphysicalLocationgtOrange Public
Librarylt/physicalLocationgt ltphysicalAddressgt
lttextgtOrange, CA 92866 United Stateslt/textgt lt/phys
icalAddressgt ltelectronicAddressgt
lttextgthttp//www.worldcat.org/wcpa/oclc/15550774?p
ageframeampurl http3A2F2Flibrary.cityoforan
ge.org2Fuhtbin2Fcgisirsi.exe2Fx2F02F02F52F
3Fsearchdata13D0195038630 amptitleOrangePubli
cLibraryamplinktypeopacampdetailORO3AOrang
ePublicLibrary3APublic ampappwcapiampid13
2.174.183.38lt/textgt lt/electronicAddressgt ltholdingS
implegt ltcopiesSummarygt ltcopiesCountgt1lt/copiesCount
gt lt/copiesSummarygt lt/holdingSimplegt lt/holdinggt
Heres the OCLC Symbol ltinstitutionIdentifiergt lt
valuegt ORO lt/valuegt lt/institutionIdentifiergt
Heres the library catalog URL ltelectronicAddres
sgt lttextgt http//www.worldcat.org/wcpa/oclc/155507
74?page frameampurlhttp3A2F2Flibrary.cityof
orange. org2Fuhtbin2Fcgisirsi.exe2Fx2F02F02F
52F3 Fsearchdata13D0195038630amptitleOrange
Publ icLibraryamplinktypeopacampdetailORO3
AO rangePublicLibrary3APublicampappwcapiamp
id132.174.183.38 lt/textgt lt/electronicAddressgt
25
Demo include WorldCat.org book links in a web
site sidebar
26
Demo highlight citations, summaries, and local
libraries
27
WorldCat API and Facebook
28
WorldCat API and the iPhone
29
WorldCat API and the iPhone
30
David Walkers code4lib demo
31
(No Transcript)
32
Karen Coombs WordPress Plug-in
33
(No Transcript)
34
The Programmable Library

• We (individually and collectively) can use these
  growing set of services to become more efficient
  and effective in providing data and services
• Library data and services can be embedded within
  other platforms, e.g., Facebook, WordPress, etc.
• Library data and services can be mashed up with
  data from other sources, for example Google Maps,
  Yahoo News, local library catalogs, reading
  lists, etc.

35
Questions?
worldcat.org/devnet/ Roy Tennant roy_tennant_at_oclc
.org