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).