Knowledge Base

Open Archives Initiative Protocol for Metadata Harvesting

The Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) is a low-barrier mechanism for repository interoperability. OAI-PMH is a set of six verbs or services that are invoked within HTTP. It is also possible to gather metadata of all public datasets on PURR through this protocol. On PURR, the metadata are available in Dublin Core.

Metadata Harvesting Guide

Start with the base URL:

Add a verb:

verb=GetRecord&identifier=(a unique record ID)
This verb is used to retrieve an individual metadata record from a repository. This verb can be used only in combination with the argument metadataPrefix=oai_dc


This verb is used to retrieve the set structure of a repository.

This verb is used to retrieve information about a repository.

Specify your metadata format in case there are records in multiple formats

This verb is used to harvest records from a repository

This verb is an abbreviated form of ListRecords, retrieving only headers rather than records.


If using ListIdentifiers or ListRecords, you may specify a date range:


To view the next page of results, find the <resumptionToken>XXXXX</resumptionToken> at the bottom of the XML and place it at the end of the query string:

0 Dislike

Last updated

Comments on this entry

There are no comments on this entry.

Post a comment

Post a comment

Comments are closed on this entry.

Please keep comments relevant to this entry. Comments deemed offensive or inappropriate may be removed.

The Purdue University Research Repository (PURR) is a university core research facility provided by the Purdue University Libraries, the Office of the Executive Vice President for Research and Partnerships, and Information Technology at Purdue (ITaP).