Open Archives Initiative (OAI) Queries

The Rice University’s Digital Scholarship Archive (scholarship.rice.edu) supports open harvesting of repository data. You can view metadata via OAI using the Open Archives Initiative - Repository Explorer  tool or by entering a specific query directly into your web browser’s url address window. Some common queries are provided below.

Notes:

• OAI baseURL : https://scholarship.rice.edu/oai

• OAI-PMH request command can be run for collection level data but not community level

• If you prefer METS, just change "&metadataPrefix=oai_dc" to "&metadataPrefix=mets"

• UPDATE: as of December, 2013, the Rice University’s Digital Scholarship Archive (scholarship.rice.edu) supports OAI-PMH 2.0
  

   

Identify

Identifies the OAI provider:

https://scholarship.rice.edu/oai/request?verb=Identify

List sets

Lists all the collections available from scholarship.rice.edu server:

https://scholarship.rice.edu/oai/request?verb=ListSets

List metadata formats

Lists all the metadata formats. The format "oai_dc" is required of all OAI providers.

https://scholarship.rice.edu/oai/request?verb=ListMetadataFormats

List identifiers

Gives the header information only for all records:

https://scholarship.rice.edu/oai/request?verb=ListIdentifiers&metadataPrefix=oai_dc

List records

List the records from one collection (change the set name at the end to get another set):

http://scholarship.rice.edu/oai/request?verb=ListRecords&metadataPrefix=oai_dc&set=col_1911_13110

For the next 100 records (change the number at the end to get additional sets of records in 100 count groups): -- NOT WORKING?

http://scholarship.rice.edu/oai/request?verb=ListRecords&resumptionToken=0001-01-01T00:00:00Z/9999-12-31T23:59:59Z/hdl_1911_13110/oai_dc/100

Get record

Get a particular record's metadata (e.g., item #35964):

http://scholarship.rice.edu/oai/request?verb=GetRecord&identifier=oai:scholarship.rice.edu:1911/35964&metadataPrefix=oai_dc

To retrieve List Records within a specified date range

https://scholarship.rice.edu/oai/request?verb=ListRecords&metadataPrefix=oai_dc&set=col_1911_13110&from=2014-01-01&until=2014-12-31

Notes:

• Modification Date (OAI Date Stamp): OAI-PMH harvesters need to know when a record has been created, changed or deleted. DSpace keeps track of a "last modified" date for each item in the system, and this date is used for the OAI-PMH date stamp. This means that any changes to the metadata (e.g. admins correcting a field, or a withdrawal) will be exposed to harvesters. (1)
• To specify  datestamp-based selective harvesting, datestamps are included as values of the  optional arguments, from and until, in the  ListRecords and ListIdentifiers  requests.
• Harvesters may use datestamps to harvest only those records that  were created, deleted, or modified within a specified date range
• Harvesting is restricted to the range specified by the from  and until arguments, extending back  to the earliest datestamp if from is omitted, and forward to the most recent datestamp if until is omitted.
• Every header returned by the GetRecord,  ListRecords  or ListIdentifiers  requests contains a datestamp, which reflects the most recent date and  time of the creation, modification, or deletion

Sources:

1. OAI-PMH Data Provider 2.0 (Internals) - DSpace 3.x Documentation - DuraSpace Wiki (http)
2. Open Archives Initiative - Protocol for Metadata Harvesting - v.2.0: Section 2.7.1 Selective Harvesting and Datestamps (http)

Local/custom OAI format(s)

• OAI-ETDMS1-1

More Information

Need more information about OAI? See http://www.openarchives.org, particularly http://www.openarchives.org/OAI/2.0/openarchivesprotocol.htm#ProtocolMessages for information about queries.