Public API and feeds

Base URL

https://www.signalsmonitor.com/api/public/v1

Every JSON response includes meta.attribution. Keep the SignalsMonitor name and a link to the story or hub page when you display the data. The terms are at /terms.

Stories, topics, and places

• GET /stories?limit=20&offset=0
• GET /topics and GET /topics/:slug
• GET /places and GET /places/:slug

limit is 1 to 50 and defaults to 20. offset starts at 0. meta.hasMore is true when another page exists. Lists are cached for about a minute.

A story record is an id, headline, path on this site, update time, category, place label when we have one, and up to six publisher names. It is not the article.

RSS and Atom

Each topic and place has two feeds. Hub pages advertise them for feed readers.

• GET /topics/:slug/feed.rss and GET /topics/:slug/feed.atom
• GET /places/:slug/feed.rss and GET /places/:slug/feed.atom

Example: /api/public/v1/places/taiwan/feed.rss

Limits

Reads are rate-limited per address. A limited response is HTTP 429 with Retry-After. There is no write method and no API key. Questions go to hello@signalsmonitor.com.