Overview
FAST has four request types you can use to access the API
To link to a resource using the FAST identifier, a call should use the following URL pattern:
http://id.worldcat.org/fast/{identifier}/{format}.xml
where identifier is the requested identifier and format is either HTML, RDF, or MARC21.
To complete an autosuggest search, plese use the following URL pattern:
http://fast.oclc.org/searchfast/fastsuggest?query={query}&fl={facet}&rows={rows}&wt=json&json.wrf={callback}
where each query parameter is defined as follows:
| query parameter | explanation |
|---|---|
| query | The text to be queried against AutoSuggest. Use quotation marks if it contains spaces |
| rows | The maximum number of results. Default = 10, Maximum = 20 |
| fl | The facet to be searched. Default = suggestall. See the table below for a complete listing. |
| wt and json.wrf | Used only if json.wrf is used to invoke a jsonp reposnse. |
Facets that can be searched
| Facet / SOURce | searchindex |
|---|---|
| All Facets | suggestall |
| Personal Names | suggest00 |
| Corporate Names | suggest10 |
| Events | suggest11 |
| Titles | suggest30 |
| Topicals | suggest50 |
| Geographics | suggest51 |
| Forms | suggest55 |
| LC Heading | refphrase |
To complete an open search call against the API, please use the following URL pattern:
http://fast.oclc.org/fast/search?query=cql.any+all+%22{query}%22&httpAccept={httpAccept}&maximumRecords={rows}&startRecord={startRecord}&sortKey={sortKey}
where each query parameter is defined as follows:
| query parameter | explanation |
|---|---|
| query | The text to be queried against. ex. "cats" |
| httpAccept | Use application/xml for MARC21 xml, application/rdf+xml for RDF |
| maximumRecords | The number of records to return per page. ex. 10 |
| startRecord | The record to start with. ex. 1 |
| sortKey | usage is the only sort key currently supported. |
To complete a SRU call against the API, please use the following URL pattern:
http://id.worldcat.org/fast/search?query=cql.any+all+%22{query}%22&httpAccept={httpAccept}&maximumRecords={rows}&startRecord={startRecord}&sortKey={sortKey}
Where the query parameter are the same as above except that {query} is a SRU query as part of the OpenSearch query. SRU offers the following indexes (for a complete listing consult http://id.worldcat.org/fast/search):
| index | description |
|---|---|
| Cql.all | Keywords in all headings |
| oclc.topic | Keywords in topical headings |
| oclc.geographic | Keywords in geographical headings |
| oclc.eventName | Keywords in event headings |
| oclc.personalName | Keywords in personal headings |
| oclc.corporateName | Keywords in corporate name headings |
| oclc.uniformTitle | Keywords in uniform title headings |
| oclc.period | Keywords in period headings |
| oclc.form | Keywords in form headings |
| oclc.altlc | keywords in LC Source headings |
| oclc.heading | Full headings |
| oclc.subphrase | Subfield |
| oclc.seeAlsophrase | Full see also headings |
| oclc.lcphrase | LC Source headings |
| oia.identifier | FAST Authority Record Number (ARN) |
| oclc.faststatus | Record status |
| oclc.establish | Level of establishment |
| oclc.geocode | Geographic area code (GAC) |
| oclc.feature | Geographic Feature |
| oclc.lcnumber | LCCN for LC Source Headings |
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: