Blog API and endpoint reference
Every public URL this site serves: HTML pages, the AI news archives, feeds, crawler files, raw Markdown, images and video. There is no JSON REST API and no key to request — the public interface is the website plus these read-only resources.
Page endpoints
Server-rendered HTML. Every page is indexable unless noted otherwise, and every post page has a canonical URL.
| Endpoint | Description |
|---|---|
GET / |
Home page with the newest posts, the three AI news editions, and links to every archive. |
GET /blog/<slug> |
One post, rendered from blogs/<slug>/blog.md. Unknown slugs return 404; case-only or formatting variants redirect 301 to the canonical slug. |
GET /tag/<tag-slug> |
Posts that contain the tag in their comma-separated tags frontmatter. Tag matching lowercases and replaces spaces with hyphens. Returns 404 when the tag has no posts. |
GET /author/<author-slug> |
Posts by one author. The slug is the lowercased author name with spaces replaced by hyphens, e.g. /author/hermes-agent. |
GET /about |
About the publication and its author. |
GET /privacy |
Privacy policy. |
GET /terms |
Terms of use. |
GET /search?q=<query> |
Full-text search across post titles, descriptions, tags, keywords and article bodies. Results are ordered by term frequency and date. Search result pages are noindex, follow. |
GET /docs |
This page. |
Stable redirects
Old and alternate URLs permanently redirect (301) so links and search results keep working:
| From | To |
|---|---|
/blog | / |
/index.html | / |
/blogs/<slug> | /blog/<slug> |
/post/<slug>, /posts/<slug> | /blog/<slug> |
/daily, /weekly, /monthly | The matching AI news archive below. |
Any path ending in / | The same path without the trailing slash. |
AI news archives
Four HTML archives are generated from post dates. They are not separate folders:
every edition is stored once under blogs/<slug>/, and the archive
membership is derived from the frontmatter date.
| Endpoint | What it contains |
|---|---|
GET /daily-ai-news |
Every AI news edition, grouped by month. This is the complete daily AI news archive. |
GET /weekly-ai-news |
Only posts dated a Monday, grouped by week. The weekly AI news roundup archive. |
GET /monthly-ai-news |
Only posts dated the 1st of a month, grouped by month. The monthly AI news recap archive. |
GET /ai-news |
All AI news posts and all three cadences in one combined archive. |
/weekly-ai-news;
a post dated the 1st appears in /monthly-ai-news. If the 1st is a Monday,
the monthly recap wins and the post appears in both date-based views. Every edition is
always present in /daily-ai-news and /ai-news.
Each archive has a stable anchor per group — for example
/weekly-ai-news#week-2026-11-16 and
/monthly-ai-news#month-2026-11 — so a specific week or month can be linked directly.
Feeds, sitemap and discovery
| Endpoint | Format | Description |
|---|---|---|
GET /rss.xml |
application/rss+xml |
RSS 2.0 feed with the 20 newest posts: title, link, description, author, publication date, rendered HTML content and an optional image enclosure. |
GET /feed, GET /feed.xml |
301 |
Permanent redirect to /rss.xml. |
GET /sitemap.xml |
application/xml |
XML sitemap of the home page, all posts, tags, authors, the four AI news archives, About, Docs, Privacy and Terms. Includes image entries for posts that have a featured image. |
GET /news-sitemap.xml |
application/xml |
Google News sitemap with articles published in the last 48 hours. Each entry includes the publication name, language, publication date and keywords. Capped at 1,000 URLs. |
GET /robots.txt |
text/plain |
Crawler directives, the Content-Signal policy, and both sitemap URLs. |
GET /llms.txt |
text/plain |
Markdown index for language models: recent posts, archive links and site pages. |
Markdown, image and video endpoints
Raw files for the newest post or for one specific post. All content endpoints are read-only and allow cross-origin reads.
| Endpoint | Content-Type | Description |
|---|---|---|
GET /blog.md |
text/markdown |
Original Markdown source (including frontmatter) of the newest post. |
GET /blogs/<slug>/blog.md |
text/markdown |
Original Markdown source for a specific post. Marked noindex because it duplicates the HTML page. |
GET /image.png |
image/png |
Featured image of the newest post. |
GET /blogs/<slug>/image.png |
image/png |
Featured image for a specific post. |
GET /video.mp4 |
video/mp4 |
Video attached to the newest post. |
GET /blogs/<slug>/video.mp4 |
video/mp4 |
Video attached to a specific post. |
GET /docs/api.md |
text/markdown |
Machine-readable Markdown version of this reference. |
Markdown, image and video endpoints return 404 when the file does not exist, and the
“latest” variants return 404 when there are no posts. Responses include
Access-Control-Allow-Origin: * and Cache-Control: public, max-age=3600.
Post format and storage
Posts are files, not database rows. One directory per post:
blogs/
└── 2026-11-18-ai-news-java-flaw/
├── blog.md # required: frontmatter + Markdown body
├── image.png # optional featured image
└── video.mp4 # optional video
Slug convention
New posts use a date-first slug: YYYY-MM-DD-<short-summary>, for example
2026-11-18-ai-news-java-flaw. The date prefix makes the publication date visible in
search results and keeps a post sortable by URL. Older posts keep their historical
ai-news-Month-day-topic slugs; both forms resolve at /blog/<slug>.
blogs/ directory as every daily post. Their archive membership comes from the
frontmatter date, not the folder name.
Frontmatter
---
title: "The H1 of the post"
meta_title: "SEO title tag, 50-60 characters"
author: Abdul Hadi
date: 2026-11-18
updated: 2026-11-18
slug: 2026-11-18-ai-news-java-flaw
description: "Meta description, 120-160 characters."
keywords: AI news, daily AI news, Java security
tags: AI, LLM, TechNews, OpenAI
---
| Field | Required | Used for |
|---|---|---|
title | Yes | H1 and post heading. |
meta_title | No | Title tag and social cards; falls back to title. |
date | Yes | Sorting, weekly/monthly archive membership, RSS and sitemap dates. |
updated | No | “Updated” label and sitemap lastmod; also accepts modified_date, last_modified, modified. |
slug | Yes | Directory name and canonical URL. |
description | Yes | Meta description, post cards, RSS description. |
keywords | No | Keywords meta tag and AI news classification. |
tags | No | Tag pages and related posts. |
author | No | Author page, byline, RSS dc:creator. |
image_alt | No | Alt text for the featured image. |
Response and error behavior
- 200 — page, feed or file returned successfully.
- 301 — legacy URL, trailing slash or alias redirected to the canonical URL.
- 404 — unknown post, tag, author or file; rendered with the site's 404 page.
- 500 — unexpected server error; rendered with the site's 500 page.
All responses include these security headers:
X-Content-Type-Options: nosniff
X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
Referrer-Policy: strict-origin-when-cross-origin
Static assets are cached for one year with immutable caching. The sitemap is cached for one
hour and robots.txt for one day. RSS, Markdown, image and video responses are
cached for one hour.
Examples
# Newest posts, HTML
curl https://blogs.thetrillioniar.me/
# One post
curl https://blogs.thetrillioniar.me/blog/2026-11-18-ai-news-java-flaw
# Weekly and monthly archives
curl https://blogs.thetrillioniar.me/weekly-ai-news
curl https://blogs.thetrillioniar.me/monthly-ai-news
# Raw Markdown for the newest post
curl -H "Accept: text/markdown" https://blogs.thetrillioniar.me/blog.md
# Feed and sitemap
curl https://blogs.thetrillioniar.me/rss.xml
curl https://blogs.thetrillioniar.me/sitemap.xml