Covid-19 Research

Metadata Service

OAI-PMH

Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) exposes metadata from JBRES to enable interoperable repository services, allowing third-party services and search engines to harvest journal and article metadata efficiently.

OAI Base URL Premium Metadata
OAI-PMH v2.0 • Metadata Harvesting • Open Archives
Protocol Overview

OAI-PMH Metadata Service

JBRES provides a robust OAI-PMH (Open Archives Initiative Protocol for Metadata Harvesting) endpoint to facilitate metadata harvesting of journal and article records. Our implementation follows the OAI-PMH version 2.0 specification and supports both public and premium metadata access tiers.

Identify
Base Identify Endpoint
ListSets
Subject Classification Sets
ListMetadataFormats
Metadata Formats (oai_dc, oai_doaj)
ListRecords
Harvest Records (oai_dc)
🔗 Base OAI URL: https://oai.jelsciences.com/
All OAI-PMH requests are made against this base URL with appropriate query parameters (verb, metadataPrefix, etc.)
Test Identify Endpoint Premium Metadata Services

Two Service Versions

JBRES provides two versions of the OAI-PMH feed to serve different harvesting needs.

✅ Public (All users)

The public OAI-PMH feed is updated within 30 days of current data in the system. This version is open to everyone and does not require authentication. Ideal for general discovery, indexing services, and casual harvesters.

⭐ Premium Metadata Service

The Premium feed updates immediately as records are added, modified, or withdrawn. Access requires an active Premium Metadata Services account and authentication via api_key parameter. Premium users enjoy real-time synchronization, higher rate limits, and extended metadata fields (including oai_doaj format with full article details).

Learn about Premium Metadata →

Journal Feed (OAI_DC)

Our journal-level metadata is exposed via the oai_dc (Dublin Core) format. Harvesters can retrieve journal records using the following verbs:

  • Identify – Repository information
  • ListSets – Subject classifications as OAI-PMH sets (based on our 4 groups / 34 sections)
  • ListMetadataFormats – Supported formats (oai_dc currently)
  • ListRecords / ListIdentifiers – Harvest journal records
Dublin Core FieldMeaning within JBRES
titleThe title of the journal
identifierISSNs (print/online) or link to DOAJ-style journal record
subjectFree-text keywords or formal subject classifications (LCSH with xsi:type)
languageLanguages published in the journal
relationJournal home page, open access statement, author instructions, aims & waiver pages
rightsCreative Commons license (CC BY 4.0)
publisherPublisher name (Journal of Biomedical Research & Environmental Sciences)
typeAlways "journal"
Example Journal Record (oai_dc snippet):
<dc:title>Journal of Biomedical Research & Environmental Sciences</dc:title>
<dc:identifier>2766-2276</dc:identifier>
<dc:subject xsi:type="dcterms:LCSH">Medicine</dc:subject>
<dc:publisher>JBRES Publisher</dc:publisher>

Article Feed (OAI_DC & OAI_DOAJ)

Article-level metadata is available in oai_dc (simplified Dublin Core) and oai_doaj (extended DOAJ-specific format with rich fields). Premium users get immediate updates and enhanced fields via the oai_doaj format.

OAI_DC FieldMeaning within JBRES (Article)
titleArticle title
identifierISSN, DOI, or JBRES article record link
subjectKeywords / formal classifications (LCSH)
languageJournal languages (not strictly per-article)
relationFull-text URL (PDF/HTML)
publisherPublisher name
typeAlways "article"
datePublication date (YYYY-MM-DD)
descriptionArticle abstract
creatorAuthor names, with optional ORCID iD attribute

OAI_DOAJ format (Premium) includes additional structured fields: journalTitle, issn, eissn, volume, issue, startPage, endPage, doi, authors with affiliations, fullTextUrl, keywords. Premium users should supply api_key parameter to access the most up-to-date version.

Example Article Record (oai_doaj structure):
<oai_doaj:title>Advances in Environmental Research</oai_doaj:title>
<oai_doaj:author><name>John Doe</name><orcid_id>https://orcid.org/0000-0001-2345-6789</orcid_id></oai_doaj:author>
<oai_doaj:volume>12</oai_doaj:volume><oai_doaj:issue>3</oai_doaj:issue>
<oai_doaj:fullTextUrl format="pdf">https://www.jelsciences.com/articles/...</oai_doaj:fullTextUrl>

Revision History & Updates

DateChanges
6 November 2024Added support for article and journal delete to the Identify endpoint.
25 November 2020Enhanced dc:relation with open access statement, author instructions, aims, and waiver pages.
20 April 2015LCC subjects now use xsi:type="dcterms:LCSH" attribute; no prefix.
13 December 2013Initial OAI-PMH release for journal feed.

For the most up-to-date information, always refer to our live OAI endpoint or contact our metadata team.

OAI-PMH Validator
Validate your OAI-PMH implementation using our dedicated validator link.
Access OAI Base URL →

Need Assistance?

For technical questions about metadata harvesting, premium access, or custom OAI-PMH requests, please contact our technical team at [email protected]. Premium metadata subscribers receive priority support and onboarding assistance.

Contact Metadata Team OAI-PMH Specification
Publish with JBRES — Peer-reviewed, multidisciplinary Open Access with rapid review, DOI, and global visibility.
Double-Blind CrossRef DOI Discoverable
Submit Manuscript Membership