Skip navigation Hide thumbnails
Profiles in Science
Home | Search | Browse | What's New | FAQ | About

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

Introduction

The Profiles in Science® Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) Service provides access to the Dublin Core Exit Disclaimer; please review our Privacy Policy 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 Exit Disclaimer; please review our Privacy Policy 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.


Using the Profiles in Science OAI-PMH Service

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.


Supported Data Formats

Format Metadata
The Dublin Core Format, http://dublincore.org/ Exit Disclaimer; please review our Privacy Policy metadataPrefix=oai_dc

Automatic Segmentation of Large Result Sets

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.


Examples

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

U.S. National Library of Medicine, 8600 Rockville Pike, Bethesda, MD 20894
National Institutes of Health, Department of Health & Human Services
USA.gov, Copyright, Privacy, Accessibility
Comments, Viewers, Acknowledgments