Library Hub Discover APIs for Developers
Library Hub Discover has several APIs available. We've tried to keep the Z39.50
APIs compatible with the legacy Copac services and we have created a new JSON
The most vital information you need to know to get your Z39.50 client connected to the Discover Z39.50 service.
XML and SUTRS are supported. There are no plans to deliver MARC records as part of the Library Hub Discover service. The XML records conform to the MODS Schema
Record Character Set
The records use the Unicode character set in UTF-8 encoding.
Element Set Names
Records can be retrieved in either B (Brief) or F (Full) form. The default is F.
Other ESNs available for SUTRS records only are:
This will present records in a form suitable for loading into a personal bibliographic reference manager such as Papyrus or Endnote.
This is the same as the "Print format (Full)" download available from the Export option of the Discover web interface.
This is the same as the "Print format (Brief)" download available from the Export option of the Discover web interface.
This is the same as the "Tagged (Full)" download available from the Export option of the Discover web interface.
This is the same as the "Tagged (Brief)" download available from the Export option of the Discover web interface.
Supported Use Attributes
Only the BIB-1 attribute set is supported. The attributes available for searching are as follows:
Personal name (1)
Corporate name (2)
Conference name (3)
Title (4 & 1097)
Subject (21 & 1099)
Publication date (30, 31 & 1102); a numeric year is expected, though you can search for a range with a term like "1900-1920" (minus the quotes)
Language (54 & 1105); Use language codes such as fre (French) or ger (German) etc. You can get language name to code conversions from the MARC code list for languages
NBK Institution ID (56)
Geographic name (58)
Publisher place (59)
Abstract & table of contents (62)
Author (1003 & 1098)
Personal name—author (1004)
Corporate name—author (1005)
Conference name—author (1006)
Standard number; e.g. ISBN, ISSN, ISMN, etc. (1007)
Most keyword fields (1016 & 1017)
Bibliographic encoding level (1021)
Map scale (1024); a numeric term is expected, though you can search for a range with a term like "35000-50000" (minus the quotes)
Corporate subject (1073)
Conference subject (1074)
Publisher name (1018 & 1101)
For information on how to format the SRU query look at the CQL documentation on the SRU website
The following CQL indexes are supported for searching:
The Discover web search can be used as a JSON API. If you include a format=json parameter in the url then you'll receive a JSON response instead of HTML. Search Results are delivered in pages of 25 records. A typical response (with the bibliographic records elided for clarity) is show below
"records": [ ... ]
The JSON object returned contains three values; an array of records, the number of search hits and a next-page token. To get the next page of results the next-page token should be appended to the search url, e.g. &next-page=<next-page-token>.
Fields available for searching
The fields listed below are the fields in our Advanced Search
form. You can create a search url for this API by using the Advanced Search form.
Fields available for searching in the query string part of the url.
Other fields available in the query string part of the url.
The types of search term supported.
Jisc Library Hub Discover
Search resources in UK and Irish academic, national & specialist libraries
0300 300 2212
07:00 - 00:00 (Monday - Friday)
Vision statement. We’re a membership organisation, providing digital solutions for UK education and research.
Jisc product areas