Public API

Endpoints

All endpoints are static JSON files regenerated on every build. No authentication required. CORS is enabled for client-side use.

Endpoint	Returns
/api/articles.json	All published articles with metadata
/api/sections.json	Editorial sections with descriptions and article counts
/api/authors.json	All authors with their bylines and article counts
/api/quotes.json	All quotes with author, source, era, and tags
/api/timeline.json	Historical timeline entries
/api/glossary.json	All glossary terms with definitions
/api/bookshelf.json	Recommended reading entries
/api/events.json	Upcoming and past events
/api/videos.json	Video library entries
/api/songs.json	Food Music song collection
/api/trials.json	Trials of Thought entries
/api/thought-experiments.json	Thought experiments
/api/manifest.json	Index of all endpoints with metadata

Example: Fetching recent articles

fetch('https://theumamipost.com/api/articles.json')
  .then(r => r.json())
  .then(data => {
    console.log(`${data.count} articles`);
    data.articles.slice(0, 5).forEach(a => {
      console.log(`${a.title}, ${a.section}`);
    });
  });

Data format

Each endpoint returns a JSON object with:

• generated, ISO 8601 timestamp of the build
• count, total items in the response
• [collection_name], array of items (e.g. articles, quotes, events)

Usage terms

The API is free to use for any purpose, commercial or non-commercial, with the following conditions:

• Content remains the property of its authors (editorial articles) or the public domain (library texts)
• Attribution is appreciated but not required
• Please be considerate with request volume, these are static files on a CDN, but high-frequency polling should use the RSS feed instead
• Let us know what you build, we'd love to see it

Feeds and sitemaps

• /feed.xml, RSS feed of recent articles
• /sitemap.xml, XML sitemap of all pages
• /news-sitemap.xml, Google News sitemap