---
title: "API — imlucas.dev"
description: "Machine-readable versions of imlucas.dev for scripts and AI agents: Markdown content negotiation, llms.txt, OpenAPI spec, API catalog, JSON search index and feeds."
url: https://imlucas.dev/api/
---

// api

# Machine-readable resources

Everything on this site is available in a form that scripts and AI agents can consume without scraping HTML. It is all static, read-only and free of authentication.

## Markdown for agents

Every page has a Markdown rendering. Request any URL with `Accept: text/markdown` and the response comes back as `Content-Type: text/markdown` with `Vary: Accept`. Browsers keep receiving HTML.

```
curl -H 'Accept: text/markdown' https://imlucas.dev/blog/hello-world/
```

The same file is reachable directly as `index.md` next to each page, for example [/blog/hello-world/index.md](https://imlucas.dev/blog/hello-world/index.md). Blog posts return their original Markdown source with a YAML front matter block (title, description, author, date, tags, url). Other pages are converted from the HTML at build time.

## Endpoints

-   [/llms.txt](https://imlucas.dev/llms.txt) text/markdown
    
    Site overview for language models: every post and page with a one-line summary.
    
-   [/openapi.json](https://imlucas.dev/openapi.json) application/json
    
    OpenAPI 3.1 description of the endpoints on this page.
    
-   [/.well-known/api-catalog](https://imlucas.dev/.well-known/api-catalog) application/linkset+json
    
    RFC 9727 API catalog pointing at the OpenAPI spec and this page.
    
-   [/search.json](https://imlucas.dev/search.json) application/json
    
    All published posts: id (URL slug), title, description, tags, pubDate. Newest first.
    
-   [/rss.xml](https://imlucas.dev/rss.xml) application/rss+xml
    
    RSS 2.0 feed of all posts.
    
-   [/sitemap-index.xml](https://imlucas.dev/sitemap-index.xml) application/xml
    
    XML sitemap index.
    
-   [/robots.txt](https://imlucas.dev/robots.txt) text/plain
    
    Crawl rules plus Content-Signal preferences (ai-train, search, ai-input).
    

## Discovery

Every response carries a `Link` header pointing at `llms.txt` (`rel="describedby"`) and at the API catalog (`rel="api-catalog"`). Pages embed schema.org JSON-LD (WebSite, Person and, on posts, BlogPosting) and a `<link rel="alternate" type="text/markdown">` to their Markdown rendering.

## Terms

No key, no login, no rate limit beyond the CDN's. The content signals in `robots.txt` allow search indexing, AI grounding and AI training. If you quote a post, link back to it.