OAI-PMH

The Journal of Hematology and Clinical Research (JHCR) exposes article-level metadata for libraries, repositories, and discovery services using the Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH). Harvesting enables platforms such as institutional repositories, discovery layers, and open-access aggregators to synchronize bibliographic data, DOIs, license information, and links to the Version of Record.

JHCR operates as a fully open access journal with explicit statements on licensing and reuse, which supports wide discoverability and harvesting by third parties. The legacy site reiterates CC BY 4.0 and lists policy pages (Open Access Policy, Licensing, Plagiarism, Digital Archiving, Grievances, Waiver, Authorship Criteria), underscoring our interoperability focus for indexing and libraries.

Base URL and Verbs

The OAI-PMH interface is provided at the journal level. Harvesters should use the base URL shown below and append OAI-PMH verbs according to the standard (Identify, ListMetadataFormats, ListSets, ListIdentifiers, ListRecords, GetRecord).

Metadata Formats

At minimum, JHCR exposes oai_dc (Dublin Core). Where supported by our publishing platform, we also expose richer formats used by libraries and aggregators. Typical fields include title, creators, abstract/description, publication date, article URL, DOI, license, and keywords.

Because JHCR articles display DOIs and CC BY 4.0 notices on their landing pages, harvesters can cross-check metadata with article pages for consistency and license verification.

Set Structure

For selective harvesting, JHCR may expose sets that mirror editorial sections commonly used in hematology journals:

• original-articles — Primary research in hematology and clinical research.
• reviews — Reviews and mini-reviews.
• case-reports — Case reports / case series relevant to hematology and transfusion medicine.
• brief-reports — Short communications, clinical images.
• editorials — Editorials and commentaries.
• special-issues — Articles published under a special-issue call. 

Set names are lowercased and hyphenated for machine-friendliness. Note: If ListSets returns noSetHierarchy, harvesters should fallback to ListRecords with date ranges.

Rights and Licensing in Metadata

JHCR is a gold open access journal under CC BY 4.0, and article pages include machine-readable licensing. Harvested records therefore include license data in dc:rights and, where supported, a dedicated license property in richer schemas. This aligns with the journal’s Open Access and Licensing statements and supports compliance for repositories and funders. 

Indexing, Archiving, and OAI-PMH

The JHCR legacy site maintains an Indexing page listing numerous university libraries and discovery services that link to or harvest journal content, illustrating our integration with academic ecosystems. OAI-PMH complements this by offering a formal, machine-oriented gateway for synchronizing records. 

In addition, the site clusters key policy pages (Digital Archiving Policy, Open Access, Peer Review, Plagiarism), emphasizing preservation and ethical continuity—critical signals for libraries when assessing ingest and display. 

Pagination and Resumption Tokens

Large result sets are paginated using resumption tokens. Harvesters should:

1. Request records with a from date (e.g., the last harvest timestamp).
2. Follow resumptionToken values until no token is returned.
3. Store the until date used for the completed cycle.

Using rolling date windows reduces bandwidth and ensures you only receive newly published or corrected records. For JHCR, this is particularly helpful because issues and “Early Online” content are posted continuously, as reflected by the archive/current issue navigation on the legacy site. 

Practical Examples

Metadata Quality and Field Mapping

To support downstream services, JHCR curates metadata with an emphasis on:

• Title normalization: Sentence case for titles unless proper nouns or gene symbols demand otherwise.
• Author names: Family and given name order maintained; ORCID included when provided.
• Affiliations: Department, institution, city, and country for each author.
• Abstracts and keywords: Clinical and laboratory hematology terms to aid retrieval.
• Identifiers: DOI (Crossref-registered) and URL of the landing page.
• Rights: CC BY 4.0, aligning with the Open Access/License pages.

Where authors supply funding information or trial registration numbers, these are preserved in richer formats when available.

Corrections, Retractions, and Versioning

When a published article requires a correction, expression of concern, or withdrawal/retraction, JHCR maintains a public landing page to preserve the scholarly record and avoid link rot. OAI-PMH records will be updated so that harvesters receive the correct status and can reflect it. This approach aligns with the journal’s public Withdrawal Policy and related policy cluster. 

Harvesters should re-poll by date to capture status changes. We recommend a weekly check for corrections and a daily check for new content for high-freshness systems.

Institutional Repositories and Self-Archiving

Because JHCR is CC BY 4.0 OA, authors can deposit the Version of Record immediately in repositories, which pairs naturally with OAI-PMH exposure. Many university discovery layers and catalogs list JHCR among their holdings, indicating broad institutional reach. OAI-PMH ensures those systems can refresh records automatically as issues and articles are added. 

Repository managers may use the set structure to ingest only the types of content that match local policies (e.g., case reports vs. original articles) or harvest the entire corpus and filter locally.

Harvester Checklist

• Confirm the base URL published on this page.
• Call Identify and store repository name and earliest datestamp.
• Call ListMetadataFormats to discover supported schemas.
• Call ListSets (if enabled) to map to journal sections.
• Harvest with date ranges; follow resumptionToken until completion.
• Cross-check dc:identifier fields for DOI and landing page; prefer DOI for citation linking. 
• Honor corrections/retractions indicated by updated records; re-harvest changed records regularly. 
• Capture dc:rights for CC BY 4.0 to ensure lawful redistribution. 

FAQs

Do I need permission to harvest JHCR metadata?

No. OAI-PMH is a public interface designed for harvesting. Please respect server load and cache your copies.

Which version of record should repositories link to?

Always link to the DOI landing page. JHCR article pages display DOI and CC BY 4.0 notices clearly. 

Does JHCR expose full text via OAI-PMH?

We expose metadata and persistent links to HTML/PDF on the journal site. Many harvesters index the full text independently by following the links.

How frequently should I harvest?

Weekly is sufficient for most libraries. Discovery services may prefer daily incremental harvests.

Where can I confirm policies that affect harvesting?

See the legacy policy cluster (Open Access, Licensing, Plagiarism, Digital Archiving, Waiver, Authorship) and the Indexing page that reflects broad institutional visibility. 

Technical Contact

Editorial Office – Journal of Hematology and Clinical Research (JHCR)
Heighten Science Publications Inc.
Website: https://www.hematologyresjournal.com/
Email: [email protected]

Please include the words “OAI-PMH Harvesting” in your subject line, and specify your base URL assumption and any rate limits you request.