API
Public APIs
Read-only JSON endpoints for public, published catalog records. No authentication is required. Responses allow cross-origin requests and are cached for 5 minutes.
Endpoints
| Endpoint | Description |
|---|---|
| GET /api/catalog/items/ | Documents, searched, filtered and sorted. |
| GET /api/catalog/items/<slug>/ | A document's full public record. |
| GET /api/catalog/collections/ | Top-level collections. |
| GET /api/catalog/collections/<slug>/ | A collection with its parent, subcollections and document count. |
| GET /api/catalog/people/<id>/ | A person with their document count and per-role counts. |
| GET /api/catalog/organizations/<id>/ | An organization with its document count and per-role counts. |
| GET /api/catalog/subjects/<id>/ | A subject with its document count. |
| GET /api/catalog/languages/<code>/ | A language with its document count. |
| GET /api/catalog/formats/<slug>/ | A format with its document count. |
| GET /api/catalog/types/<slug>/ | A type with its document count. |
| GET /api/catalog/categories/<slug>/ | A category with its document count. |
| GET /api/catalog/facets/people/ | A–Z index of everyone credited on a public document. |
| GET /api/catalog/facets/organizations/ | A–Z index of all credited organizations. |
| GET /api/catalog/facets/authors/ | A–Z index of authors. |
| GET /api/catalog/facets/editors/ | A–Z index of editors. |
| GET /api/catalog/facets/translators/ | A–Z index of translators. |
| GET /api/catalog/facets/annotators/ | A–Z index of annotators. |
| GET /api/catalog/facets/source-providers/ | A–Z index of source providers (people). |
| GET /api/catalog/facets/publishers/ | A–Z index of publishers. |
| GET /api/catalog/facets/printers/ | A–Z index of printers. |
| GET /api/catalog/facets/libraries/ | A–Z index of holding libraries. |
| GET /api/catalog/facets/centres/ | A–Z index of digitization centres. |
| GET /api/catalog/facets/source-institutions/ | A–Z index of source institutions. |
| GET /api/catalog/facets/languages/ | A–Z index of languages. |
| GET /api/catalog/facets/subjects/ | A–Z index of subjects. |
| GET /api/catalog/facets/categories/ | A–Z index of categories. |
| GET /api/catalog/facets/formats/ | A–Z index of formats. |
| GET /api/catalog/facets/types/ | A–Z index of types. |
People, organizations and subjects can also be addressed with their name slug, as on the public site: /api/catalog/people/<id>/<slug>/. The slug is ignored.
Entity and collection records do not embed their documents. They link to them with items_url, which is an /api/catalog/items/ URL filtered to that record (eg: /api/catalog/items/?author=12).
Pagination (all list endpoints)
| Parameter | Description |
|---|---|
| page | Page number, from 1. A page past the end returns 404. |
| per_page | Results per page, 1–100. Default 24. |
/api/catalog/items/
| Parameter | Description |
|---|---|
| q | Searches titles, alternate titles, abstracts and the names of credited people. |
| from,to | Publication year range, inclusive (eg:from=1900&to=1950). |
| shelf | latest,featuredorrare: the home page's shelves. |
| sort | year-asc(default),year-desc,newest,oldest,title,title-desc,author,author-desc,language,language-desc,pages,pages-desc. |
| <facet>=<id> | Filters by a record's ID. Repeat a facet to match any of several values (language=1&language=2); different facets combine (language=1&author=5). |
Facets: person, organization, author, editor, translator, annotator, source_provider, publisher, printer, holder, digitizer, source_institution, language, subject, type, format, category, collection.
person and organization match any role; the others match one role (eg: publisher). IDs come from the id fields of entity and index results.
A–Z indexes
| Parameter | Description |
|---|---|
| q | Filters names containing the text. |
| letter | Names starting with this letter. The index's available letters are returned inletters. |
Responses
| Response | Fields or behavior |
|---|---|
| List | total,page,pages,per_page,next,previous,results. |
| Record | Public metadata for the requested record. Related documents are linked throughitems_url. |
| Not found | HTTP 404 with{"error": "Not found"}for missing records, out-of-range pages or disabled endpoints. |
Example: /api/catalog/items/?q=history&from=1900&to=1950&per_page=10.
MCP
The Model Context Protocol (MCP) endpoint lets AI assistants search and read the same public catalog.
| Connection | Value |
|---|---|
| Endpoint | /mcp/on this site's host. |
| Transport | Stateless Streamable HTTP. Send JSON-RPC messages withPOSTandContent-Type: application/json. |
| Authentication | None. Read-only access to public, published records. |
| Responses | JSON; no sessions or SSE streams. Tool results contain the API response as text. |
| Methods | initialize,ping,tools/list,tools/call. |
| Availability | Enabled separately from the public JSON API. Disabled endpoints return HTTP 404. |
| Tool | Arguments | Returns |
|---|---|---|
| search_items | Optional item search parameters above. Facets are arrays of IDs, e.g.{"author": [12]}. | Paginated document summaries. |
| get_item | Required:slug. | Full public document record. |
| list_collections | Optional:page,per_page. | Top-level collections. |
| get_collection | Required:slug. | Collection, parent, subcollections and document count. |
| get_entity | Required:kind,id(string). Kinds:people,organizations,subjects,languages,formats,types,categories. | Entity and document counts. Use a numeric ID for people, organizations and subjects; a language code for languages; a slug otherwise. |
| list_index | Required:index(an A–Z index listed above, e.g.authors). Optional:q,letter,page,per_page. | Paginated index entries and document counts. |
Configure an MCP client with this site's full /mcp/ URL. For Claude Code: claude mcp add --transport http gpura https://<host>/mcp/ (replace <host> with the site's hostname).