Services

xISBN bookmarklets now supports thousands more libraries by integration with Worldcat Registry. The previous xISBN bookmarket supports more than 300 libraries, however, the list was manually maintained and it's challenging to keep these links up-to-date, By ingesting good Registry OPAC information into xISBN bookmarklet, we are able to support thousands more libraries in a more sustainable way. xISBN bookmarklet automatically pulled new information from Worldcat Registry on a monthly basis, so if a library maintains up-to-date information in Registry, its data will be automatically reflected in xISBN bookmarklet. Furthermore, we have also developed mechanisms to validate and improve OPAC linking templates in Registry during the process. The previous xISBN bookmarklet is still maintained in http://xisbn.worldcat.org/liblook/

Written by colleague Joanna White, Product Manager of the WorldCat Registry. Users can use a new Registry Web Service to retrieve an institution record in XML using the OCLC symbol. For example: http://worldcat.org/webservices/registry/lookup/Institutions/oclcSymbol/OCL?serviceLabel=content Additional notes. Q: What happens when no records are found? When no WorldCat Registry record is found for a given OCLC Symbol , the web service returns "0" results in the XML response while the user interface presents options to adjust the search query. Q: Do I need to adjust my service for searches by special characters? Yes. Services that utilize these web services have to accommodate for special characters present in some OCLC symbols, for example symbols such as "A#2". Q: What is included in the returned content? If a user is not authorized, then the "public view" of the XML data is returned to the user. If the user is authorized, then the "authorized" version of the XML data is returned to the user. For example, "authorized" users will see IP Addresses for the record. More information on all the data fields is available with Data Fields Quick Reference at http://www.oclc.org/us/en/registry/support/Registryquickreference.pdf WorldCat Registry detailed search is also available as part of our more general Registry Search web service. This SRU service returns HTML to a web browser but XML to software agents (e.g., curl) Example of SRU search: http://www.worldcat.org/webservices/registry/search/Institutions?version=1.1&operation=searchRetrieve&recordSchema=info%3Arfa%2FrfaRegistry%2FschemaInfos%2FadminData&maximumRecords=10&startRecord=1&resultSetTTL=300&recordPacking=xml&query=local.oclcSymbol+exact+%22OCL%22+not+local.logicalDelete%3D%221%22&x-info-6-deletedRecord= Details about the three WorldCat Registry web services are listed here http://www.worldcat.org/wcpa/content/affiliate/default.jsp

ISBN number is structured and contains four parts of information: Group or country identifier, Publisher identifier, Title identifier and check digits. Because ISBN are allocated by blocks to publishers, all ISBNs in same block should have same publisher information. So it's possible to guess ISBN's publisher information from its structure, however this will only work well when there is a big database of ISBN-prefix and corresponding publisher name. Incidentally, there are over 19 million ISBNs in xISBN database, from this database, we can actually create a rather comprehensive ISBN-prefix database. Inspired by Publisher Name Server project in OCLC Research, in last data release we count 551,528 ISBN publisher-prefixes, and it is not very far away from ISBN agency's directory ( 880,000 prefixes) . From our ISBN prefix table, we add "guessing" service for xISBN, which tries to guess publisher information of any ISBN, even they are not covered by Worldcat, such as following:

http://xisbn.worldcat.org/webservices/xid/isbn/7806281622.js?method=hyphen

returns

{"stat":"ok",
 "list":[{
	"isbn":["7-80628-162-2"],
	"area":"China, People's Republic",
	"publisher":"San Qin chu ban she",
	"city":"Xi'an Shi"}]}

It will be interesting to see how this information can be used. On the other side, the "guessing" service is still approximate, we don't know all ISBN prefixes, and sometimes one ISBN prefix doesn't neatly identify one publisher, so use with caution.

Posted on behalf of my colleagues Joanna White and Xiaoming Liu: WorldCat Registry users now have an option to semi-automatically configure direct links to their catalog for over sixty ILS vendors. Authorized users can provide a sample catalog search link, click a button and receive suggested ISBN, ISSN and OCLC deep links. This guessing service is also available in a stand-alone user-friendly form and as a Web Service provided by xISBN LibLook. The WorldCat Registry provides an increasing number of links (library catalog links, OpenURL resolvers, etc.) to both WorldCat.org and the WorldCat Search API, as well as to external services like LibX. As more libraries use and maintain their WorldCat Registry information, the service can provide better and more accurate links for syndication. We are interested to learn about your experiences and how we can support more and better linking. For more information about the WorldCat Registry see Building the Grid and a short video tutorial on the Registry and how it can help your users connect to your services. Xiaoming Liu, xISBN and Joanna White, WorldCat Registry

xOCLCNUM has a less-used, but I think very useful feature of limiting search scope to a collection, we call it search in library feature. The goal is to limit FRBR expansion to a smaller scope, such as a library or special collection. Thanks for wonderful help from Jeremy York, we recently added hathitrust.org as a collection. This feature is implemented in following way: a request can put an additional parameter "library=hathi" in xOCLCNUM request, the service will only return records which marked as free access in hathitrust.org, when I gather hathitrust data last time, we collected 189,723 free access records with OCLCNUM. Similarly, we have 129,239 free access records from Open Content Alliance, and overall there are 322,629 records about ebooks (mostly free content) in xOCLCNUM service. Besides that, because of the FRBR expansion of xOCLCNUM, when a user requests an OCLCNUM, the service can lookup other OCLCNUM with free access content in same work group, for example, OCLCNUM: 51848364 is a book in copyright, by using the search in a library request, we can tell there are multiple versions of free ebooks about this book, including copies in archive.org and hathitrust.org. I just did a quick calculation, by using the FRBR expansion, 2,446,005 OCLCNUMs can link to a version of ebook. it is still a small percentage of the worldcat database, but I suspect it might be large enough for real world usage, so it would be nice to see this feature get better usage. We have a similar feature in xISBN service, but because most free access books don't have ISBNs, the xOCLCNUM's version might be better for real world usage.

xISBN service used to handle ISBN as a plain number, when a hyphenated ISBN is requested, we normalize it to a plain number internally, and present the response in plain number. However, hyphenated ISBNs carry structure information, and sometimes library OPAC system indexed hyphenated ISBN only. We just deployed a new version of xISBN service with better hyphen support, when requested ISBN is hyphenated, the response ISBNs will be hyphenated as well; we also added additional method of explicitly hyphenating ISBNs, such as: http://xisbn.worldcat.org/webservices/xid/isbn/9780596002817?method=hyphen It is implemented by downloading the ISBN range HTML file, turn it into a lookup table, and when an ISBN should be hyphenated, we use the lookup table to figure out where to add the hyphen. It is trivial to parse the ISBN range HTML file, but it would be great if ISBN agency has a machine-readable format of this file.

We added a few more features in this month's xID deployment, hopefully it could be useful in upcoming WorldCat Hackathon .

• support LCCN query such as: http://xisbn.worldcat.org/webservices/xid/lccn/2004273129?fl=isbn,lccn
• support deleted OCLCNUM (marc019 field) http://xisbn.worldcat.org/webservices/xid/oclcnum/47139964?method=getMetadata In this case OCLCNUM 47139964 was merged into 33100112, and we use a flag "presentOclcnum" to mark present OCLC numbers.
• xISSN project now supports tab-delimited and CSV dissemination http://xissn.worldcat.org/webservices/xid/issn/0036-8075?method=getEditions&format=csv&fl=issn,form,title http://xissn.worldcat.org/webservices/xid/issn/0036-8075?method=getEditions&format=txt&fl=issn,form,title
• start to support php dissemination format in all XID projects http://xisbn.worldcat.org/webservices/xid/isbn/0596002815?method=getEditions&fl=*&format=php

For more information, please check xISBN API, xISSN API, and xOCLCNUM API. Thanks Andrew Nagy and Jonathan Rochkind for valuable suggestions.

From the beginning, the promise of web services generally -- and OCLC Grid Services specifically -- has been that as more services are deployed, the more options there will be to weave them together in interesting, effective, and imaginative ways. Here at OCLC we're already beginning to benefit from that in our own services. For example, we've long known that a key piece of infrastructure for many of our web services would be a registry of all kinds of information related to institutions -- their catalog web address, the address of their OpenURL resolver, plus a pile of other things that would be needed by a variety of services we hoped to build down the road. We implemented this a while back as the WorldCat Registry. Now, with the release of the WorldCat Search API, we are starting to see how various Grid Services can be knitted together to enrich the whole. When the WorldCat Search API returns search results, depending on the response type requested, it can be sending back information pulled from the WorldCat Registry -- such as the link to a library's catalog. Therefore, keeping your institution's information accurate and up-to-date in the WorldCat Registry will populate that information out into a growing set of services in a pain-free, effective, and efficient way. Now isn't that what this should all be about?

As was just announced by Dawn Hendricks, the WorldCat Search API Product Manager, the WorldCat Search API will be generally released this Sunday, August 10th. For more information see the message Dawn posted to the WC-DEVNET-L list: I am happy to announce that the WorldCat Search API will be available for OCLC libraries starting this Sunday, August 10th at no additional charge for most cataloging members. Check here http://worldcat.org/devnet/index.php/SearchAPIWhoCanUse for details. A request form for the service will become available on the WorldCat.org Affiliate Services page, http://www.worldcat.org/wcpa/content/affiliate/. OCLC's xISBN and xISSN web services are also available from this page and are similarly free to qualifying OCLC member libraries. More information about the WorldCat Search API can be found at http://www.worldcat.org/devnet/index.php/SearchAPIDetails, including some sample applications http://www.worldcat.org/devnet/index.php/SearchAPIDemos that came out of the work of early release participants. I want to thank all the pilot phase developers that have been using the service and giving us feedback since March 2008. We have greatly benefited from their efforts and input. We look forward to seeing more sample applications as we extend the API to our library members. Your continued input will help to improve the service. And the DevNet site will be a great place to share ideas and code for the service. Best regards, Dawn Hendricks WorldCat Search API, product manager http://worldcat.org/devnet/index.php/SearchAPIDetails hendricd@oclc.org

Thanks for great suggestion by Tod Matola in OCLC, we are introducing an OCLCNUM normalization service as part of xOCLCNUM. -- xOCLCNUM service now accepts different variants of an OCLCNUM, and always return OCLCNUM in same flavor, such as: http://xisbn.worldcat.org/webservices/xid/oclcnum/ocm55847258?method=getEditions&format=xml&fl=lccn,isbn --add a new method to generate different variants of an OCLCNUM. http://xisbn.worldcat.org/webservices/xid/oclcnum/55847258?method=getVariants&format=xml For more information, please check http://xisbn.worldcat.org/xisbnadmin/xoclcnum/api.htm#getvariants