agent

What's happened in a given topic since a given date?

What's happened in a given topic since a given date? Pass a free-text topic + ISO date; receive a deduplicated, ranked list of recent events drawn from US federal regulations, US House + Senate roll-call votes, academic papers (arXiv + PubMed + Semantic Scholar), and federal court opinions. Each event includes title, 1-2 sentence summary, date, source label, source URL, and a 1-5 significance score. Designed so an AI agent can spend one call to catch up on a domain since its LLM training cutoff. LLM-backed source routing and synthesis. Billing: payment settles before this endpoint runs (paid upstream), so an error after settlement IS charged — the error response then carries the payment receipt (PAYMENT-RESPONSE) and X-2s-Charged: true.

post/api/agent/knowledge-delta

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/agent/knowledge-delta
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Request body

topicstring required

Free-text domain. Examples: "oncology immunotherapy", "Rust language ecosystem", "SEC enforcement against crypto exchanges".

sincestring required

Earliest date (YYYY-MM-DD). Typically the agent's LLM training cutoff date.

untilstring

Latest date (YYYY-MM-DD). Default = today.

maxEventsinteger

Max events to return (1-50). Default 20.

Response

(unresolved $ref)

Changes

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