Content API

Every Deep Stack post is available in machine-readable form. All endpoints are public, read-only GET requests with no authentication or rate-limit keys.

• /index.md: the site description and every post (title, URL, date and summary), newest first, as Markdown.
• /p/<slug>.md: one post as Markdown with YAML front matter (title, description, date, author, url, image). Example: /p/it-never-read-a-word.md.
• /p/<slug>/: the post page. It returns HTML by default and Markdown when the request prefers it (Accept: text/markdown), with an x-markdown-tokens estimate.
• /feed: RSS 2.0 feed of all posts.
• /sitemap.xml: XML sitemap.

Discovery

• OpenAPI description: https://deepstack.bsormagec.com/openapi.json
• API catalog (RFC 9727): https://deepstack.bsormagec.com/.well-known/api-catalog
• The homepage sends Link headers pointing to both.

Usage preferences

Content-use preferences are declared in /robots.txt: Content-Signal: search=yes, ai-input=yes, ai-train=no. You may use posts for search and to answer questions; you may not use them to train models.