Overview

The Journal of Addiction Therapy and Research (JATR) implements the Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) to ensure seamless exchange of bibliographic and metadata records between repositories, libraries, and indexing services. OAI-PMH compliance allows metadata about published articles to be automatically harvested and included in international research databases.

Transparency through technology: JATR’s OAI endpoint makes its open-access metadata freely retrievable by compliant harvesters and aggregators.

Base URL for Harvesting

The OAI-PMH interface is available at the following permanent URL:

https://www.addictiontherjournal.com/oai

This endpoint supports the OAI-PMH version 2.0 protocol and provides metadata in multiple standardized formats for compatibility with global repositories.

Supported Metadata Formats

The JATR OAI-PMH service supports the following metadata formats:

Dublin Core (oai_dc): A minimal, cross-disciplinary schema including elements like title, creator, subject, description, date, identifier and rights.
MARCXML: Extended bibliographic metadata suitable for library systems.
Crossref XML: Includes DOIs, ORCID IDs, funding information and license references.
DataCite XML: For interoperability with data repositories and citation systems.

Each format allows metadata harvesters to integrate JATR’s publications into their own databases seamlessly.

Available Sets

OAI-PMH allows metadata to be harvested in defined “sets” (collections). JATR’s sets include:

set:current – The most recent issue and articles currently in publication.
set:archive – All previously published volumes and issues.
set:metadata-only – Harvest metadata without full-text links for specific institutional requirements.

Custom sets may be added for thematic or special issues as part of digital archiving initiatives.

OAI-PMH Request Examples

Common OAI-PMH requests that can be made to the JATR endpoint:

Identify: https://www.addictiontherjournal.com/oai?verb=Identify
ListMetadataFormats: https://www.addictiontherjournal.com/oai?verb=ListMetadataFormats
ListSets: https://www.addictiontherjournal.com/oai?verb=ListSets
ListIdentifiers: https://www.addictiontherjournal.com/oai?verb=ListIdentifiers&metadataPrefix=oai_dc
GetRecord: https://www.addictiontherjournal.com/oai?verb=GetRecord&identifier=oai:addictiontherjournal.com:123&metadataPrefix=oai_dc

These standard requests follow OAI-PMH 2.0 syntax and may be integrated into repository harvesting scripts.

Interoperability and Compliance

JATR’s OAI-PMH implementation adheres to the following international interoperability standards:

OAI-PMH v2.0: Ensures compatibility with repositories such as BASE, CORE, OpenAIRE and PKP PN.
Schema.org JSON-LD: Embedded structured metadata enables semantic discovery by Google Scholar and AI-driven indexing systems.
Crossref Metadata API: Synchronized to guarantee DOI consistency across metadata endpoints.

These frameworks collectively enhance visibility, reproducibility and discoverability across open-access networks.

Technical Architecture

The OAI-PMH service runs on a RESTful architecture integrated into JATR’s OJS (Open Journal Systems) platform. Key components include:

Backend metadata repository synchronized with the journal database.
XML-based output parser for efficient metadata harvesting.
UTF-8 encoding for multilingual compatibility.
Rate limiting and caching to ensure stability for large-scale harvesters.

Data integrity is validated via Crossref DOIs and timestamped exports.

Compliance and Validation

The OAI interface undergoes periodic validation using the official OAI-PMH Validator to ensure technical compliance. Errors or downtime are logged and resolved within 24 hours by the technical support team.

Validation tests run monthly.
Logs maintained for all OAI requests.
Version updates tracked under change management policy.

Technical Contact

For issues or inquiries related to the OAI-PMH interface, please contact:

Technical Support Team
Email: [email protected]
Include “OAI-PMH Inquiry” in the subject line for faster response.

Frequently Asked Questions (FAQs)

Do I need a login to access the OAI endpoint?

No. The OAI interface is publicly accessible and does not require authentication.

How often is metadata updated?

Metadata is synchronized in real-time with new publications and periodically refreshed every 24 hours for consistency.

Which repositories harvest JATR’s metadata?

Repositories such as BASE, CORE, OpenAIRE, PKP PN, and institutional repositories harvest JATR metadata automatically through OAI-PMH.

Can I harvest only selected sections of the journal?

Yes. The “set” parameter in OAI requests allows filtering by section, issue or thematic collection.