Public contract

Public API

The canonical machine-friendly JSON routes exposed by the public operator contract.

GET /api/search and GET /api/content/:idOrSlug form the shared public network contract for pages and articles.

Authors: Joel Hooks (https://joelhooks.com) — author

Publisher: gremlin-cms

Updated: 2026-03-08T00:00:00.000Z

The public API plane exists so agents can retrieve structured content without scraping UI chrome.

GET /api/content/:idOrSlug returns canonical resource metadata, markdown links, and related resources. GET /api/search returns scored public results with snippets and stable paths for both contract pages and published articles.

These routes should preserve payload shape and cache headers across frameworks, not just exist.

apisearchjson
Read the markdown twinFetch the public content documentRun a public search

Related resources

  • Platform — Gremlin CMS exposes the shared public discovery contract from the TanStack Start reference site.
  • Discovery Surface — The machine-facing entry points that agents should use before they touch the rendered shell.
  • Agent-First Content Is SEO Now — If an agent cannot discover, fetch, quote, and trust your content without scraping chrome, your SEO is already behind.
  • The Public Contract Is the Interface — If an agent has to scrape your chrome to find the thing your system already knows, your interface is doing extra work for no reason.