Public content API

maximofn.com exposes a read-only public API with the index of its content (blog articles, projects and tips). It requires no authentication and is designed for AI agents, crawlers and developers who want to discover the site's content in a machine-readable way.

Endpoints

• GET /api/v1/content.json — full content index (es / en / pt-br). Versioned route: pin this one.
• GET /api/content.json — unversioned alias, always follows the latest.

Versioning

Routes under /api/{version}/ keep their shape: existing fields are never removed or retyped, only new ones are added. A breaking change ships as a new version and the previous one keeps working. So for a stable integration, point at /api/v1/content.json rather than the unversioned alias.

Deprecation policy: when a new version ships, the previous one keeps being served unchanged for at least 12 months. During that period its responses carry Deprecation and Sunset headers with the retirement date, and the versions.deprecation field in the JSON announces the successor. After that date the retired route answers 410 Gone with a JSON body pointing at the current version.

Specification and discovery

• OpenAPI 3.1 (/openapi.json) — machine-readable documentation.
• /.well-known/ai-plugin.json — manifest for AI agents.
• /llms.txt — navigation guide for LLMs.
• /mcp — MCP (Model Context Protocol) server with the tools list_content, search_content and content_stats.

Features

• No authentication or API keys.
• Read-only (GET requests).
• No rate limits.
• JSON response (application/json), with URLs in es / en / pt-br.
• Versioned through the OpenAPI specification.

Example response

{
  "site": "https://www.maximofn.com",
  "name": "MaximoFN",
  "languages": ["es", "en", "pt-br"],
  "counts": { "posts": 78, "projects": 11, "tips": 13, "total": 102 },
  "content": [
    {
      "type": "post",
      "title": "QLoRA Explained: NF4 Quantization...",
      "description": "...",
      "url": "https://www.maximofn.com/qlora",
      "url_en": "https://www.maximofn.com/en/qlora",
      "url_pt": "https://www.maximofn.com/pt-br/qlora",
      "image": "https://images.maximofn.com/QLoRA_thumbnail_ES.webp"
    }
  ]
}

Quickstart

No authentication required: a single GET request returns the whole index.

# curl
curl https://www.maximofn.com/api/content.json

# Python
import httpx
data = httpx.get("https://www.maximofn.com/api/content.json").json()
posts = [c for c in data["content"] if c["type"] == "post"]
print(len(posts), "posts")

// JavaScript
const res = await fetch("https://www.maximofn.com/api/content.json");
const data = await res.json();
console.log(data.counts);

The content is owned by MaximoFN; its use is allowed for discovery and indexing.