...
API Versioning
The version number of the API is specified in the base URL (e.g. “v2”). A version number is always required when accessing the API. The version number will be incremented whenever breaking (non backwards-compatible) changes are made to the API.
| Anchor | ||||
|---|---|---|---|---|
|
This section describes the fields available for searching through the API. In some cases, fields available through the API aggregate multiple fields within the MODS records. When applicable, this is identified in the MODS field mapping column.
| Name | Keyword Search | Exact Match Search | Can Sort | Can Facet | MODS Field Mapping | Notes | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
titleabstractTOC | YesYes | No | No | No | titleInfo.title | https:abstract | This query returns items with the keyword "justinian" in an abstract or table of contents field: https://api.lib.harvard.edu/v2/items? | title=complete motown singlesabstractTOC=Justinian | ||||||||||||
classification | No | Yes | Yes | Yes | classification Physical organization code. Includes bibliographic-level classification but not holdings. See LibraryCloud Item API for holdings-level classification. | https://api.lib.harvard.edu/v2/items?classification=F1435.3 Case-sensitive exact match: | titleLabour Party | namePR2825.A2 I8 | ||||||||||||
collectionId | No | Yes | Not available | No | Yes | nameextension.namePart e.g. "Greenblatt, Stephen" | Will find term in any name field:sets.systemId Query by the set/collection ID assigned to items that have been grouped together fo rdelivery via Harvard Digital Collections. | name | shakespeare | role | Yes | Yes | No | Yes | name.namePart.role.roleTerm | Case-sensitive exact match: | name=shakespeare&role=publisherresourceType (4/11/19: not working correctly)collectionId_exact=84560 | |||
collectionTitle
| Yes | Yes | NoYes | Yes | typeOfResourceextension.sets.setName Query by the set/collection title assigned to items that have been grouped together for delivery via Harvard Digital Collections. | name=shakespeare&resourceType=three dimensional object | isCollection
| No | Yes | No | Yes | typeOfResource (where collection="yes") Values are “true” or “false”. Indicates whether or not a record describes a collection of items. | collectionTitle=Chinese Rare Books Case-sensitive exact match:https://api.lib.harvard.edu/v2/items?collectionTitle_exact=Chinese Rare Books | |||||||
copyrightDate | Yes | Yes | Yes | Yes | originInfo.copyrightDate Use YYYY format to search. | q=colonial+north+america&isCollection=true | isManuscript
| No | Yes | No | Yes | typeOfResource (where manuscript="yes") Values are “true” or “false”. Indicates whether or not a record describes manuscript or archival material. copyrightDate=2010 | ||||||||
dateCaptured | Yes | Yes | Yes | Yes | originInfo.dateCaptured | q=colonial+north+america&isManuscript=true | genre | Yes | Yes | No | Yes | genre | https://api.lib.harvard.edu/v2/items?q=fish+watercolor&genre=DrawingsdateCaptured=2016&genre=performed+music Case-sensitive exact match: | genrependants (jewelry) | originPlace201502-- | |||||
dateCreated | Yes | Yes | NoYes | Yes | originInfo.place.placeTermdateCreated | colonial+north+america&originPlace=Boston | daguerreotypes&dateCreated=1806 Case-sensitive exact match: | originPlaceNew-England | publisherlate 18th-early 19th century | |||||||||||
dateIssued | Yes | Yes | NoYes | Yes | originInfo.publisherdateIssued | q | shakespeare | publisher | Arden | Case-sensitive exact match: | qshakespeare | publisher | Arden Shakespeare | originDate[1961] | ||||||
| dateRange (future) | ||||||||||||||||||||
| dates.start | Yes | YesNo | No | YesNo | originInfo.dateIssued | originInfo.dateCapturedThis query returns all works by Molière published from 1990 forward: | asimov+isaac&originDate=1961Case-sensitive exact matchThis query returns all works by Molière published from 1990 backward: | asimov+isaac&originDate_exact=[1961]dateIssuedThis query returns all works by Molière published from 1990 to 2000: | ||||||||||||
| dates.end | ||||||||||||||||||||
edition | Yes | Yes | Yes | Yes | originInfo.dateIssuededition | asimov isaac | dateIssued=1961 | Case-sensitive exact match: | asimov isaacdateIssued | 1961 | ||||||||||
dateCreatedgenre | Yes | YesYes | No | Yes | originInfo.dateCreatedgenre | daguerreotypes | dateCreated | 1806 | Case-sensitive exact match: | dateCreatedlate 18th-early 19th century | dateCaptured | Yes | ||||||||
identifier
| No | Yes | YesYes | No | originInfo.dateCaptured | identifier (Identifier of an item in another system) | This query returns an item by it's ISBN: | dateCaptured_exact=201502--copyrightDate | Yes | |||||||||||
isCollection
| No | YesYes | No | Yes | originInfo.copyrightDate Use YYYY format to searchtypeOfResource (where collection="yes") Values are “true” or “false”. Indicates whether or not a record describes a collection of items. | https://api.lib.harvard.edu/v2/items?copyrightDate=2010dates.startq=colonial+north+america&isCollection=true | ||||||||||||||
isManuscript
| No | Yes | No | No | No | originInfo.dateIssued | This query returns all works by Molière published from 1990 forward:Yes | typeOfResource (where manuscript="yes") Values are “true” or “false”. Indicates whether or not a record describes manuscript or archival material. | https://api.lib.harvard.edu/v2/items?q=colonial+north+america&isManuscript=true | |||||||||||
isOnline
| No | No | Yes | Yes | "true" if location.url[@access = 'raw object'] exists, "false" otherwise Indicates whether or not an item is available in digital form; values are "true" or "false". See also LibraryCloud Item API. | https://api.lib.harvard.edu/v2/items? | nameq= | Molière&dates.start=1990This query returns all works by Molière published from 1990 backwardearhart amelia&isOnline=true | ||||||||||||
issuance | Yes | Yes | Yes | Yes | originInfo.issuance | This query returns items with subject "astronomy" issued as a serial: https://api.lib.harvard.edu/v2/items? | namesubject= | Molière&dates.end=1990This query returns all works by Molière published from 1990 to 2000:astronomy&issuance=serial | ||||||||||||
languageCode | No | Yes | No | Yes | language.languageTerm (where languageTerm type="code") | This query returns items of Shakespeare in Chinese: https://api.lib.harvard.edu/v2/items?name= | Molièreshakespeare& | dates.start=1990&dates.end=2000|||||||||||||
| dates.end | ||||||||||||||||||||
| dateRange (future) | ||||||||||||||||||||
edition | Yes | Yes | Yes | Yes | originInfo.editionlanguageCode=chi | |||||||||||||||
languageText | Yes | Yes | No | Yes | language.languageTerm (where languageTerm type="text") Facet as "language" rather than "languageText". | This query returns items by or about Laozi in Chinese: https://api.lib.harvard.edu/v2/items?nametitle=Molièrelaozi&edition=7th. ed.Case-sensitive exact matchlanguage=Chinese | ||||||||||||||
name | Yes | Not available | No | Yes | name.namePart e.g. "Greenblatt, Stephen" | Will find term in any name field: | wordsworth&edition_exact=[1st ed.]issuanceshakespeare | |||||||||||||
originDate | Yes | Yes | No | YesYes | originInfo.dateIssued | This query returns items with subject "astronomy" issued as a serial:copyrightDate | subject | astronomy | issuance | serial | languageCode | No | Yes | No | Yes | language.languageTerm (where languageTerm type="code") | This query returns items of Shakespeare in ChineseCase-sensitive exact match: | shakespeare&languageCode=chilanguageText | ||
originPlace | Yes | Yes | No | Yes | language.languageTerm (where languageTerm type="text") Facet as "language" rather than "languageText". | This query returns items by or about Laozi in ChineseoriginInfo.place.placeTerm | https://api.lib.harvard.edu/v2/items?q=colonial+north+america&originPlace=Boston Case-sensitive exact match: | title=laozi&language=Chinese|||||||||||||
physicalDescription
| No | No | physicalDescription.form | This query returns items in print form with "peanut" in the title: https://api.lib.harvard.edu/v2/items?title=peanut&physicalDescription=print | ||||||||||||||||
physicalLocation abstractTOC | Yes | NoNo | Yes | NoYes | abstract | This query returns items with the keyword "justinian" in an abstract or table of contents field:location.physicalLocation Includes Harvard repository names but also non-Harvard locations, especially for artworks. | https://api.lib.harvard.edu/v2/items? | abstractTOC=Justinianclassification | No | Yes | Yes | Yes | classification
| physicalLocation=tozzer&subject=cylinder seals | ||||||
publisher | Yes | Yes | No | Yes | originInfo.publisher | classification=F1435.3 | Case-sensitive exact match: | classificationPR2825.A2 I8 | identifier (Identifier of an item in another system)Arden Shakespeare | |||||||||||
recordIdentifier | No | Yes | No | Yes | Yes | No | identifier | This query returns an item by it's ISBN:No | recordInfo.recordIdentifier at the top level only priorrecordids.recordIdentifier e.g. recordIdentifier=sch00443c00007 (for finding aids), recordIdentifier=S26791_olvsurrogate827653 (for images), recordIdentifier=012956251 (for Aleph) (Internal recordInfo.recordIdentifier elements in finding aid components and image records can be searched as keywords.) | identifier=9789601426440 | seriesTitle | Yes | Yes | No | Yes | In relatedItem[@type='series']: titleInfo.title facet as "relatedItem" rather than "seriesTitle" | recordIdentifier=990148733450203941 (for Alma) https://api.lib.harvard.edu/v2/items?recordIdentifier=014873345 (for Aleph) https://api.lib.harvard.edu/v2/items?recordIdentifier=sch00227c00197 (for finding aids) | seriesTitleHarvard-Yenching Institute Monograph Series | subjectW42143_urn-3:FHCL:1176307 (for images) Use a keyword query to retrieve items based on record ID in finding aid components and image records: | |
repository
| Yes | Yes | ?No | Yes | ?subject.topic Facet: extension.librarycloud.HarvardRepositories.HarvardRepository Includes Harvard repositories only. A search will query the long form repository name (e.g.Eda Kuhn Loeb Music Library); faceting will return the short form repository name (e.g. Loeb Music). | https://api.lib.harvard.edu/v2/items?q=peanuts&repository=Oakes Ames | ||||||||||||||
resourceType (4/11/19: not working correctly) | Yes | Yes | No | Yes | typeOfResource | subject=perseusCase-sensitive exact match: | ||||||||||||||
role | Yes | Yes | No | Yes | name.namePart.role.roleTerm | subject_exact=cylinder seals | subject.topicname=shakespeare&role=publisher | |||||||||||||
| seriesTitle | Yes | Yes | No | Yes | In relatedItem[@type='series']: titleInfo.title facet as "relatedItem" rather than "seriesTitle" | https://api.lib.harvard.edu/v2/items?seriesTitle=Harvard-Yenching Institute Monograph Series | ||||||||||||||
| Yes | Yes | Yes | No | Yes | subjectlocation.topicshelfLocator | subject.topic=mochica pottery | q=peanuts&shelfLocator=Film Mas Case-sensitive exact match: | subject.topicMochica pottery | subject.temporal | Yes | Yes | No | |||||||
source | No | No | Yes | Yes | Case-sensitive exact match:subjectrecordInfo.temporal | recordIdentifier source attribute Sources are currently MH:ALMA (from Alma), MH:VIA (image items from JSTOR forum), or MH:OASIS (finding aid components from ArchivesSpace). Attribute occurs only on top-level recordInfo.recordIdentifier elements | https://api.lib.harvard.edu/v2/items?q= | samurai&subject.temporal_exact=Edo period, 1600-1868subject.titleInfoearhart amelia&source=MH:ALMA | ||||||||||||
subject | Yes | Yes | No | Yes | subject.titleInfotopic | https://api.lib.harvard.edu/v2/items?subject.titleInfo=Middlemarchperseus Case-sensitive exact match: | subject.name | YesNote: An exact query can match on contents of a single field only. In LibraryCloud MODS, a subject heading and its subdivision(s) are split into separate fields, e.g. the subject heading "Older people -- Services for" appears in the LibCloud MODS record as these fields: <mods:topic>Older people</mods:topic>
| ||||||||||||
subject.genre | Yes | Yes | No | Yes | subject.name | genre | name | kubrick stanley | Case-sensitive exact match: | name=Kubrick, Stanley|||||||||||
subject.name.rolegeographic | Yes | Yes | No | Yes | subject.name.role.roleTerm Terms may be expressed as a word (photographer.) or abbreviation ("cmp" for composer). geographic | name.role | cmp | Case-sensitive exact match: | name.rolephotographer. | |||||||||||
subject.genrehierarchicalGeographic | Yes | Yes | No | YesNo | Case-sensitive exact match:subject.genre | hierarchicalGeographic.continent | genre_exact | Folklore | ||||||||||||
subject.geographichierarchicalGeographic.area | Yes | Yes | No | Yes | subject.hierarchicalGeographic.geographicarea | https://api.lib.harvard.edu/v2/items?subject. | geographichierarchicalGeographic.area= | gizaCase-sensitive exact match:galicia | ||||||||||||
subject.hierarchicalGeographic.city | Yes | Yes | No | Yes | subject.hierarchicalGeographic.city | https://api.lib.harvard.edu/v2/items?subject. | geographic_exact=Giza, EgypthierarchicalGeographic.city=Cochituate&q=maps | |||||||||||||
subject.hierarchicalGeographic.citySection | Yes? | Yes | No No | Yes | subject.hierarchicalGeographic.continent | https://api.lib.harvard.edu/v2/items?subject.hierarchicalGeographic.provincecitySection=charlestown | ||||||||||||||
subject.hierarchicalGeographic.region | Yes | Yes | No | Yes | subject.hierarchicalGeographic.county | https://api.lib.harvard.edu/v2/items?subject.hierarchicalGeographic.continent=africa | ||||||||||||||
subject.hierarchicalGeographic.country | Yes | Yes | No | Yes | subject.hierarchicalGeographic.island | https://api.lib.harvard.edu/v2/items?subject.hierarchicalGeographic.areacountry=canada | ||||||||||||||
subject.hierarchicalGeographic.extraterrestrialAreacounty | Yes | Yes | No | Yes | subject.hierarchicalGeographic.citySectioncounty | https://api.lib.harvard.edu/v2/items?subject.hierarchicalGeographic.county= | Bostonmiddlesex | |||||||||||||
subject.hierarchicalGeographic.continentextraterrestrialArea | Yes | Yes | No | Yes | subject.hierarchicalGeographic.continentextraterrestrialArea | https://api.lib.harvard.edu/v2/items?subject.hierarchicalGeographic. | continentextraterrestrialArea= | africa* | ||||||||||||
subject.hierarchicalGeographic.countryisland | Yes | Yes | No | Yes | subject.hierarchicalGeographic.countryisland | https://api.lib.harvard.edu/v2/items?subject.hierarchicalGeographic. | countrycanada | |||||||||||||
subject.hierarchicalGeographic.province | Yes | Yes | No | Yes | subject.hierarchicalGeographic.province | https://api.lib.harvard.edu/v2/items?subject.hierarchicalGeographic.province=quebec | ||||||||||||||
subject.hierarchicalGeographic.region | Yes | Yes | No | Yes | subject.hierarchicalGeographic.region | https://api.lib.harvard.edu/v2/items?subject.hierarchicalGeographic.region=nile | ||||||||||||||
subject.hierarchicalGeographic.state | Yes | Yes | No | Yes | subject.hierarchicalGeographic.state | https://api.lib.harvard.edu/v2/items?subject.hierarchicalGeographic.state=massachusetts&q=maps | ||||||||||||||
subject.hierarchicalGeographic.territory | Yes | Yes | No | Yes | subject.hierarchicalGeographic.territory | https://api.lib.harvard.edu/v2/items?subject.hierarchicalGeographic.territory=* | ||||||||||||||
subject.hierarchicalGeographic.countyname | Yes | Yes | No | Yes | subject.hierarchicalGeographic.countyname | hierarchicalGeographic.county=middlesex | subject.hierarchicalGeographic.city | Yes | Yes | No | Yes | subject.hierarchicalGeographic.city | Case-sensitive exact match: | hierarchicalGeographic.city=Cochituate&q=maps|||||||
subject.hierarchicalGeographicname.islandrole | Yes | Yes | No | Yes | subject.hierarchicalGeographic.island.name.role.roleTerm Terms may be expressed as a word (photographer.) or abbreviation ("cmp" for composer). | hierarchicalGeographic | island | * | subject.hierarchicalGeographic.area | Yes | Yes | No | Yes | subject.hierarchicalGeographic.areacmp Case-sensitive exact match: | hierarchicalGeographicarea=galicia | |||||
subject.hierarchicalGeographic.extraterrestrialAreatemporal | Yes | Yes | No | Yes | subject.hierarchicalGeographic.extraterrestrialAreatemporal | hierarchicalGeographic.extraterrestrialArea | * | subject.hierarchicalGeographic.citySection | Yes | Yes | No | Yes | subject.hierarchicalGeographic.citySectionedo Case-sensitive exact match: | hierarchicalGeographic.citySection=charlestownphysicalLocation | ||||||
subject.titleInfo | Yes | Yes | No | Yes | Yes | location.physicalLocation Includes Harvard repository names but also non-Harvard locations, especially for artworks. | subject.titleInfo.title | physicalLocation=tozzer&subject=cylinder seals | Case-sensitive exact match: | |||||||||||
subject.topic | Yes | Yes | No | Yes | Search: location.physicalLocation (where @type="repository") Facet: extension.librarycloud.HarvardRepositories.HarvardRepository Includes Harvard repositories only. A search will query the long form repository name (e.g.Eda Kuhn Loeb Music Library); faceting will return the short form repository name (e.g. Loeb Music). | subject.topic | Yes | Yes | Yes | No | location.shelfLocatorhttps://api.lib.harvard.edu/v2/items?subject.topic=mochica pottery Case-sensitive exact match: | |||||||||
| Anchor | shelfLocator | shelfLocator | shelfLocator||||||||||||||||||
title | Yes | Yes | No | No | titleInfo.title | q=peanuts&shelfLocator=Film Mas | Case-sensitive exact match: | q=peanuts&shelfLocatorFilm%20Mas%2025860 | ||||||||||||
url | No | Yes | No | No | location.url Can be URLs or URNs; includes links to digital content and catalog records. | https://api.lib.harvard.edu/v2/items?q=earhart amelia&url=*RAD.SCHL* Case-sensitive exact match: | ||||||||||||||
url.access
| No | Yes | No | Yes | location.url.access (range = <preview, raw object>) facet as url.access.preview or url.access.raw_object Query for records containing a url field with a specific @access attribute. Values are: "preview"= indicates link to image thumbnail
| This query returns items containing a url with the attribute access="preview" (i.e., an image thumbnail link is present): **At this time, only url.access=preview works. | ||||||||||||||
isOnlineurn
| Yes | No | No | Yes | Yes | "true" if No | location.url[@access = 'raw object'] exists, "false" otherwiseIndicates whether or not an item is available in digital form; values are "true" or "false". See also LibraryCloud Item API. Queries an item by its NRS URN (the URN only e.g., " urn-3:FHCL:1155043" minus the actionable URL components). | https://api.lib.harvard.edu/v2/items?q=earhart amelia&isOnline=true | source | No | No | Yes | Yes | urn=urn-3:FHCL:1155043 | ||||||
| DRS Extensions | ||||||||||||||||||||
| No | Yes | Yes | extension.HarvardDRS.accessFlag (range = <P, R, N, B>) P (publicly accessible), R (restricted to Harvard), N (not available for delivery), B (bypass, access handled differently) See also: LibraryCloud Item API to query human-readable version of DRS accessFlags. | https://api.lib.harvard.edu/v2/items? | qgenre= | earhart ameliadaguerreotype& | sourceaccessFlag= | MH:ALMAP | |||||||||||
recordIdentifier recordInfo.recordIdentifier at the top level only priorrecordids.recordIdentifier e.g. recordIdentifier=sch00443c00007 (for finding aids), recordIdentifier=S26791_olvsurrogate827653 (for images), recordIdentifier=012956251 (for Aleph) (Internal recordInfo.recordIdentifier elements in finding aid components and image records can be searched as keywords.) | Yes | No | No |
| Yes | Yes | Yes | extension.HarvardDRS.contentModel (range = <AUDIO, DOCUMENT, PDS DOCUMENT, PDS DOCUMENT LIST, STILL IMAGE, TEXT, VIDEO>) Use _exact query to find "DOCUMENT". See also: LibraryCloud Item API to query by human-readable value derived from the contentModel for an object in Harvard's Digital Repository Service (DRS). | recordIdentifier=990148733450203941 (for Alma) | title=biodiversity&limit=100&contentModel=PDS DOCUMENT Use the case-sensitive exact match query to find "DOCUMENT": | recordIdentifier=014873345 (for Aleph)||||||||||
fileDeliveryURL (valid if inDRS=true)
| No | Yes | No | extension.HarvardDRS.fileDeliveryURL, eg. "http://nrs.harvard.edu/ | v2/items?recordIdentifier=W42143_:1176307 (for images)Use a keyword query to retrieve items based on record ID in finding aid components and image records: | Query an item by its full delivery URL. | https://api.lib.harvard.edu/v2/items? | q=olvsurrogate717044urn
| Yes | No | No | No | location.url Queries an item by its NRS URN (the URN only e.g., " urn-3:FHCL:1155043" minus the actionable URL components).title=annual+report&fileDeliveryURL=https://nrs.harvard.edu/urn-3:HMS.COUNT:22923642 | |||||||
| No | Yes | Yes | extension.HarvardDRS.inDRS (range = <"true", "false">) Query for items in Harvard Library's digital repository service. See also LibraryCloud Item API. | https://api.lib.harvard.edu/v2/items?urn=urn-3:FHCL:1155043collectionTitlegenre=daguerreotype&inDRS=true | |||||||||||||||
| maxImageDeliveryDimension (future) | No | Future | No | Future | extension.HarvardDRS.maxImageDeliveryDimension - e.g., "600". Value is in pixels. | |||||||||||||||
metsLabel (valid if inDRS=true)
| Yes | Yes | YesYes | No | extension. | sets.setNameHarvardDRS.metsLabel eg. Any text string Query for items by keywords in the descriptive METS label - if defined in DRS metadata. | collectionTitle | Chinese Rare Books | Case-sensitive exact match: | collectionTitleChinese Rare Books | ||||||||||
modified.after (valid if inDRS=true)
| No | Yes | No | Yes | extension. | sets.systemIdHarvardDRS.lastModifiedDate - eg. "2016-05-03 Query | by the set/collection ID assigned to items that have been grouped together fo rdelivery via Harvard Digital Collections.items by the "last modified" date of a linked digital object in DRS (in YYYY-MM-DD format). | This query returns items in DRS last modified after 2016-01-05: | collectionId=84560Case-sensitive exact matchThis query returns items in DRS last modified before a specific date: | collectionId_exact=84560DRS Extensions | q=*&modified.before=2016-01-05 This query returns items in DRS last modified on 2016-01-05: https://api.lib.harvard.edu/v2/items?q=*&modified.after=2016-01-04&modified.before=2016-01-06 | |||||||||
| modified.before (valid if inDRS=true) | No | No | ||||||||||||||||||
| Anchor | inDRS | inDRS | inDRSownerCode (valid if inDRS=true) | No | Yes | Yes | extension.HarvardDRS | .inDRS (range = <"true", "false">).ownerCode, eg. "FHCL.HOUGH" | https://api.lib.harvard.edu/v2/items? | genreq= | daguerreotypecookbook*& | inDRSownerCode= | true||||||||
| Anchor | accessFlag | accessFlag | accessFlagRAD.SCHL | |||||||||||||||||
| ownerCodeDisplayName (valid if inDRS=true) | No | Yes | Yes | extension.HarvardDRS. | accessFlag (range = <P, R, N, B>)ownerCodeDisplayName, eg. "Houghton Library" | https://api.lib.harvard.edu/v2/items? | genreq=daguerreotype& | accessFlagownerCodeDisplayName= | P||||||||||||
| Anchor | contentModel | contentModel | contentModelSchlesinger | |||||||||||||||||
uriType (valid if inDRS=true) See also: LibraryCloud Item API to query by human-readable value derived from the contentModel for an object in Harvard's Digital Repository Service (DRS). | Yes
| No | Yes | Yes | extension.HarvardDRS.contentModel uriType (range = <AUDIO<FDS, DOCUMENTIDS, PDS DOCUMENT, PDS DOCUMENT _LIST, STILL IMAGE, TEXT, VIDEO>) Use _exact query to find "DOCUMENT" | https://api.lib.harvard.edu/v2/items?title=biodiversity&limit=100&contentModel=PDS DOCUMENT Use the case-sensitive exact match query to find "DOCUMENT": | ||||||||||||||
uriType (valid if inDRS=true)
| No | Yes | Yes | extension.HarvardDRS.uriType (range = <FDS, IDS, PDS, PDS_LIST, SDS, SDS_VIDEO>) Query for items by type of delivery urn, which is a proxy for type of delivery service. Delivery service types: FDS (text documents), IDS (images), PDS (page-turned objects), PDS_LIST (list of page-turned objects), SDS (streaming audio), (SDS_VIDEO (streaming video) | https://api.lib.harvard.edu/v2/items?subject=jazz&uriType=SDS | |||||||||||||||
fileDeliveryURL (valid if inDRS=true)
| No | Yes | No | extension.HarvardDRS.fileDeliveryURL, eg. "http://nrs.harvard.edu/urn-3:FHCL.HOUGH:1090399" Query an item by its full delivery URL. | https://api.lib.harvard.edu/v2/items?title=annual+report&fileDeliveryURL=https://nrs.harvard.edu/urn-3:HMS.COUNT:22923642 | |||||||||||||||
| ownerCode (valid if inDRS=true) | No | Yes | Yes | extension.HarvardDRS.ownerCode, eg. "FHCL.HOUGH" | https://api.lib.harvard.edu/v2/items?q=cookbook*&ownerCode=RAD.SCHL | |||||||||||||||
| ownerCodeDisplayName (valid if inDRS=true) | No | Yes | Yes | extension.HarvardDRS.ownerCodeDisplayName, eg. "Houghton Library" | https://api.lib.harvard.edu/v2/items?q=daguerreotype&ownerCodeDisplayName=Schlesinger | |||||||||||||||
metsLabel (valid if inDRS=true)
| Yes | Yes | No | extension.HarvardDRS.metsLabel eg. Any text string Query for items by keywords in the descriptive METS label - if defined in DRS metadata. | https://api.lib.harvard.edu/v2/items?metsLabel=seward Case-sensitive exact match: | |||||||||||||||
modified.after (valid if inDRS=true)
| No | Yes | No | extension.HarvardDRS.lastModifiedDate - eg. "2016-05-03 Query items by the "last modified" date of a linked digital object in DRS (in YYYY-MM-DD format). | SDS, SDS_VIDEO>) Query for items by type of delivery urn, which is a proxy for type of delivery service. Delivery service types: FDS (text documents), IDS (images), PDS (page-turned objects), PDS_LIST (list of page-turned objects), SDS (streaming audio), (SDS_VIDEO (streaming video) | https://api.lib.harvard.edu/v2/items? | qsubject= | *jazz& | modified.after=2016-01-04&modified.before=2016-01-06||||||||||||
| modified.before (valid if inDRS=true) | No | No | ||||||||||||||||||
| maxImageDeliveryDimension (future) | No | Future | No | Future | extension.HarvardDRS.maxImageDeliveryDimension - e.g., "600". Value is in pixels. | uriType=SDS | ||||||||||||||
| LibraryCloud Extensions | ||||||||||||||||||||
See also: availableTo to query by DRS accessFlag.
| No | Yes | No | Yes | extension.librarycloud.availableTo Human-readable values for access to digital content in Harvard's Digital Repository Service (DRS). Values are "Everyone" (corresponds to accessFlag=P) and "Harvard only" (corresponds to accessFlag=R). | https://api.lib.harvard.edu/v2/items?q=colonialism&availableTo=Everyone | ||||||||||||||
See also: LibraryCloud Item API to query by the DRS content model of an object in Harvard's Digital Repository Service (DRS). | Yes | Yes | extension.librarycloud.digitalFormats.digitalFormat Human readable values derived from the contentModel for an object in Harvard's Digital Repository Service (DRS). Values are audio, books and documents, images, and video. | https://api.lib.harvard.edu/v2/items?subject=poetry&digitalFormat=audio | ||||||||||||||||
processed.after | No | Yes | extension.librarycloud.processingDate Use YYYY-MM-DD format to search. This processing date indicates the most recent re-ingest of a metadata record (an "item") into LibraryCloud from its source catalog. | This query returns items processed after the date specified: This query returns items processed before the date specified: This query returns items processed between the specified dates: | ||||||||||||||||
processed.before | ||||||||||||||||||||
| Sets Extensions | ||||||||||||||||||||
| setName | Yes | No | Yes | extension.sets.set.setName Human-readable names that identify a set of materials selected by, for example, a curator for administrative or discovery purposes or for harvesting via OAI-PMH. | https://api.lib.harvard.edu/v2/items?setName=chinese rare books | |||||||||||||||
| setSpec | Yes | No | Yes | extension.sets.set.setSpec Codes used to identify a set of materials selected by, for example, a curator for administrative or discovery purposes or for harvesting via OAI-PMH. | https://api.lib.harvard.edu/v2/items?setSpec=crb |
Examples
#search all of LibraryCloud for “peanuts” in the title
http://api.lib.harvard.edu/v2/items?title=peanuts
#search oasis components for “peanuts” in the title
http://api.lib.harvard.edu/v2/items?title=peanuts&source=MH:OASIS (can use MH:OASIS, MH:VIA, or MH:ALEPH)
#search for a specific component identifier in OASIS
http://api.lib.harvard.edu/v2/items?recordIdentifier=sch00443c00007&source=MH:OASIS
#search for a specific component identifier in VIA (the identifier actually has the form "<viaRecordId>_<URN>", but the wildcard matches the URN portion if not known.
http://api.lib.harvard.edu/v2/items?recordIdentifier=W188002*
#search for all components in an OASIS record
http://api.lib.harvard.edu/v2/items?recordIdentifier=sch00443*
#look up the MODS for a PDS object given its URN
http://api.lib.harvard.edu/v2/items?urn=urn-3:FHCL.HOUGH:25620083
#search all of library cloud for VIA records that are public and have “peanuts” in the title (NOTE: "restricted" DRS Access Flag field not yet released to production API)
http://api.lib.harvard.edu/v2/items?title=peanuts&source=MH:VIA&accessFlag=P
#Get the facet counts for collections with various collection titles
https://api.lib.harvard.edu/v2/items?facets=collectionTitle
#Get all manuscripts from Schlesinger Library that contain either the string "electronic finding aid available" OR "electronic container list available"
https://api.lib.harvard.edu/v2/items?physicalLocation=sch&isManuscript=true&q=(https://api.lib.harvard.edu/v2/items?physicalLocation=sch&isManuscript=true&q=(electronic%20finding%20aid%20available)%20OR%20(electronic%20container%20list%20available))
Support
...