# ScholarSphere API

**Canonical:** https://apis.io/apis/pennsylvania-state-university/scholarsphere/  
**Provider:** Pennsylvania State University — https://apis.io/providers/pennsylvania-state-university/  
**Base URL:** https://scholarsphere.psu.edu/api/v1  
**Documentation:** https://scholarsphere.psu.edu/

ScholarSphere API is one of 9 APIs that [Pennsylvania State University](https://apis.io/providers/pennsylvania-state-university/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Research Data, Research Repository, Open Access, DOI, and DataCite. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, SDKs, and authentication docs.

Penn State's next-generation institutional repository, written by Penn State University Libraries and released under MIT — not a Figshare, Dataverse or DSpace tenancy. The API is described by the Libraries' own OpenAPI 3.0.2 document with servers set to https://scholarsphere.psu.edu/api/{version}, covering ingest, collections, file upload, featured resources and a public DOI index. Penn State mints its own DataCite DOIs against the service under prefix 10.26207 as repository client psu.scholar. Access is by X_API_KEY header issued by the ScholarSphere team.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| POST | `/ingest` | Publishes a new work |
| POST | `/collections` | Creates a new collection |
| GET | `/dois` | List of all DOIs |
| GET | `/dois/{doi}` | Search for a DOI |
| PUT | `/files` | Updates a file's metadata |
| POST | `/featured_resources` | Adds a new featured resource to the home page |
| POST | `/uploads` | Requests a pre-signed URL to upload a file into ScholarSphere's S3 instance |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/pennsylvania-state-university/refs/heads/main/openapi/pennsylvania-state-university-scholarsphere-api-openapi.yml
- **OpenAPI** — https://raw.githubusercontent.com/psu-libraries/scholarsphere/main/openapi.yml
- **Documentation** — https://docs.scholarsphere.psu.edu/
- **TermsOfService** — https://scholarsphere.psu.edu/about
- **GitHub** — https://github.com/psu-libraries/scholarsphere
- **SDK** — https://github.com/psu-libraries/scholarsphere-client
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/pennsylvania-state-university/refs/heads/main/authentication/pennsylvania-state-university-authentication.yml
- **x-examples** — https://raw.githubusercontent.com/api-evangelist/pennsylvania-state-university/refs/heads/main/examples/pennsylvania-state-university-scholarsphere-unauthenticated-example.json
- **Errors** — https://raw.githubusercontent.com/api-evangelist/pennsylvania-state-university/refs/heads/main/errors/pennsylvania-state-university-problem-types.yml

## Other Pennsylvania State University APIs (8)

- [Researcher Metadata Database (RMD) API](https://apis.io/apis/pennsylvania-state-university/rmd/)
- [ETDA OAI-PMH Provider](https://apis.io/apis/pennsylvania-state-university/etda-oai-pmh/)
- [Penn State Identity Federation (InCommon / Shibboleth)](https://apis.io/apis/pennsylvania-state-university/identity-federation/)
- [Pennsylvania State University Buildings API](https://apis.io/apis/pennsylvania-state-university/pennsylvania-state-university-buildings-api/)
- [Pennsylvania State University Campuses API](https://apis.io/apis/pennsylvania-state-university/pennsylvania-state-university-campuses-api/)
- [Pennsylvania State University Events API](https://apis.io/apis/pennsylvania-state-university/pennsylvania-state-university-events-api/)
- [Pennsylvania State University Health API](https://apis.io/apis/pennsylvania-state-university/pennsylvania-state-university-health-api/)
- [Pennsylvania State University Rooms API](https://apis.io/apis/pennsylvania-state-university/pennsylvania-state-university-rooms-api/)

## Tags

Research Data, Research Repository, Open Access, DOI, DataCite

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/pennsylvania-state-university/scholarsphere/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/pennsylvania-state-university/.