xStandardNumber Resource

URL and Supported Request

The xStandardNumber Resource supports three operations.

Operation Resource URL HTTP METHOD
getEditions http://xisbn.worldcat.org/webservices/xid/{NumberType}/{Number}?method=getEditions&format={format}&fl={fields} GET
getMetadata http://xisbn.worldcat.org/webservices/xid/{NumberType}/{Number}?method=getMetadata&format={format}&fl={fields} GET
getVariants http://xisbn.worldcat.org/webservices/xid/{NumberType/{Number}?method=getVariants&format={format}&fl={fields} GET

Response Formats

Path Tokens

Name
Required? Description Expected/Sample Values
number Yes

The number value being searched.

  • 2004273129
  • 154684429
  • owi67201841

numberType

Yes

The type of number.  

  • lccn
  • oclcnum
  • owi

Parameters

Name
Required? Description Expected/Sample Values
ai No WorldCat Affiliate ID associated with the client application  
callback No JSON Callback  

fl

No

Comma seperated list of fields to return in the response.

fl = * returns all fields

  • lccn
  • oclcnum
  • owi
  • presentOclcnum
  • url

format

No

Format to return the response in

  • xml
  • json
hash No    
token No Token    

Response Fields

Field
Description

lccn

Library Of Congress Control Number, this field is space-delimited if multiple values exist.
oclcnum OCLC number, this field is space-delimited if multiple values exist

owi

xID Work ID

presentOclcnum

present OCLC number. Only used when the response OCLC number is obsolete.
url URL link to electronic resource, this field is space-delimited if multiple values exist. This field is always present and minimally will contain the WorldCat.org url for the item. If other values exists they will also be present in this field.

Example URLs

Retrieve metadata for the OCLC Number 0596529260:

GET http://xisbn.worldcat.org/webservices/xid/oclcnum/154684429?method=getMetadata&format=xml&fl=*

Retrieve editions for the OCLC Number 0596529260:

GET http://xisbn.worldcat.org/webservices/xid/oclcnum/154684429?method=getEditions&format=xml&fl=*

Retrieve Variants for the OCLC Number 05596529260:

GET http://xisbn.worldcat.org/webservices/xid/oclcnum/154684429?method=getVariants&format=xml&fl=*

Retrieve metadata for the LCCN 2004273129:

GET http://xisbn.worldcat.org/webservices/xid/lccn/2004273129?method=getMetadata&format=xml&fl=*

Retrieve editions for the LCCN 2004273129:

GET http://xisbn.worldcat.org/webservices/xid/lccn/2004273129?method=getEditions&format=xml&fl=*

Retrieve Variants for the LCCN 2004273129:

GET http://xisbn.worldcat.org/webservices/xid/lccn/2004273129?method=getVariants&format=xml&fl=*

Retrieve metadata for the Work ID owi67201841:

GET http://xisbn.worldcat.org/webservices/xid/owi/owi67201841?method=getMetadata&format=xml&fl=*

Retrieve editions for the Work ID owi67201841:

GET http://xisbn.worldcat.org/webservices/xid/owi/owi67201841?method=getEditions&format=xml&fl=*

Retrieve Variants for the Work ID :

GET http://xisbn.worldcat.org/webservices/xid/owi/owi67201841?method=getVariants&format=xml&fl=*

Notes

Variants

There are several different variants of an OCLC number as outlined in OCLC Technical Bulletin 253.

Deleted and merged OCLCNUM

Worldcat uses OCLC Control Number Cross-Reference to track deleted OCLC numbers. When an OCLC number is deleted, it's still search-able from this service. In the response, we use presentOclcnum to specify present OCLC number. For example 2416076 was merged into 24991049, a request of the deleted number 2416076 will return:

<rsp xmlns="http://worldcat.org/xid/xoclcnum/" stat="ok">
<oclcnum lccn="34025476" presentOclcnum="24991049">2416076</oclcnum>
</rsp>

The presentOclcnum field is omitted when an OCLC number is active, so request to current OCLC number 24991049 returns:

<rsp xmlns="http://worldcat.org/xid/xoclcnum/" stat="ok">
<oclcnum lccn="34025476">24991049</oclcnum>
</rsp>

We are a worldwide library cooperative, owned, governed and sustained by members since 1967. Our public purpose is a statement of commitment to each other—that we will work together to improve access to the information held in libraries around the globe, and find ways to reduce costs for libraries through collaboration. Learn more »