FAST Linked Data API - Response Details

Overview

The FAST linked data API provides three differnt kinds of response to queries run against it:

Autosuggest
Individual Records
Search Results

Autosuggest

Request:

http://fast.oclc.org/fastSuggest/select?q=suggestall+%3Acats&fl=suggestall&wt=json

Response:

{
 "responseHeader":{  
  "status":0, 
  "QTime":4, 
  "params":{    
	"fl":"suggestall",     
	"q":"suggestall :cats",   
	"wt":"json"
    }
  },
 "response":{
    "numFound":236,
    "start":0,
    "docs":[      
	{    
	 "suggestall":"Cats"
      },    
	{      
	 "suggestall":"Cats--Diseases"
      },   
	{      
	 "suggestall":"Cats--Infancy"
      },   
	{    
	 "suggestall":"CATS System--Format"
      },  
	{     
	 "suggestall":"Cats--Behavior"
      }, 
	{
	 "suggestall":"New York (State)--Catskill Mountains"
      },
	{
	 "suggestall":"New York (State)--Catskills"
      },
	{
	 "suggestall":"Cats--Anatomy"
      },
	{
	 "suggestall":"Cats--Breeds"
      },
	{
	 "suggestall":"Owners of cats"
      }
    ]
  }
}

Individual Record

Request:

http://id.worldcat.org/fast/12345/marc21.xml

Response:

<?xml version="1.0" encoding="UTF-8"?>
<mx:record xmlns:mx="http://www.loc.gov/MARC21/slim" xmlns="http://www.w3.org/TR/xhtml1/strict">
 <mx:leader>00000cz  a2200037n  45 0</mx:leader>
 <mx:controlfield tag="001">fst00012345</mx:controlfield>
 <mx:controlfield tag="003">OCoLC</mx:controlfield>
 <mx:controlfield tag="005">20080131145614.0</mx:controlfield>
 <mx:controlfield tag="008">040924nn anznnbabn          || ana     d</mx:controlfield>
 <mx:datafield ind1="7" ind2=" " tag="016">
  <mx:subfield code="a">fst00012345</mx:subfield>
  <mx:subfield code="2">OCoLC</mx:subfield>
 </mx:datafield>
 <mx:datafield ind1=" " ind2=" " tag="040">
  <mx:subfield code="a">OCoLC</mx:subfield>
  <mx:subfield code="b">eng</mx:subfield>
  <mx:subfield code="c">OCoLC</mx:subfield>
  <mx:subfield code="f">fast</mx:subfield>
 </mx:datafield>
 <mx:datafield ind1=" " ind2="0" tag="053">
  <mx:subfield code="a">PR6053.H348</mx:subfield>
 </mx:datafield>
 <mx:datafield ind1="1" ind2=" " tag="100">
  <mx:subfield code="a">Chaplin, Patrice</mx:subfield>
 </mx:datafield>
 <mx:datafield ind1=" " ind2=" " tag="688">
  <mx:subfield code="a">LC (2011) Subject Usage: 7</mx:subfield>
 </mx:datafield>
 <mx:datafield ind1=" " ind2=" " tag="688">
  <mx:subfield code="a">WC (2011) Subject Usage: 13</mx:subfield>
 </mx:datafield>
 <mx:datafield ind1="1" ind2="0" tag="700">
  <mx:subfield code="a">Chaplin, Patrice</mx:subfield>
  <mx:subfield code="0">(DLC)n  50036332 </mx:subfield>
 </mx:datafield>
</mx:record>

Search Result

Request:

http://id.worldcat.org/fast/search?query=cql.any+%3D+%22cats%22&maximumRecords=2

Response:

<?xml version="1.0" encoding="UTF-8"?>
<searchRetrieveResponse xmlns="http://www.loc.gov/zing/srw/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.loc.gov/zing/srw/ http://www.loc.gov/standards/sru/sru1-1archive/xml-files/srw-types.xsd">
 <version>1.1</version>
 <numberOfRecords>152</numberOfRecords>
 <resultSetId>4ekhbr</resultSetId>
 <resultSetIdleTime>300</resultSetIdleTime>
 <records xmlns:ns1="http://www.loc.gov/zing/srw/">
  <record>
   <recordSchema>info:srw/schema/1/marcxml-v1.1</recordSchema>
   <recordPacking>xml</recordPacking>
   <recordData>
    <mx:record xmlns="http://www.w3.org/TR/xhtml1/strict" xmlns:mx="http://www.loc.gov/MARC21/slim">
     <mx:leader>00000nz  a2200037n  45 0</mx:leader>
     <mx:controlfield tag="001">fst01766919</mx:controlfield>
     <mx:controlfield tag="003">OCoLC</mx:controlfield>
     <mx:controlfield tag="005">20110901095434.0</mx:controlfield>
     <mx:controlfield tag="008">110901nn anznnbabn          || anc     d</mx:controlfield>
     <mx:datafield ind1="7" ind2=" " tag="016">
      <mx:subfield code="a">fst01766919</mx:subfield>
      <mx:subfield code="2">OCoLC</mx:subfield>
     </mx:datafield>
     <mx:datafield ind1=" " ind2=" " tag="040">
      <mx:subfield code="a">OCoLC</mx:subfield>
      <mx:subfield code="b">eng</mx:subfield>
      <mx:subfield code="c">OCoLC</mx:subfield>
      <mx:subfield code="f">fast</mx:subfield>
     </mx:datafield>
     <mx:datafield ind1=" " ind2=" " tag="150">
      <mx:subfield code="a">Cats</mx:subfield>
      <mx:subfield code="x">Breeding</mx:subfield>
      <mx:subfield code="x">Societies, etc.</mx:subfield>
     </mx:datafield>
     <mx:datafield ind1=" " ind2="0" tag="750">
      <mx:subfield code="a">Cats</mx:subfield>
      <mx:subfield code="x">Breeding</mx:subfield>
      <mx:subfield code="x">Societies, etc.</mx:subfield>
      <mx:subfield code="0">(DLC)sh2010005408</mx:subfield>
     </mx:datafield>
    </mx:record>
   </recordData>
   <recordPosition>1</recordPosition>
  </record>
  <record>
   <recordSchema>info:srw/schema/1/marcxml-v1.1</recordSchema>
   <recordPacking>xml</recordPacking>
   <recordData>
    <mx:record xmlns="http://www.w3.org/TR/xhtml1/strict" xmlns:mx="http://www.loc.gov/MARC21/slim">
     <mx:leader>00000nz  a2200037n  45 0</mx:leader>
     <mx:controlfield tag="001">fst01766155</mx:controlfield>
     <mx:controlfield tag="003">OCoLC</mx:controlfield>
     <mx:controlfield tag="005">20110901095434.0</mx:controlfield>
     <mx:controlfield tag="008">110901nn anznnbabn          || anc     d</mx:controlfield>
     <mx:datafield ind1="7" ind2=" " tag="016">
      <mx:subfield code="a">fst01766155</mx:subfield>
      <mx:subfield code="2">OCoLC</mx:subfield>
     </mx:datafield>
     <mx:datafield ind1=" " ind2=" " tag="040">
      <mx:subfield code="a">OCoLC</mx:subfield>
      <mx:subfield code="b">eng</mx:subfield>
      <mx:subfield code="c">OCoLC</mx:subfield>
      <mx:subfield code="f">fast</mx:subfield>
     </mx:datafield>
     <mx:datafield ind1=" " ind2=" " tag="150">
      <mx:subfield code="a">Cats</mx:subfield>
      <mx:subfield code="x">Abnormalities</mx:subfield>
     </mx:datafield>
     <mx:datafield ind1=" " ind2="0" tag="750">
      <mx:subfield code="a">Cats</mx:subfield>
      <mx:subfield code="x">Abnormalities</mx:subfield>
      <mx:subfield code="0">(DLC)sh2007005535</mx:subfield>
     </mx:datafield>
    </mx:record>
   </recordData>
   <recordPosition>2</recordPosition>
  </record>
 </records>
 <nextRecordPosition>3</nextRecordPosition>
 <echoedSearchRetrieveRequest xmlns:ns2="http://www.loc.gov/zing/srw/">
  <version>1.1</version>
  <query>cql.any = "cats"</query>
  <xQuery>
   <ns3:searchClause xmlns:ns3="http://www.loc.gov/zing/cql/xcql/">
    <ns3:index>cql.any</ns3:index>
    <ns3:relation>
     <ns3:value>=</ns3:value>
    </ns3:relation>
    <ns3:term>cats</ns3:term>
   </ns3:searchClause>
  </xQuery>
  <maximumRecords>2</maximumRecords>
  <recordSchema>default</recordSchema>
 </echoedSearchRetrieveRequest>
 <extraResponseData xmlns:ns4="http://www.loc.gov/zing/srw/">
  <ns5:extraData xmlns="http://oclc.org/srw/extraData" xmlns:ns5="http://oclc.org/srw/extraData">
   <ns5:databaseTitle>FAST: Faceted Application of Subject Terminology File</ns5:databaseTitle>
  </ns5:extraData>
 </extraResponseData>
</searchRetrieveResponse>

Response Details

API Documentation