FAST Linked Data API
URLs and Supported Requests
| Operation | Resource URL | HTTP METHOD |
|---|---|---|
| Read | http://id.worldcat.org/fast/{identifier}/{format} | GET |
| Autosuggest | http://fast.oclc.org/searchfast/fastsuggest?query={query}&fl={facet}&rows={rows}&wt=json&json.wrf={callback} | GET |
| SRUSearch | http://fast.oclc.org/search?query=cql.any+all+%22{query}%22&httpAccept={httpAccept}&maximumRecords={rows}&startRecord={startRecord}&sortKey={sortKey} | GET |
Content Negotiation
Read
| Accept header | Response Format | URL suffix |
|---|---|---|
| HTML | / /rdf.html |
|
| application/marc21+html | HTML | /marc21.html |
|
|
RDF XML | /rdf.xml |
|
|
MARC21 XML | /marc21.xml
|
SRU Search
| Accept header | Response Format | httpAccept Parameter Value(s) |
|---|---|---|
| HTML | */* application/xhtml+xml text/html No value passed |
|
| application/xml | SRU XML | application/xml |
Parameters
AutoSuggest Parameters
| Parameter | Description |
|---|---|
| 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. |
AutoSuggest Facets
| Source/Facet |
searchindex |
|---|---|
| All Facets | suggestall |
| Personal Names | suggest00 |
| Corporate Names | suggest10 |
| Events | suggest11 |
| Titles | suggest30 |
| Topicals | suggest50 |
| Geographics | suggest51 |
| Forms | suggest55 |
| LC Heading | refphrase |
SRU Parameters
| Parameter | Description |
Expected/Sample Value |
|---|---|---|
| query | CQL query | |
| httpAccept | The accept type to return the results as. By default html is returned |
application/xml |
| recordSchema | The record schema to return information in. By default MARC is returned |
info:srw/schema/1/rdf-v2.0 info:srw/schema/1/marcxml-v1.1 |
| 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. |
Search Indices
SRU Indices
| 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 |
Example URLs
Search for records where the FAST heading includes the term "cats" and return records as MARCXML:
GET http://fast.oclc.org/search?query=cql.any+%3D+%22cats%22&httpAccept=application/xml
Search for records where the FAST heading includes the terms "cats" and return records as RDFXML:
GET http://fast.oclc.org/search?query=cql.any+%3D+%22cats%22&httpAccept=application/xml
Return an RDFXML record for the FAST identifier 12345:
GET http://id.worldcat.org/fast/12345/rdf.xml
Returns a marc21 xml record for FAST identifier 12345:
GET http://id.worldcat.org/fast/12345/marc21.xml