API

The feed is served by the same response the page itself reads. No key, read only.

Addresshttps://pulse.arevian.studio

GET/api/news

Stories for the chosen window. Exactly what the front page shows.

Parameters

Name	Values	What it does
`window`	30m · 3h · 24h · 7d · 30d	How far back to count. Defaults to 24h.
`topic`	tech, ai, science, design, business, politics, incidents, society, culture, sport, studio	Topics, comma separated. Omit for all of them.
`lang`	ru · en · hy	Language of the sources, also comma separated.
`geo`	armenia · russia · world	Where the event is — an axis independent of the topic.
`media`	rss · telegram	Where the story came from: a publisher feed or a Telegram channel.
`from, to`	ISO-8601	Your own span instead of a window.
`limit, offset`	number	Page of results. limit is capped at 50.

GET/api/news/search

Search across stories. Fewer than two characters returns an empty answer, not an error.

Name	Values	What it does
`q`	string	The query. Anything past 80 characters is cut.

curl "https://pulse.arevian.studio/api/news?window=24h&topic=tech,ai&lang=en&limit=10"

items — the stories: headline, summary, topics, time of first publication, how many independent sources, and the score.
has_more — whether another page exists for the same filters.
degraded: true — «we could not count», not «nothing was found». An empty list next to this flag is not a reason to clear what you already show.

The answer is cached for a minute — the worker recalculates the feed every five minutes anyway.
No key is needed, but there is a per-address limit: the feed serves every reader, not one client.
The texts belong to the outlets. The response carries a link to the source, and that is where the reader should go.