OAI-PMH Service
- Introduction
- Using the Profiles in Science OAI-PMH Service
- Supported Data Formats
- Automatic Segmentation of Large Result Sets
- Examples
- Identify
- ListMetadataFormats
- ListIdentifiers - return a fixed number of identifiers per request
- ListRecords - return a fixed number of records per request
- ListSets - return a fixed number of sets per request
- GetRecord - retrieve a record by identifier
The Profiles in Science® Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) Service provides access
to the Dublin Core
metadata associated with the Profiles in Science digitized items.
OAI-PMH is a standard for retrieving metadata from digital document repositories. Visit the Open Archives Initiative site
for more information about the protocol and other activities of the OAI group.
The Profiles in Science OAI-PMH Service supports OAI-PMH version 2.0. It does not support earlier versions of the protocol.
The base URL for the service is http://profiles.nlm.nih.gov/oai.
See the examples, below, for details about how to use this service to retrieve Profiles in Science Dublin Core metadata.
-
-
If a request results in more than 100 hits, the Profiles in Science OAI-PMH Service will return the first 100 with a <resumptionToken>
that can be used to get the remaining items.
Identify
- Identify the Profiles in Science OAI-PMH interface.
- http://profiles.nlm.nih.gov/oai?verb=Identify
ListMetadataFormats
- List metadata formats available in Profiles in Science OAI-PMH.
- http://profiles.nlm.nih.gov/oai?verb=ListMetadataFormats
- List metadata format available for a item with identifier oai:profiles.nlm.nih.gov:RMAAAA
- http://profiles.nlm.nih.gov/oai?verb=ListMetadataFormats&identifier=oai:profiles.nlm.nih.gov:RMAAAA
ListIdentifiers - return a fixed number of identifiers per request
Typically, the response to this request will contain 100 identifiers, and will include a resumption token at OAI-PMH/ListIdentifiers/resumptionToken.
- List (the first set of) identifers
- http://profiles.nlm.nih.gov/oai?verb=ListIdentifiers&metadataPrefix=oai_dc
- List (the first set of) identifiers for all items whose metadata was last modified on or after August 3, 2005
- http://profiles.nlm.nih.gov/oai?verb=ListIdentifiers&from=2005-08-03&metadataPrefix=oai_dc
- If the above request returned the resumption token "1375991314634!100!2005-08-03!!17709!oai_dc", then the following
request returns the next set of identifiers:
- http://profiles.nlm.nih.gov/oai?verb=ListIdentifiers&resumptionToken=1375991314634!100!2005-08-03!!17709!oai_dc
- List (the first set of) identifiers for all items whose metadata was last modified on or after August 3, 2005 and on or before
August 20, 2005.
- http://profiles.nlm.nih.gov/oai?verb=ListIdentifiers&from=2005-08-03&until=2005-08-20&metadataPrefix=oai_dc
ListRecords - return a fixed number of records per request
Typically, the response will contain 100 full-text XML records, and will include a resumption token at OAI-PMH/ListRecords/resumptionToken.
- List (the first set of) XML records
- http://profiles.nlm.nih.gov/oai?verb=ListRecords&metadataPrefix=oai_dc
- List (the first set of) XML records for all items whose metadata was last modified on or after January 1, 2000 and on or before
December 31, 2000.
- http://profiles.nlm.nih.gov/oai?verb=ListRecords&from=2000-01-01&until=2000-12-31&metadataPrefix=oai_dc
ListSets - return a fixed number of sets per request
At this time, the Profiles in Science OAI-PMH Service does not support sets.
- List the Profiles in Science OAI-PMH sets.
- http://profiles.nlm.nih.gov/oai?verb=ListSets
GetRecord - retrieve a record by identifier
- Get record in Dublin Core format with an identifier.
- http://profiles.nlm.nih.gov/oai?verb=GetRecord&identifier=oai:profiles.nlm.nih.gov:RMAAAA&metadataPrefix=oai_dc