Using Supercat


You can use SuperCat to get data about ISBNs, metarecords, bibliographic records, and authority records.

Throughout this section, replace <hostname> with the domain or subdomain of your Evergreen installation to try these examples on your own system.


Given one ISBN, Evergreen can return a list of related records and ISBNs, including alternate editions and translations. To use the Supercat oISBN tool, use http or https to access the following URL.


For example, the URL returns the following list of catalog record IDs and ISBNs:

<?xml version='1.0' encoding='UTF-8' ?>
<idlist metarecord='436139'>
  <isbn record='5652044'>9780606323475</isbn>
  <isbn record='5767568'>9780780673809</isbn>
  <isbn record='1350528'>9780807286029</isbn>
  <isbn record='5708164'>9780780669642</isbn>
  <isbn record='2372013'>043965548X</isbn>
  <isbn record='5804511'>8498386969</isbn>
  <isbn record='4132282'>9780786222742</isbn>
  <isbn record='1530458'>9788478885190</isbn>
  <isbn record='2003291'>0736650962</isbn>
  <isbn record='1993002'>8478885196</isbn>
  <isbn record='1187595'>9780439554923</isbn>
  <isbn record='4591175'>8478885196</isbn>
  <isbn record='5676282'>0807282324</isbn>
  <isbn record='2363352'>8478885196</isbn>
  <isbn record='2315122'>1480614998</isbn>
  <isbn record='2304130'>8478886559</isbn>
  <isbn record='2012565'>9780613371063</isbn>
  <isbn record='5763645'>9782070528189</isbn>
  <isbn record='2383286'>0786222743</isbn>
  <isbn record='2489670'>9780329232696</isbn>
  <isbn record='1681685'>9780807282311</isbn>
  <isbn record='2160095'>0807286028</isbn>
  <isbn record='2219885'>9789500421157</isbn>
  <isbn record='1934218'>9780613359580</isbn>
  <isbn record='5682871'>9781594130021</isbn>
  <isbn record='1281164'>0807283150</isbn>
  <isbn record='1666656'>0747542155</isbn>
  <isbn record='4717734'>8478886559</isbn>


Record formats

First, determine which format you’d like to receive data in. To see the available formats for bibliographic records, visit


Similarly, authority record formats can be found at and metarecord formats can be found at

For example, shows that the Georgia Pines catalog can return authority records in the formats opac, marc21, marc21-full, and marc21-uris. Supercat also includes the MIME type of each format, and sometimes also refers to the documentation for a particular format.

<?xml version='1.0' encoding='UTF-8' ?>

atom-full is currently the only format that includes holdings and availability data for a given bibliographic record.

Retrieve records

You can retrieve records using URLs in the following format:


For example, returns the following record.

<?xml version="1.0"?>
<modsCollection xmlns="" xmlns:mods="" version="3.0">
  <mods xmlns:xsi="" xmlns:mods="" xsi:schemaLocation="">
      <title>Words and pictures /</title>
    <name type="personal">
      <namePart xmlns:xlink="">Dodd, Siobhan</namePart>
    <typeOfResource xmlns:xlink="">text</typeOfResource>
    <originInfo xmlns:xlink="">
        <code authority="marc">mau</code>
        <text>Cambridge, Mass</text>
      <publisher>Candlewick Press</publisher>
      <edition>1st U.S. ed.</edition>
    <language authority="iso639-2b">eng</language>
      <form authority="marcform">print</form>
      <extent>1 v. (unpaged) : col. ill. ; 26 cm.</extent>
    <abstract>Simple text with picture cues accompany illustrations depicting scenes of everyday life familiar to children, such as getting dressed, attending a party, playing in the park, and taking a bath.</abstract>
    <note type="statement of responsibility">Siobhan Dodds.</note>
    <subject xmlns:xlink="" authority="lcshac">
      <topic>Family life</topic>
    <subject xmlns:xlink="" authority="lcsh">
      <topic>Juvenile fiction</topic>
    <subject xmlns:xlink="" authority="lcsh">
    <subject xmlns:xlink="" authority="lcsh">
      <topic>Picture puzzles</topic>
      <topic>Juvenile literature</topic>
    <subject xmlns:xlink="" authority="lcsh">
      <topic>Picture books for children</topic>
    <subject xmlns:xlink="" authority="lcsh">
      <topic>Picture dictionaries, English</topic>
      <topic>Juvenile literature</topic>
    <subject xmlns:xlink="" authority="lcsh">
      <topic>Juvenile literature</topic>
    <classification authority="lcc">PZ7.D66275 Wo 1992</classification>
    <classification authority="lcc">PN6371.5 .D63 1992x</classification>
    <classification authority="ddc" edition="20">793.73</classification>
    <identifier type="isbn">1564020428 :</identifier>
    <identifier type="isbn">9781564020420</identifier>
    <identifier type="lccn">91071817</identifier>
    <recordInfo xmlns:xlink="">
      <recordCreationDate encoding="marc">920206</recordCreationDate>
      <recordChangeDate encoding="iso8601">20110608231047.0</recordChangeDate>
      <recordIdentifier source="GaAaGPL">33333</recordIdentifier>

Recent records

SuperCat can return feeds of recently edited or created authority and bibliographic records:


Note the following features:

  • The limit records imported or edited following the supplied date will be returned. If you do not supply a date, then the most recent limit records will be returned.

  • If you do not supply a limit, then up to 10 records will be returned.

  • feed-type can be one of atom, html, htmlholdings, marcxml, mods, mods3, or rss2.

Filtering by Org Unit

You can generate a similar list, with the added ability to limit by Org Unit, using the item-age browse axis.

To produce an RSS feed by item date rather than bib date, and to restrict it to a particular system within a consortium:

Note the following:

  • ARL-BOG should be the short name of the org unit you’re interested in

  • 1 is the page (since you are browsing through pages of results)

  • 10 is the number of results to return per page

Modifying the 'atom' portion of the URL to 'atom-full' will include catalog links in the results:

Modifying the 'atom' portion of the URL to 'html-full' will produce an HTML page that is minimally formatted:

Additional Filters

If you’d like to limit to a particular status, you can append ?status=0 where 0 is the ID number of the status you’d like to limit to. If a number of statuses, you can append multiple status parameters (for example, ?status=0&status=1 will limit to items with a status of either 0 or 1).

Limiting to status is a good way to weed out on-order items from your feeds.

You can also limit by item location (?copyLocation=227 where 227 is the ID of your item location).