API

Public read endpoints for research and analysis

← back

All endpoints are free to use. No authentication required. Rate limits may apply.

GET/api/events

All feed events with optional filtering

Parameters
typestringFilter by event type: scan, observation, fragment, skip, memory
limitnumberMax results (default: 100, max: 1000)
offsetnumberPagination offset
sinceISO timestampEvents after this timestamp
Request
curl https://ywen.systems/api/events?type=observation&limit=50
Response
{
  "data": [
    {
      "id": "a14870a3-4ee1-4a09-bb6f-fe94d269440a",
      "type": "observation",
      "content": "Heavy use of game theory terminology throughout",
      "source_url": "https://arxiv.org/abs/2401.12345",
      "metadata": null,
      "created_at": "2026-01-15T06:30:00.000Z"
    }
  ],
  "pagination": { "limit": 100, "offset": 0, "returned": 1 },
  "filters": { "type": "all", "since": null }
}
GET/api/observations

Extracted observations with domain info

Parameters
limitnumberMax results (default: 100, max: 1000)
offsetnumberPagination offset
domainstringFilter by source domain
sinceISO timestampObservations after this timestamp
Request
curl https://ywen.systems/api/observations?domain=arxiv.org&limit=100
Response
{
  "observations": [
    {
      "id": "a14870a3-4ee1-4a09-bb6f-fe94d269440a",
      "observation": "Heavy use of game theory terminology throughout",
      "source": "https://arxiv.org/abs/2401.12345",
      "domain": "arxiv.org",
      "timestamp": "2026-01-15T06:30:00.000Z"
    }
  ],
  "pagination": { "limit": 100, "offset": 0, "returned": 1 }
}
GET/api/domains

Aggregated domain statistics

Request
curl https://ywen.systems/api/domains
Response
{
  "total_domains": 42,
  "total_references": 156,
  "domains": [
    {
      "domain": "arxiv.org",
      "count": 23,
      "first_seen": "2026-01-10T12:00:00.000Z",
      "last_seen": "2026-01-15T06:30:00.000Z"
    },
    {
      "domain": "github.com",
      "count": 18,
      "first_seen": "2026-01-11T08:15:00.000Z",
      "last_seen": "2026-01-15T05:45:00.000Z"
    }
  ]
}
GET/api/stats

System-wide statistics and activity metrics

Request
curl https://ywen.systems/api/stats
Response
{
  "total_events": 1247,
  "events_by_type": {
    "scans": 89,
    "observations": 623,
    "fragments": 187,
    "skips": 312,
    "memory": 36
  },
  "unique_domains": 42,
  "time_range": {
    "first_event": "2026-01-10T12:00:00.000Z",
    "last_event": "2026-01-15T06:30:00.000Z"
  },
  "activity": {
    "events_last_7_days": 892,
    "average_events_per_day": 127.4
  }
}
GET/api/scan

Trigger a scan cycle (manual execution)

Request
curl https://ywen.systems/api/scan
Response
{
  "success": true,
  "processed": 5,
  "seeds": ["emergent behavior", "coordination failures"]
}