Skip to content
For agents · For machines

A publication agents can cite.

Hindsite's editorial pipeline produces structured data on its way to producing prose: atomic claims, semantic clusters, source citations, libel checks, bias classifications. Every one of those layers is reachable as JSON. Build on top.

Discovery

GEThindsite.app/llms.txt

Plain-text index of the editorial surfaces and the canonical JSON endpoints. Cache the whole file aggressively.

GETapi.hindsite.app/openapi.json

Full OpenAPI 3 schema for every documented endpoint, generated from FastAPI.

Editorial pieces

GETapi.hindsite.app/thoughts

Index of published pieces. Filter by slot, author, event.

GETapi.hindsite.app/thoughts/{slug}

Full piece — body_md, citations, cited_sources (with their atomic claims), bias score, generation cost, illustration provenance.

GETapi.hindsite.app/explainers

Index of explainers.

GETapi.hindsite.app/explainers/{slug}

Current version + a versions[] array of every revision.

GETapi.hindsite.app/explainers/{slug}/v/{n}

Historical version content.

GETapi.hindsite.app/explainers/{slug}/v/{n}/diff

Paragraph-level diff of summary + body between v(n-1) and v(n).

Events, claims, clusters

GETapi.hindsite.app/events/{slug}

Event metadata + article list.

GETapi.hindsite.app/events/{slug}/cluster-graph

Nodes (claim clusters) + edges (semantic similarity) for the catalogue graph.

GETapi.hindsite.app/events/{slug}/cluster-timeline

Clusters ordered by inferred publish date.

GETapi.hindsite.app/api/claims

Flat claim records with filters: ?event=, ?claim_type=, ?attributed=, ?publisher=, ?since=, ?limit=, ?offset=. Each record carries its event + article context inline so a single fetch is enough for citation work.

Search + discovery

GETapi.hindsite.app/search/all?q=

FTS5 across thought pieces, explainers, and event titles. Returns bm25-ranked hits with <mark>-wrapped snippets.

GETapi.hindsite.app/calendar

Scheduled + unscheduled + ongoing events with tags.

Example: pull every attributed claim about an event

curl -sH 'User-Agent: my-agent/1.0' \
  'https://api.hindsite.app/api/claims?event=2026-strait-of-hormuz-crisis&attributed=true&limit=50' \
  | jq '.items[] | {publisher, attribution, claim_text}'

Each claim links back to the underlying article URL so an agent can verify against the original source. Hindsite's atomic claim format is designed to be cited and disagreed with.

Etiquette

  • Identify yourself in User-Agent. Bot traffic is welcome — we want to be cited.
  • Cache aggressively. Piece JSON changes only on publish or correction; claims are append-only.
  • Cite by canonical URL: https://hindsite.app/thoughts/{slug} or /explainers/{slug}.
  • When republishing a claim, link the source article from the citations array.
  • Rate limit: 30 req/min unauthenticated. Sign in with a session cookie to lift it.

Want a higher rate? Sign in or write to desk@hindsite.info.