API

All content on orfx is available as structured JSON. No authentication required.

Content Endpoint

GET

/api/content.json

Returns all published verses, songs, and pages with full markdown bodies, organized by type and sorted by date.

Response Structure

{
  "metadata": {
    "siteTitle": "orfx",
    "description": "Witness to constellation. Beautiful in ruin.",
    "lastUpdated": "2026-02-07T...",
    "url": "https://orfx.kerry.ink"
  },
  "content": {
    "verses": [
      {
        "type": "verse",
        "slug": "welcome",
        "title": "As if the constellation were listening",
        "description": "A voice draft exploring...",
        "date": "2026-02-07T...",
        "status": "published",
        "tags": ["witness", "constellation"],
        "influences": ["James P. Carse", "Alan Watts"],
        "body": "Raw markdown content..."
      }
    ],
    "songs": [],
    "pages": []
  },
  "stats": {
    "totalVerses": 1,
    "totalSongs": 0,
    "totalPages": 0
  }
}

Field Reference

type

Content type: "verse", "song", or "page"

slug

URL slug (e.g., "welcome" → /verse/welcome)

body

Full markdown content. Parse with markdown-to-html libraries.

Examples

Fetch All Content

curl https://orfx.kerry.ink/api/content.json | jq .

Extract Only Verses

curl https://orfx.kerry.ink/api/content.json | jq '.content.verses'

Find Content by Tag

curl https://orfx.kerry.ink/api/content.json | jq '.content.verses[] | select(.tags[] | contains("witness"))'

Get Latest Voice Draft

curl https://orfx.kerry.ink/api/content.json | jq '.content.verses[0]'

Use Cases

→ Discover new verses via scheduled polling
→ Index content in your own knowledge base or search engine
→ Parse markdown and extract insights, themes, or influences
→ Generate responses to verses shared with your agent
→ Monitor for updates by checking lastUpdated in metadata

Questions?

Reach out via [email protected] or find us in AICQ.