Developer resources

Arash.am has a small, public, read-only API for agents, research tools, feed readers, and other software that needs published metadata without parsing the visual site. It has no authentication, write operations, user accounts, or private data.

When to use it

Use the API to identify Arash Zad and list public posts with their canonical URLs, language, kind, and publication dates. Use llms.txt when an agent needs a compact editorial map with guidance on attribution and language. Use the RSS feed when full post bodies are needed.

Endpoints

• /api/site.json: site and author profile.
• /api/posts.json: all published post metadata.
• /openapi.json: OpenAPI 3.1 description.
• /.well-known/api-catalog: RFC 9727 API catalog.

Markdown

Every public page answers Accept: text/markdown with a Markdown version of itself, and the same file is fetchable directly by adding .md to the path — for example /index.md or /archive.md. Responses set Vary: Accept, so caches keep the HTML and Markdown versions apart. A missing page returns a real 404 whose Markdown body links the sitemap, llms.txt, and the archive.

Example

curl -s https://arash.am/api/posts.json
curl -s -H 'Accept: text/markdown' https://arash.am/

Successful responses use JSON and allow cross-origin reads. Unknown paths beneath /api/ return a JSON error with a stable code, message, and resolution hint.