• If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • Dokkio Sidebar (from the makers of PBworks) is a Chrome extension that eliminates the need for endless browser tabs. You can search all your online stuff without any extra effort. And Sidebar was #1 on Product Hunt! Check out what people are saying by clicking here.


OAI data queries

Page history last edited by Monica 3 years, 3 months ago

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.



  • 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






Identifies the OAI provider:



List sets

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



List metadata formats

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



List identifiers

Gives the header information only for all records:



List records

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



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



Get record

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



To retrieve List Records within a specified date range




  • 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



  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)



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.




Comments (0)

You don't have permission to comment on this page.