OCLC Developer Network

Library Catalog URL

If you have a standard number such as an ISBN or OCLC number for a record and want to get its Library Catalog URL for a specific OCLC Library, construct your request this way:

ISBN:
http://www.worldcat.org/webservices/catalog/content/libraries/isbn/[isbn]?oclcsymbol=[library symbol]&wskey=[key]

OCLC number:
http://www.worldcat.org/webservices/catalog/content/libraries/[oclc number]?oclcsymbol=[library symbol]&wskey=[key]

ISSN:
http://www.worldcat.org/webservices/catalog/content/libraries/issn/[issn]?oclcsymbol=[library symbol]&wskey=[key]

Other standard numbers such as LCCNs:
http://www.worldcat.org/webservices/catalog/content/libraries/sn/[value]?oclcsymbol=[library symbol]&wskey=[key]

For example:
http://www.worldcat.org/webservices/catalog/content/libraries/isbn/0026071800?oclcsymbol=OSU&wskey=[key]

The API response will either be a Holding structure, as shown in Response Details for just your designated library's OCLC symbol(s), or a "no holdings found" diagnostic.

You can provide up to 100 OCLC symbols in the request. Separate multiple values with a comma, for example:
http://www.worldcat.org/webservices/catalog/content/libraries/15550774?oclcsymbol=OSU,STF&wskey=[key]

If requesting information on more than 10 symbols, you will need to use the maximiumLibraries parameter to request a count up to 100 symbols returned in a single query.  The default amount is 10 symbols.

JSON

The format parameter and callback parameter are only used with the JSON output format. 

 

Please be sure to also consider the impact of FRBR Grouping and Service Level when determining the meaning and impact on the results.

FRBR Grouping

Note: the default option is to include all the library locations for any record that represents an edition of the item identified.  This is sometimes referred to as a "FRBRized" holdings results. To see holdings associated with only a single record, include the parameter frbrGrouping=off.  However, the “off” option only works with OCLC number. 

Service Level

Note: the type of libraries retrieved will be impacted by what Service Level is used. 

  • If no service level is given the libraries that are visible in WorldCat.org will be provided at the default level. This level can be used for any users without the user being authenticated as a library user.
  • If the library information will be used only by authenticated users [library staff, patrons, faculty, students, and people within the library building] then the full service level can be used.  The full service level provides holdings information for all libraries, not just those libraries that are participating in the WorldCat.org program.

Follow the OCLC Developer Network:

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


Powered by Drupal, an open source content management system