Kyoto University

KURENAI OAI-PMH API

OAI-PMH 2.0 metadata harvesting interface for KURENAI, the Kyoto University Research Information Repository. Anonymous, verb-driven, and serving 15 metadata formats including jpcoar_2.0 and jpcoar_1.0 (Japan Consortium for Open Access Repositories), junii2 for NII IRDB harvesting, oai_dc, mods, mets, ore, didl, qdc, etdms, marc and rdf. Identify reports protocol version 2.0, an earliest datestamp of 2006-06-05 and deletedRecord policy "transient". Records carry ORCID, ROR, e-Rad and kakenhi identifiers.

GitHub OpenAPI

Documentation

📖
Documentation
https://repository.kulib.kyoto-u.ac.jp/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/kyoto/refs/heads/main/openapi/kyoto-oai-pmh-api-openapi.yml

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/kyoto/refs/heads/main/examples/kyoto-oaiIdentify-example.json
🔗
Collection
https://raw.githubusercontent.com/api-evangelist/kyoto/refs/heads/main/collections/kyoto-oai-pmh-api.postman_collection.json
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/kyoto/refs/heads/main/apis.yml

OpenAPI Specification

kyoto-oai-pmh-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: KURENAI OAI-PMH API (Kyoto University Research Information Repository)
  description: 'Machine-readable interfaces for the Kyoto University Research Information Repository (KURENAI), a DSpace 7.6 instance. Two confirmed-live surfaces are described: the DSpace REST API (HAL+JSON) rooted at /server/api, and the OAI-PMH 2.0 metadata harvesting endpoint at /server/oai/request. Only paths and shapes verified against the live system are included. Item-level REST endpoints require authentication; the public surfaces (root, communities, collections, OAI-PMH) are anonymous.'
  version: 1.0.0
  contact:
    name: KURENAI Repository Administration
    email: repository@mail2.adm.kyoto-u.ac.jp
  x-provenance:
    generated: '2026-08-19'
    method: probed
    source: >-
      Written by API Evangelist from live probes of https://repository.kulib.kyoto-u.ac.jp/server/oai/request (2026-06-03, re-verified 2026-08-19). Kyoto University publishes no OpenAPI for this surface.
    operator: institution
servers:
- url: https://repository.kulib.kyoto-u.ac.jp
  description: Kyoto University Research Information Repository (KURENAI)
tags:
- name: OAI-PMH
  description: OAI-PMH 2.0 metadata harvesting interface
paths:
  /server/oai/request:
    get:
      tags:
      - OAI-PMH
      operationId: oaiRequest
      summary: OAI-PMH 2.0 request endpoint
      description: Single OAI-PMH 2.0 endpoint. The verb parameter selects the operation. Responses are OAI-PMH XML. Supported metadata prefixes include oai_dc, jpcoar_2.0, and didl.
      parameters:
      - name: verb
        in: query
        required: true
        schema:
          type: string
          enum:
          - Identify
          - ListMetadataFormats
          - ListSets
          - ListIdentifiers
          - ListRecords
          - GetRecord
      - name: metadataPrefix
        in: query
        required: false
        schema:
          type: string
          example: oai_dc
      - name: identifier
        in: query
        required: false
        schema:
          type: string
          example: oai:repository.kulib.kyoto-u.ac.jp:2433/1234
      - name: set
        in: query
        required: false
        schema:
          type: string
      - name: from
        in: query
        required: false
        schema:
          type: string
          format: date-time
      - name: until
        in: query
        required: false
        schema:
          type: string
          format: date-time
      - name: resumptionToken
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OAI-PMH XML response
          content:
            text/xml:
              schema:
                type: string
                description: OAI-PMH 2.0 XML document