Parameters
| Parameter | Description | Required? | Possible Values |
|---|---|---|---|
| method | method | required | getVariants, getEditions, getMetadata |
| format | format of output | optional (defaults to XML) | |
| library | limits search to a particular collection | optional | ebook, bookmooch, wikipedia, paperbackswap, oca, freeebook, hathi |
| fl | Fields to return | optional | fl=* return all fields |
| startIndex | the index of the first search result desired by the client | optional | |
| count | the number of search results desired by the client | optional | |
| ai | Affiliate ID | optional | |
| callback | JSON Callback | optional | See example |
| token | optional (subscription users only) | ||
| hash | optional (subscription users only) |
Search in a library
This feature limits search scope to a particular library's holding, we treat any collections as a library in general. Current support value includes:
ebookLimit search to ebooks, the ebook list is based on OCLC NJ's UHF Holdings Database.freeebookLimit search to free ebooks, the ebook list is based on OCLC NJ's UHF Holdings Database.bookmoochLimit search to bookmooch's inventory.paperbackswapLimit search to paperbackswap's inventory.wikipediaLimit search to ISBNs appeared in wikipedia, inspired by Lars Aronsson's work.ocaLimit search to Open Content Alliance.hathiLimit search to HathiTrust.
Result Paging
xOCLCNum by default returns first 1000 matched identifiers, however there are a few works with more than 1000 matches (e.g. Bible), in that case, the remaining ISBNs can be fetched by the paging method. We use "startIndex" and "count" parameters to page the result. The same technique can be used if the client desired less than 1000 records in response. The definition of startIndex and count is same as OpenSearch Specification. To do a paging request:
http://xisbn.worldcat.org/webservices/xid/isbn/9789574760442?method=getEditions&startIndex=1&count=2
The OCLC Developer Network supports the use of OCLC Web Services—a set of tools and APIs that expose data and services for WorldCat and our member libraries and partner institutions or companies. learn more »
© 2010 OCLC Domestic and international trademarks and/or service marks of OCLC Online Computer Library Center, Inc. and its affiliates
Follow the OCLC Developer Network: