Blog / Product

[05 / 15]

May '265 min read

Feeds API v1: keyset pagination and lookback windows

The historical feeds API is now generally available — cursor-based pagination, plan-scoped lookback, and tag filters that compose.

Jonas Keller Engineering

The v1 feeds API is out of beta. It is the same corpus that powers the live feed — every article, filing, and note, scored by the Verdict Engine — now queryable back through your plan's lookback window.

Keyset pagination, not offsets

Offset pagination falls apart on a table that grows by the second: page two shifts under you while you read page one. The feeds API paginates on a (published_at, id) keyset instead, encoded in an opaque cursor. Pages are stable no matter how fast the feed moves.

Filters that compose

Tag dimensions — topic, market, country, sector — combine with symbols, exchanges, sentiment bounds, and actionability flags. Within a dimension, values OR; across dimensions, they AND. The same semantics as the dashboard, because it is the same query path.