# McMaster Experts API

**Canonical:** https://apis.io/apis/mcmaster/experts-api/  
**Provider:** McMaster University — https://apis.io/providers/mcmaster/  
**Base URL:** https://experts.mcmaster.ca  
**Documentation:** https://experts.mcmaster.ca/

McMaster Experts API is one of 8 APIs that [McMaster University](https://apis.io/providers/mcmaster/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Research, Expertise Discovery, Scholarly Communication, Publications, and Directory. The published artifact set on APIs.io includes an OpenAPI specification, a JSON-LD context, authentication docs, and 1 JSON Schema.

Public, unauthenticated JSON API behind McMaster Experts, the university's researcher and expertise discovery gateway. Three operations confirmed by live probe on 2026-09-01: a cross-entity keyword search over people, groups, labels and publications; a directory listing of 7,301 people filterable by free text, group and sort order; and a listing of 273,828 scholarly works filterable by free text and date order. Undocumented by McMaster — no developer portal entry, no OpenAPI, no terms, no published rate limit. The contract in this repository was written by probing, not from documentation. The people endpoint returns personal data including the MacID institutional login identifier; see review.yml.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/search` | Search across all indexed entity types |
| GET | `/api/people` | List researcher and staff directory records |
| GET | `/api/publications` | List scholarly works |

## Machine-readable artifacts (11)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/mcmaster/refs/heads/main/openapi/mcmaster-experts-openapi.yml
- **OpenAPIOriginal** — https://raw.githubusercontent.com/api-evangelist/mcmaster/refs/heads/main/openapi/_original/mcmaster-experts-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/mcmaster/refs/heads/main/json-schema/mcmaster-experts-schemas.json
- **Examples** — https://raw.githubusercontent.com/api-evangelist/mcmaster/refs/heads/main/examples/mcmaster-experts-examples.yml
- **Rules** — https://raw.githubusercontent.com/api-evangelist/mcmaster/refs/heads/main/rules/mcmaster-experts-rules.yml
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/mcmaster/refs/heads/main/json-ld/mcmaster-experts-context.jsonld
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/mcmaster/refs/heads/main/authentication/mcmaster-authentication.yml
- **Errors** — https://raw.githubusercontent.com/api-evangelist/mcmaster/refs/heads/main/errors/mcmaster-errors.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/mcmaster/refs/heads/main/lifecycle/mcmaster-lifecycle.yml
- **Website** — https://experts.mcmaster.ca/about
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/mcmaster/refs/heads/main/apis.yml

## Other McMaster University APIs (7)

- [MacSphere Institutional Repository](https://apis.io/apis/mcmaster/macsphere/)
- [McMaster University Shibboleth Identity Provider](https://apis.io/apis/mcmaster/shibboleth-idp/)
- [McMaster API Service Developer Portal](https://apis.io/apis/mcmaster/developer-portal/)
- [McMaster University Dataverse on Borealis](https://apis.io/apis/mcmaster/borealis-dataverse/)
- [McMaster University DataCite Registration](https://apis.io/apis/mcmaster/datacite/)
- [McMaster University Library Crossref Membership](https://apis.io/apis/mcmaster/crossref/)
- [McMaster University ROR Registration](https://apis.io/apis/mcmaster/ror/)

## Tags

Research, Expertise Discovery, Scholarly Communication, Publications, Directory, JSON, Personal Data

---

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