Third parties can submit search requests using Search/Retrieval via URL (SRU), a standard protocol that provides an HTTP REST API for search queries. SRU is the evolution of Z39.50, using HTTP instead of the custom Z39.50 communications protocol.
Emerald's supports SRU version 2.0 and recommends using SRU in place of the legacy Z39.50 service.
The SRU endpoint can be found here:
https://www.emerald.com/sru
Technical documentation for the API, highlighting which parameters and operations are supported, etc. can be found here:
https://www.emerald.com/sru?operation=explain&version=2.0
In a more human-readable form, the basic details of our SRU implementation are:
Our initial implementation supports two operations, searchRetrieve and explain. The following fields (indexes in the SRU nomenclature) are available for searching:
Field | Searches in | Notes |
|---|---|---|
| All content fields |
|
| Content title |
|
| Contributor fields |
|
| Publication Date | |
| dc.creator | Authors, Editors | |
| Content DOI |
|
| Abstract field |
|
| Keywords |
|
| dc.rights | License |
There is no support for dcterms.isPartOf fields for searching. We also currently do not support any fields for sorting. In addition, no facets are returned in the search results.
Pagination is supported, so the query parameters maximumRecords and startRecord are available.
SRU documentation
SRU: Search/Retrieval via URL -- SRU, CQL and ZeeRex (Standards, Library of Congress)
Context Query Language (CQL):
searchRetrieve: Part 5. CQL: The Contextual Query Language
An example query:
Article only search (Type keyword): https://www.emerald.com/sru?operation=searchRetrieve&version=2.0&query=dc.type=article
Case study only search (Type keyword): https://www.emerald.com/sru?operation=searchRetrieve&version=2.0&query=dc.type=case-study
Single term search (cql.anywhere keyword): https://www.emerald.com/sru?operation=searchRetrieve&version=2.0&query=cql.anywhere=%22sunshine%22&maximumRecords=10
Multiple term search (cql.anywhere keyword): https://www.emerald.com/sru?operation=searchRetrieve&version=2.0&query=cql.anywhere=%22time,sun,at%22&maximumRecords=10
Title search (dc.title keyword): https://www.emerald.com/sru?operation=searchRetrieve&version=2.0&query=dc.title=%22sunshine%22&maximumRecords=10
Related information
Search/Retrieval via URL (SRU)
If you require additional support regarding SRU itself, please contact the Library of Congress in the first instance.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article