Feeds

Most reads are POSTs because they carry a where predicate in the body.

Operation	What it does
`POST /v1/feeds/query`	Query followed feeds: entries, source health, or aggregates
`POST /v1/feeds/search`	Find public feeds to follow
`POST /v1/feeds/follow`	Follow feeds by URL, with per-URL outcomes
`POST /v1/feeds/inputs/news-query`	Create a durable query/news input
`POST /v1/feeds/feedback`	Set or undo explicit feedback on an entry
`POST /v1/feeds/changes`	What changed since a cursor — the polling primitive
`POST /v1/feeds/mutate`	Selector-based writes with dry-run preview
`POST /v1/feeds/export`	Export a filtered slice as NDJSON

Use query to read what is already there. Use changes to learn what is new since last time. Guides: Follow sources · Retries and idempotency

The first changes call with cursor: "latest" only sets the checkpoint and returns no events. Poll again with the next_cursor it gives you.

Last modified on September 13, 2026

Overview

Account

Articles

Library

Collections

Consumers

Monitors

Feeds