City University of Hong Kong

aid: cityu
name: City University of Hong Kong
description: 'City University of Hong Kong (CityUHK) is a publicly funded research university located at Tat Chee Avenue,
  Kowloon, Hong Kong SAR, ranked #55 in the QS World University Rankings 2025. Its public, machine-readable developer footprint
  is modest and centered on its research information system: CityUHK Scholars, an Elsevier Pure-powered current research information
  system and institutional repository that exposes a publicly harvestable OAI-PMH endpoint. An official GitHub organization
  (github.com/cityu) exists but currently publishes no public repositories, and the university operates internal identity,
  portal, and learning systems (AIMS, CAP, Canvas, CityUHK Portal) that are gated and not publicly documented as APIs.'
type: Index
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
url: https://raw.githubusercontent.com/api-evangelist/cityu/refs/heads/main/apis.yml
tags:
- Education
- Higher Education
- University
- Research
- Institutional Repository
- OAI-PMH
- Hong Kong
- China
created: '2026-06-03'
modified: '2026-06-03'
specificationVersion: '0.19'
apis:
- aid: cityu:scholars-oai
  name: CityUHK Scholars OAI-PMH
  description: Public OAI-PMH (Open Archives Initiative Protocol for Metadata Harvesting, version 2.0) endpoint for CityUHK
    Scholars, the university's Elsevier Pure-powered research information system and institutional repository. The Identify
    verb returns repository name "CityUHK Scholars", with metadata records available from December 2016 onward. Supports standard
    OAI-PMH verbs (Identify, ListMetadataFormats, ListSets, ListIdentifiers, ListRecords, GetRecord). No authentication required.
  humanURL: https://scholars.cityu.edu.hk/
  baseURL: https://scholars.cityu.edu.hk/ws/oai
  tags:
  - Research
  - Institutional Repository
  - OAI-PMH
  - Metadata
  - Pure
  properties:
  - type: Documentation
    url: https://scholars.cityu.edu.hk/
  - type: Authentication
    url: https://scholars.cityu.edu.hk/ws/oai?verb=Identify
- aid: cityu:scholars-pure-ws
  name: CityUHK Scholars Pure Web Service (REST)
  description: 'Elsevier Pure REST Web Service backing CityUHK Scholars, an OpenAPI 3-described CRUD API (GET/PUT/POST/DELETE)
    for research output, projects, persons and related entities. The service is gated: requests require an API key in the
    context of a defined user, and the endpoint returns HTTP 401 Unauthorized without credentials. The OpenAPI contract is
    served from the instance (/ws/api/openapi.yaml) and an interactive RapiDoc page (/ws/api/rapidoc.html) but both require
    authorization. Not openly available; listed for completeness.'
  humanURL: https://scholars.cityu.edu.hk/
  tags:
  - Research
  - REST
  - Pure
  - OpenAPI
  - Gated
  properties:
  - type: Documentation
    url: https://scholars.cityu.edu.hk/
  - type: Authentication
    url: https://scholars.cityu.edu.hk/ws/api
  - type: OpenAPI
    url: openapi/cityu-scholars-pure-ws.yaml
  - type: x-json-schema
    url: json-schema/cityu-research-output-schema.json
  - type: x-vocabulary
    url: vocabulary/cityu-vocabulary.yml
  - type: x-rules
    url: rules/cityu-rules.yml
  - type: x-json-ld
    url: json-ld/cityu-context.jsonld
common:
- type: Website
  url: https://www.cityu.edu.hk/
- type: GitHub
  url: https://github.com/cityu
- type: LinkedIn
  url: https://hk.linkedin.com/school/cityu/
- type: DeveloperPortal
  url: https://scholars.cityu.edu.hk/
- type: Plans
  url: plans/cityu-plans-pricing.yml
- type: RateLimits
  url: rate-limits/cityu-rate-limits.yml
- type: FinOps
  url: finops/cityu-finops.yml
- type: Review
  url: review.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com