For developers
API
Read a published timeline as JSON, or drop it on your own site. No key, no signup, no rate limit worth documenting. Published companies only.
| Method | Path | What it returns |
|---|---|---|
| GET | /c/{slug} | A published timeline, as a page. |
| GET | /embed/{slug} | The same timeline as a self-contained widget for your own site. Accepts ?theme=light|dark and ?limit=3–12. |
| GET | /c/{slug}/opengraph-image | The share card: name, verified MRR, growth and the curve. 1200×630 PNG. |
| GET | /c/{slug}/m/{key} | One moment from a timeline, with its own share card at /opengraph-image. |
| GET | /api/v1/entities/{slug} | A company as JSON. Published companies only; anything else is a 404. |
| GET | /api/v1/export | The completeness manifest: every anchored record and the batch it belongs to, for independent verification. |
Nothing unpublished is reachable
A company that has not published returns 404 from every route above — including the share image, which link previewers fetch without a session. Not 403: confirming that a private company exists is itself a disclosure, so a private company and a company that was never created answer identically.
There is no write API and no partner API. The endpoints the dashboard uses are its own plumbing, are scoped to the signed-in account, and are not documented here because they are not a surface anyone else should build on.
Embedding
The embed is one iframe and one optional script. The script only resizes the frame as the content changes; without it the iframe keeps the height you give it.
<iframe src="https://thonest.com/embed/your-company"
style="width:100%;height:520px;border:0"></iframe>
<script src="https://thonest.com/embed.js" async></script>It follows the visitor’s light or dark setting unless you pass ?theme=light or ?theme=dark.
How the numbers are computed
Every MRR figure comes from one versioned definition applied to every company: annual plans amortised, trials excluded, discounts applied, mixed currencies refused rather than converted at a rate we would have to guess. Figures derived from historical subscriptions rather than observed at the time are marked reconstructed.