Poliety is a news feed for AI agents. Humans can read it too. The site at poliety.com, its feeds and /api/latest.json are free and always will be. This keyed API adds what a static site cannot: memory. History, change cursors and filtered queries.
Every /v1 endpoint requires a key in the Authorization header. Checkout is hosted by Stripe and keys start at $19 a month; your key arrives by email after purchase.
curl -H "Authorization: Bearer YOUR_KEY" https://api.poliety.com/v1/changes
Keys ride in the header only. Requests with keys in the URL are rejected: URLs leak into logs.
| Endpoint | What it returns |
|---|---|
GET /v1/latest | The current edition (schema poliety.edition.v1) with per-item contentHash and firstSeenAt. Sends ETag; answer If-None-Match and unchanged editions cost you nothing (an unmetered 304). |
GET /v1/changes | Everything new since your last call. Pass the cursor from the previous response. Filters: section, minScore, change (added, updated, score_changed, aged_out), kind (wire, brief), limit. First call without a cursor returns a starting cursor. since (ISO 8601 time) is accepted as a coarser alternative. |
GET /v1/wire | Query the wire history. Filters: section, minScore, since, until (publication time), source, active=1 (currently live items only), limit. |
GET /v1/editions | The edition hash chain: every archived day with contentHash and prevHash. Record a hash and you can detect any silent rewrite of history. |
GET /v1/editions/<date> | One archived edition, byte-faithful as ingested. |
GET /v1/items/<id> | One wire item with its full event history and firstSeenAt: when Poliety first observed it. |
GET /v1/usage | Your own meter for the last 7 days. What we count is what you can see. |
GET /health | Unauthenticated liveness check. |
Builder keys: 60 requests a minute, 5,000 metered requests a day. Conditional 304s are not metered. Rate-limited responses carry Retry-After. Need more? Email dburks@nuralyn.com.
Item and brief contentHash values are sha256 over canonical JSON of the content fields (score excluded), identical to the hashes in the free latest.json. Editions form an append-only hash chain. All text is sanitized plain text: no HTML, no control characters, safe to place in a context window.
poliety.edition.v1 and poliety.changes.v1 never break: fields are only ever added, never renamed, retyped or removed. Breaking changes would ship as a v2 alongside a still-working v1.
This service stores: a derived key id, a sha256 hash of your key (never the key itself), your plan, your Stripe subscription id, and per-day request counters per endpoint. Payment details live with Stripe and never touch this service. Logs carry the key id, path and status. We do not store IP addresses; transient platform logs at our host are outside our retention. Cancel any time; keys deactivate automatically within a day of cancellation or refund.
The free tier is the whole site: llms.txt, JSON Feed, RSS and latest.json with full article text. It stays free, with attribution. This API exists so the lights stay on.