Peking University website screenshot

Peking University

Peking University (北京大学, PKU) is a public research university in Beijing and, with Tsinghua, one of the two apex institutions of the Chinese system. Like most universities it operates no central developer portal and publishes no OpenAPI, but unlike most it runs three genuinely institution-operated machine-readable surfaces. Its Institutional Repository at ir.pku.edu.cn — PKU Library, Handle prefix 20.500.11897, content back to 2015 — answers an unauthenticated JSON REST API, a conforming OAI-PMH 2.0 endpoint advertising twelve metadata formats, and an OpenSearch Atom feed. Its Shibboleth identity provider publishes live SAML 2.0 metadata and has been in eduGAIN production since June 2019. Most significantly, the Peking University Computer Center operates CARSI, China's national research-and-education identity federation and a full eduGAIN member, which is the registration authority for 1,042 federated entities and serves 500+ Chinese universities; PKU also runs the national eduroam service. The PKU HPC group additionally authors OpenSCOW and CraneSched, open-source HPC platform and scheduler whose APIs are defined in some forty Protocol Buffer files, though those describe self-hosted software rather than a hosted endpoint. The Dataverse-based Open Research Data Platform at opendata.pku.edu.cn was verified live in June 2026 but did not answer any HTTPS request during this pass. No API is documented for developers, none carries a versioning or deprecation policy, and campus systems — IAAA authentication, the 教学网 LMS, the registrar — are gated. The footprint is small, real, and almost entirely a by-product of scholarly infrastructure rather than a developer programme.

Peking University publishes 2 APIs on the APIs.io network: PKU Institutional Repository REST API and PKU Institutional Repository OAI-PMH API. Tagged areas include University, Higher Education, Education, China, and Public Research University.

The Peking University catalog on APIs.io includes 1 JSON-LD context.

Peking University’s developer surface includes engineering blog, authentication, code examples, and 24 more developer resources.

41.2/100 developing ▲ 20.5 Agent 36/100 agent ready Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0
AccessFree
8 APIs
UniversityHigher EducationEducationChinaPublic Research UniversityC9 LeagueResearch RepositoryIdentity FederationResearch DataOpen DataResearch ComputingOAI-PMH

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0
Composite quality — 41.2/100 · developing
Contract Quality 13.3 / 21
Developer Ergonomics 1.4 / 17
Access Clarity 4.9 / 17
Operational Transparency 2.9 / 11
Contract Governance 2.2 / 10
Discoverability 5.5 / 9
Regulatory Posture 9.7 / 15
Agent readiness — 36/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 0 / 10
Documented Reversibility 0 / 6
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Regulatory Posture applies to this provider. Its tags matched the Education & Research regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/peking: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 8

Individual APIs this provider publishes, each with its own machine-readable definition.

PKU Institutional Repository REST API

Unauthenticated read API over the university's scholarly record — communities that mirror the faculty structure (理学部, 人文学部, 专利 with 25,721 items), their collections, items, Dubl...

PKU Institutional Repository OAI-PMH API

OAI-PMH 2.0 metadata-harvesting endpoint for the institutional repository, live since at least 2015-09-25 (its earliest datestamp). Advertises twelve metadata formats — oai_dc, ...

PKU Institutional Repository OpenSearch Feed

OpenSearch 1.1 query interface returning an Atom feed of repository records, served from the institution's own host. Verified live 2026-08-19 (HTTP 200, 32KB Atom response for q...

Peking University Shibboleth Identity Provider (SAML 2.0 metadata)

The university's federated identity provider, publishing live Shibboleth/SAML 2.0 metadata as machine-readable XML. Declares SAML 2.0 POST, POST-SimpleSign and Redirect SSO/SLO ...

CARSI — CERNET Authentication and Resource Sharing Infrastructure

China's national identity federation for higher education and research, operated by Peking University and a full eduGAIN member. 1,042 SAML entities in eduGAIN carry CARSI as th...

OpenSCOW / CraneSched research-computing APIs

OpenSCOW ("Super Computing On Web") is an HPC portal and management system authored at Peking University; CraneSched is its distributed scheduler for HPC and AI workloads. Their...

PKU Open Research Data Platform (Dataverse REST API)

Dataverse-based research data repository operated by the PKU Library across social science, health, bioinformatics and NLP collections. Verified live by this catalog on 2026-06-...

PKU Open Research Data Platform (OAI-PMH)

OAI-PMH 2.0 metadata-harvesting endpoint for the Open Research Data Platform, verified responding to the Identify verb on 2026-06-03 with Dublin Core and DataCite support via th...

Scroll for all 8

Pricing Plans 1

Published pricing tiers and plan structures.

Peking Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Peking Rate Limits

1 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Peking Context

17 classes · 4 properties

JSON-LD

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

PKU Institutional Repository Collection

18 properties

JSON SCHEMA

PKU Institutional Repository Community

15 properties

JSON SCHEMA

PKU Institutional Repository Item

14 properties

JSON SCHEMA

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Peking Authentication

saml2/shibboleth/cas/oauth2/none · 4 schemes

SECURITY

Peking Domain Security

TLSv1.2 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Peking Scopes

OAuth 2.0 · no documented scopes

0 scopes

SCOPES

Resources

Documentation 1

Reference material describing how the API behaves

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Build 4

SDKs, sample code, and the tooling you integrate with

Access & Security 3

Authentication, authorization, and security posture

Learn 1

Tutorials, courses, talks, and written guidance

Operate 1

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 4

The organization behind the API

Other 6

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: peking
name: Peking University
x-type: university
x-category: Public Research University
description: Peking University (北京大学, PKU) is a public research university in Beijing and, with Tsinghua, one of the two apex
  institutions of the Chinese system. Like most universities it operates no central developer portal and publishes no OpenAPI,
  but unlike most it runs three genuinely institution-operated machine-readable surfaces. Its Institutional Repository at
  ir.pku.edu.cn — PKU Library, Handle prefix 20.500.11897, content back to 2015 — answers an unauthenticated JSON REST API,
  a conforming OAI-PMH 2.0 endpoint advertising twelve metadata formats, and an OpenSearch Atom feed. Its Shibboleth identity
  provider publishes live SAML 2.0 metadata and has been in eduGAIN production since June 2019. Most significantly, the Peking
  University Computer Center operates CARSI, China's national research-and-education identity federation and a full eduGAIN
  member, which is the registration authority for 1,042 federated entities and serves 500+ Chinese universities; PKU also
  runs the national eduroam service. The PKU HPC group additionally authors OpenSCOW and CraneSched, open-source HPC platform
  and scheduler whose APIs are defined in some forty Protocol Buffer files, though those describe self-hosted software rather
  than a hosted endpoint. The Dataverse-based Open Research Data Platform at opendata.pku.edu.cn was verified live in June
  2026 but did not answer any HTTPS request during this pass. No API is documented for developers, none carries a versioning
  or deprecation policy, and campus systems — IAAA authentication, the 教学网 LMS, the registrar — are gated. The footprint is
  small, real, and almost entirely a by-product of scholarly infrastructure rather than a developer programme.
type: Index
accessModel:
  pricing: free
  onboarding: unknown
  trial: false
  try_now: false
  public: true
  label: Free
  confidence: medium
  source:
  - plans
  generated: '2026-08-19'
  method: probed
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/peking.png
url: https://raw.githubusercontent.com/api-evangelist/peking/refs/heads/main/apis.yml
tags:
- University
- Higher Education
- Education
- China
- Public Research University
- C9 League
- Research Repository
- Identity Federation
- Research Data
- Open Data
- Research Computing
- OAI-PMH
created: '2026-06-03'
modified: '2026-08-19'
specificationVersion: '0.23'
x-coverage:
  state: covered
  reason: institution_operated_surfaces_verified
  detail: 'Three institution-operated machine-readable surfaces were probed live and are documented here: the Institutional
    Repository REST API, its OAI-PMH 2.0 endpoint, and the university''s Shibboleth SAML 2.0 identity provider — plus CARSI,
    the national identity federation PKU itself operates, corroborated by eduGAIN''s registry. No vendor contract is attributed
    to the institution. One previously verified surface, the Dataverse-based Open Research Data Platform at opendata.pku.edu.cn,
    was unreachable over HTTPS across seven attempts with browser user-agents, forced HTTP/1.1 and forced IPv4; TLS completed
    against PKU''s own wildcard certificate and port 80 answered with a 301, and every other pku.edu.cn host answered normally
    in the same window, so the host is treated as unreadable from our vantage point rather than absent. Campus systems (IAAA,
    the LMS, the registrar) are authentication-gated by design and are recorded as such, not as gaps.'
  evidence:
  - url: https://ir.pku.edu.cn/oai/request?verb=Identify
    status: 200
  - url: https://ir.pku.edu.cn/oai/request?verb=ListMetadataFormats
    status: 200
  - url: https://ir.pku.edu.cn/oai/request?verb=ListSets
    status: 200
  - url: https://ir.pku.edu.cn/oai/request?verb=ListIdentifiers&metadataPrefix=oai_dc
    status: 200
  - url: https://ir.pku.edu.cn/rest/status
    status: 200
  - url: https://ir.pku.edu.cn/rest/communities?limit=2
    status: 200
  - url: https://ir.pku.edu.cn/rest/collections?limit=2
    status: 200
  - url: https://ir.pku.edu.cn/rest/items?limit=1
    status: 200
  - url: https://ir.pku.edu.cn/rest/items/3/metadata
    status: 200
  - url: https://ir.pku.edu.cn/rest/handle/20.500.11897/69
    status: 200
  - url: https://ir.pku.edu.cn/rest/items/3
    status: 500
  - url: https://ir.pku.edu.cn/oai/request?verb=BadVerb
    status: 500
  - url: https://ir.pku.edu.cn/open-search/?query=test
    status: 200
  - url: https://idp.pku.edu.cn/idp/shibboleth
    status: 200
  - url: https://idp.pku.edu.cn/idp/status
    status: 403
  - url: https://technical.edugain.org/api.php?action=list_feds
    status: 200
  - url: https://www.carsi.edu.cn/
    status: 200
  - url: https://opendata.pku.edu.cn/
    status: 0
  - url: https://opendata.pku.edu.cn/oai?verb=Identify
    status: 0
  - url: https://www.pku.edu.cn/.well-known/security.txt
    status: 404
  - url: https://www.pku.edu.cn/llms.txt
    status: 404
apis:
- aid: peking:ir-rest
  name: PKU Institutional Repository REST API
  x-operator: institution
  x-operator-evidence: Host ir.pku.edu.cn is under Peking University's own registrable domain; the repository's own OAI-PMH
    Identify names it "Institutional Repository of Peking University" with adminEmail pkuir@lib.pku.edu.cn. The deployment
    runs DSpace software but the payloads carry PKU-only extensions (claim, award4pku, taglist, deptid, deptname) absent from
    stock DSpace — a locally operated and locally modified instance, not a vendor tenancy.
  description: Unauthenticated read API over the university's scholarly record — communities that mirror the faculty structure
    (理学部, 人文学部, 专利 with 25,721 items), their collections, items, Dublin Core metadata, attached files, and Handle resolution
    under the repository's own prefix 20.500.11897. Ten paths verified live on 2026-08-19; /rest/items/{id} returns HTTP 500
    while the same item resolves through /rest/handle.
  humanURL: https://ir.pku.edu.cn/
  baseURL: https://ir.pku.edu.cn/rest
  tags:
  - Research Repository
  - Scholarly
  - REST
  - DSpace
  - Open Access
  properties:
  - type: OpenAPI
    url: openapi/peking-institutional-repository-rest-openapi.yml
  - type: JSONSchema
    url: json-schema/peking-ir-item.json
  - type: Examples
    url: examples/peking-ir-rest-items-response.json
  - type: Website
    url: https://ir.pku.edu.cn/
- aid: peking:ir-oai-pmh
  name: PKU Institutional Repository OAI-PMH API
  x-operator: institution
  x-operator-evidence: The endpoint's own Identify response reports baseURL http://ir.pku.edu.cn/oai/request and adminEmail
    pkuir@lib.pku.edu.cn.
  description: OAI-PMH 2.0 metadata-harvesting endpoint for the institutional repository, live since at least 2015-09-25 (its
    earliest datestamp). Advertises twelve metadata formats — oai_dc, qdc, mods, mets, didl, ore, rdf, marc, xoai, dim, etdms,
    uketd_dc — and sets per PKU faculty. Identify, ListMetadataFormats, ListSets and ListIdentifiers verified live; an unrecognised
    verb returns HTTP 500 instead of the protocol's badVerb error.
  humanURL: https://ir.pku.edu.cn/
  baseURL: https://ir.pku.edu.cn/oai
  tags:
  - OAI-PMH
  - Metadata
  - Harvesting
  - Research Repository
  - Dublin Core
  properties:
  - type: OpenAPI
    url: openapi/peking-institutional-repository-oai-pmh-openapi.yml
  - type: Examples
    url: examples/peking-ir-oai-identify-response.xml
  - type: Documentation
    url: https://www.openarchives.org/OAI/openarchivesprotocol.html
  - type: Conformance
    url: conformance/peking-conformance.yml
- aid: peking:ir-opensearch
  name: PKU Institutional Repository OpenSearch Feed
  x-operator: institution
  description: OpenSearch 1.1 query interface returning an Atom feed of repository records, served from the institution's
    own host. Verified live 2026-08-19 (HTTP 200, 32KB Atom response for query=test).
  humanURL: https://ir.pku.edu.cn/
  baseURL: https://ir.pku.edu.cn/open-search/
  tags:
  - OpenSearch
  - Atom
  - Discovery
  - Research Repository
  properties:
  - type: Website
    url: https://ir.pku.edu.cn/open-search/?query=test
- aid: peking:idp-saml
  name: Peking University Shibboleth Identity Provider (SAML 2.0 metadata)
  x-operator: institution
  x-operator-evidence: entityID https://idp.pku.edu.cn/idp/shibboleth, shibmd:Scope pku.edu.cn, served from the university's
    own host; independently listed in eduGAIN with registration authority https://www.carsi.edu.cn since 2019-06-18.
  description: The university's federated identity provider, publishing live Shibboleth/SAML 2.0 metadata as machine-readable
    XML. Declares SAML 2.0 POST, POST-SimpleSign and Redirect SSO/SLO bindings, the legacy Shibboleth SSO profile, an AttributeAuthorityDescriptor,
    and SOAP ArtifactResolution / AttributeQuery / SLO endpoints on port 8443. This is the surface class universities operate
    by definition and almost never catalogue.
  humanURL: https://idp.pku.edu.cn/idp/shibboleth
  baseURL: https://idp.pku.edu.cn/idp
  tags:
  - Identity Federation
  - SAML
  - Shibboleth
  - eduGAIN
  - Authentication
  properties:
  - type: Authentication
    url: authentication/peking-authentication.yml
  - type: Examples
    url: examples/peking-idp-saml-metadata.xml
  - type: Website
    url: https://idp.pku.edu.cn/idp/shibboleth
- aid: peking:carsi
  name: CARSI — CERNET Authentication and Resource Sharing Infrastructure
  x-operator: institution
  x-operator-evidence: 'Operated by the Peking University Computer Center: the carsi.edu.cn footer reads 版权所有©北京大学计算中心, and
    eduGAIN''s federation registry lists CARSI with the contact address carsi@pku.edu.cn, registration authority https://www.carsi.edu.cn,
    membership from 2019-05-24 and production from 2019-06-18. The federation runs on its own national domain rather than
    pku.edu.cn, but Peking University runs the federation.'
  description: China's national identity federation for higher education and research, operated by Peking University and a
    full eduGAIN member. 1,042 SAML entities in eduGAIN carry CARSI as their registration authority — identity providers at
    500+ Chinese universities and the service providers of international scholarly publishers — which makes this the largest
    programmable surface Peking University runs and one it runs on behalf of the whole sector. PKU also operates the national
    eduroam service at eduroam.edu.cn, listed with CARSI as CERNET basic infrastructure since October 2017.
  humanURL: https://www.carsi.edu.cn/
  tags:
  - Identity Federation
  - SAML
  - eduGAIN
  - National Infrastructure
  - Authentication
  properties:
  - type: Website
    url: https://www.carsi.edu.cn/
  - type: Authentication
    url: authentication/peking-authentication.yml
- aid: peking:openscow
  name: OpenSCOW / CraneSched research-computing APIs
  x-operator: institution
  x-operator-evidence: Every source file is copyright "Peking University and Peking University Institute for Computing and
    Digital Economy", released under Mulan PSL v2 from the PKU HPC group's own GitHub organisation.
  description: OpenSCOW ("Super Computing On Web") is an HPC portal and management system authored at Peking University; CraneSched
    is its distributed scheduler for HPC and AI workloads. Their APIs are defined in roughly forty Protocol Buffer files across
    portal, mis, audit, hook and scheduler services and consumed over gRPC, with an OpenAPI document generated at build time
    for the SCOW AI service. This is a real institution-authored API contract, but it describes software each site deploys
    itself — the generated document's only server is http://localhost:5006/api — so no hosted base URL is claimed.
  humanURL: https://pkuhpc.github.io/OpenSCOW/
  tags:
  - Research Computing
  - HPC
  - gRPC
  - Protocol Buffers
  - Open-Source
  tags_raw:
  - Research Computing
  - HPC
  - gRPC
  - Protocol Buffers
  - Open Source
  properties:
  - type: GitHubRepository
    url: https://github.com/PKUHPC/OpenSCOW
  - type: Documentation
    url: https://pkuhpc.github.io/OpenSCOW/
  - type: SourceCode
    url: https://github.com/PKUHPC/CraneSched
- aid: peking:opendata-rest
  name: PKU Open Research Data Platform (Dataverse REST API)
  x-operator: institution
  x-operator-evidence: Host opendata.pku.edu.cn is under Peking University's own registrable domain and TLS terminates on
    PKU's own *.pku.edu.cn certificate. The deployment is a PKU-authored customisation of Dataverse — bilingual interface,
    PKU-specific GroupProvider and credentials authentication, a DataCite DOI registration module — published as source.
  x-availability: unreachable
  description: Dataverse-based research data repository operated by the PKU Library across social science, health, bioinformatics
    and NLP collections. Verified live by this catalog on 2026-06-03 (183 dataverses, 485 datasets). During the 2026-08-19
    pass the host completed TLS and answered a 301 on port 80 but never returned an HTTPS response, across seven attempts;
    recorded as unreadable from our vantage point rather than removed, since nothing observed proves the surface is gone.
  humanURL: https://opendata.pku.edu.cn/
  baseURL: https://opendata.pku.edu.cn/api
  tags:
  - Research Data
  - Open Data
  - Dataverse
  - REST
  - Repository
  properties:
  - type: Documentation
    url: https://guides.dataverse.org/en/latest/api/
  - type: SourceCode
    url: https://github.com/pengchengluo/Peking-University-Open-Research-Data-Platform
- aid: peking:opendata-oaipmh
  name: PKU Open Research Data Platform (OAI-PMH)
  x-operator: institution
  x-availability: unreachable
  description: OAI-PMH 2.0 metadata-harvesting endpoint for the Open Research Data Platform, verified responding to the Identify
    verb on 2026-06-03 with Dublin Core and DataCite support via the XOAI toolkit. Unreachable during the 2026-08-19 pass
    on the same terms as the platform's REST API above.
  humanURL: https://opendata.pku.edu.cn/
  baseURL: https://opendata.pku.edu.cn/oai
  tags:
  - OAI-PMH
  - Metadata
  - Harvesting
  - Research Data
  - Repository
  properties:
  - type: Documentation
    url: https://guides.dataverse.org/en/latest/api/oai.html
common:
- type: Website
  url: https://www.pku.edu.cn/
- type: About
  url: https://english.pku.edu.cn/
- type: ResearchRepository
  url: https://ir.pku.edu.cn/
- type: OpenData
  url: https://opendata.pku.edu.cn/
- type: IdentityFederation
  url: https://www.carsi.edu.cn/
- type: LibraryCatalog
  url: https://lib.pku.edu.cn/
- type: CourseCatalog
  url: https://dean.pku.edu.cn/
- type: ResearchComputing
  url: https://hpc.pku.edu.cn/
- type: AIPolicy
  url: https://stl.pku.edu.cn/uploads/202411/26102211_98533_67921156%5B-%5DSTLAcademicRules-AIPolicy-Fall2024.pdf
- type: AITooling
  url: https://lrcguides.stl.pku.edu.cn/c.php?g=967766&p=7037024
- type: Blog
  url: https://news.pku.edu.cn/
- type: GitHubOrganization
  url: https://github.com/PKUHPC
- type: LinkedIn
  url: https://www.linkedin.com/school/peking-university/
- type: Authentication
  url: authentication/peking-authentication.yml
- type: OAuthScopes
  url: scopes/peking-scopes.yml
- type: Conformance
  url: conformance/peking-conformance.yml
- type: ErrorCatalog
  url: errors/peking-errors.yml
- type: Lifecycle
  url: lifecycle/peking-lifecycle.yml
- type: Vocabulary
  url: vocabulary/peking-vocabulary.yml
- type: JSONSchema
  url: json-schema/peking-ir-item.json
- type: Examples
  url: examples/peking-ir-oai-identify-response.xml
- type: JSONLD
  url: json-ld/peking-context.jsonld
- type: DomainSecurity
  url: security/peking-domain-security.yml
- type: Plans
  url: plans/peking-plans-pricing.yml
- type: RateLimits
  url: rate-limits/peking-rate-limits.yml
- type: FinOps
  url: finops/peking-finops.yml
- type: Review
  url: review.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com