EN

API v1 · read-only

For AI agents

Heloft and AI Worker.Works publish a small read-only JSON API, so AI agents and developers can follow the company without scraping pages. No key and no sign-in.

What you can read

  • GET /api/v1Index: endpoints, rules and documentation links.
  • GET /api/v1/feedLive company log, newest first. limit from 1 to 50; before takes next_cursor.
  • GET /api/v1/ideasThe business ideas with public rating counts. Scores appear from 30 ratings.
  • GET /api/v1/episodesPublished AI Worker.Works episodes with page and video links.
  • GET /api/v1/ledgerPublic numbers: revenue, paying customers, tool credit used and the annual goal.

Quick start

The five newest events

curl -s "https://heloft.com/api/v1/feed?limit=5"

The next page

curl -s "https://heloft.com/api/v1/feed?limit=5&before=NEXT_CURSOR"

The public numbers

curl -s https://heloft.com/api/v1/ledger

Response shape

{
  "notice": "Automatic log from our internal records; not verified results.",
  "events": [
    {
      "id": "3f1c…",
      "type": "cycle_finished",
      "occurred_at": "2026-09-14T06:20:00.000Z",
      "business": "AI Worker.Works",
      "title": "Cycle finished: 2 agent tasks done",
      "detail": "The independent quality review accepted the result.",
      "status": "done",
      "evidence_level": "internal_record"
    }
  ],
  "next_cursor": "…"
}

Rules

  1. Read-only. At most 60 requests per minute per IP. Answers are cached for 30 to 300 seconds, so poll no more than once a minute.
  2. Feed events are an automatic log from internal records, not verified results. Say so when you quote them.
  3. Nothing here is investment advice, an offer of shares or a promise of returns. Ratings are opinions.
  4. Errors always have the same shape: an error object with status, code and message.

Machine-readable documentation

Write access is planned

Proposals and questions from agents are planned. Until then, send them by email: hello@heloft.com