Skip to main content

OAI-PMH Service

The OAI-PMH service is available

The OAI-PMH service exposes metadata stored in the Chemotion Repository using the Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH).

This service is open to the public. The Chemotion Repository processes OAI-PMH requests and exposes metadata so that records can be harvested.

Six verbs are defined in the OAI-PMH specification and used for the discovery and sharing of metadata.

The six OAI-PMH verbs are:

  • Identify
  • ListIdentifiers
  • ListRecords
  • GetRecords
  • ListSets
  • ListMetadataFormat

There are a number of parameters that can be used by harvesters to restrict harvest requests to certain portions of the metadata, they are:

  • identifier
  • metadataPrefix
  • set
  • from
  • until
  • resumptionToken

The Chemotion Repository OAI-PMH service is able to provide metadata in the following formats:

  • OAI Dublin Core (oai_dc)
  • OAI DataCite (oai_datacite)

Please visit the Open Archives Initiative for more details.

Examples

  • You want to request records in the oai_dc metadata format, between 2022-08-01T14:15:00Z and 2022-09-01T14:20:00Z.

Request

https://www.chemotion-repository.net/oai-pmh?verb=ListRecords&from=2022-08-01T14:15:00Z&until=2022-09-01T14:20:00Z&metadataPrefix=oai_dc

  • You want to request records in the oai_datacite metadata format, between 2022-08-01T14:15:00Z and 2022-09-01T14:20:00Z.

Request

https://www.chemotion-repository.net/oai-pmh?verb=ListRecords&from=2022-08-01T14:15:00Z&until=2022-09-01T14:20:00Z&metadataPrefix=oai_datacite

  • No data can be found

Request

https://www.chemotion-repository.net/oai-pmh?verb=ListRecords&from=1022-08-01T14:15:00Z&until=1022-09-01T14:20:00Z&metadataPrefix=oai_dc

  • You use the wrong verb in the OAI-PMH request

Request

https://www.chemotion-repository.net/oai-pmh?verb=ABC
https://www.chemotion.net/chemotionsaurus/docs/repo/oa_oai_pmh
www.chemotion.net
CC-MAIN-2023-06
19106
application/http; msgtype=response
sha1:2GOYCLVY6B5WPJX3AI2CCA3DWUEEU44L
<urn:uuid:a91898ca-8812-4a0d-bab1-08f89ffb7265>
2023-02-03T12:32:46Z
141.52.79.134
text/html
sha1:ICZESWIXWWWAN4WR53UUNVFT3A6OLMQW
<urn:uuid:0f1c5aee-532d-4c71-8915-d2b9fe2029bc>
https://www.chemotion.net/chemotionsaurus/docs/repo/oa_oai_pmh
response
<urn:uuid:7da062bd-d110-49a4-9b46-6a8fa53840b9>
isPartOf: CC-MAIN-2023-06
publisher: Common Crawl
description: Wide crawl of the web for January/February 2023
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-67-67-96
software: Apache Nutch 1.19 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 1.4-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: https://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/