{
    "name": "Marc DeCaria site API",
    "description": "Read only JSON access to the essay archive. No key needed.",
    "endpoints": [
        {
            "path": "/api/search?q={query}&limit={1-100}",
            "example": "https://marcdecaria.com/api/search?q=larger%20system",
            "returns": "ranked essays with highlighted snippet"
        },
        {
            "path": "/api/essays",
            "returns": "catalog of every essay (no bodies)",
            "filters": "topic, series, year"
        },
        {
            "path": "/api/essays/{slug}",
            "returns": "one essay with Markdown body"
        },
        {
            "path": "/api/topics",
            "returns": "topics with counts"
        },
        {
            "path": "/api/series",
            "returns": "series with part counts"
        }
    ],
    "also": [
        "https://marcdecaria.com/llms.txt",
        "https://marcdecaria.com/llms-full.txt",
        "https://marcdecaria.com/feed.json",
        "https://marcdecaria.com/sitemap.xml"
    ]
}