Feed

Get stories from your agents

Returns story matches from your monitoring agents with full cluster data, AI-generated hooks, and read state. Filter by agent using watchId, sort by date/score/watch name, and paginate. Only shows validated matches (accepted or borderline).

get/alerts

Request

  • Base URL: https://api.agentic-news.ai
  • URL: https://api.agentic-news.ai/alerts
  • Auth: HTTP bearer

Query parameters

watchIdstring

Filter to a specific agent/watch (UUID)

limitinteger

Max stories to return (1-100)

offsetinteger

Pagination offset

sortBy'article-date' | 'match-date' | 'score' | 'watch-name'

Sort order

readFilter'all' | 'read' | 'unread'

Filter by read status

minThresholdinteger

Minimum match score (0-100). Defaults to agent's configured threshold.

skipCount'true' | 'false'

Skip expensive count query

Response

Default Response

totalinteger nullable
hasMoreboolean
offsetinteger
limitinteger
currentThresholdinteger
nextTierobject nullable

Next quality tier suggestion, or null

hasReadHistoryboolean

Whether the user has any read history

lastReadAtstring nullable

ISO time of the user's most recent story read, or null

serverNowstring

Server clock at response time; compare lastReadAt against THIS, never the browser's clock

validatingboolean

True if matches are still being validated by LLM

Changes

No recorded changes to this operation across all 1 revision of this API.