Blog / Guide

Media monitoring API: track any topic, country or narrative

GuideJuly 1, 2026· 4 min read

Media monitoring used to mean scrapers, keyword lists and a person watching a screen. A structured news API turns it into a query: pull everything on a topic or country, already scored and classified, and measure how coverage moves.

Coverage, not keywords

Keyword alerts miss synonyms and drown you in noise. Because every article is pre-tagged with topic_tags, country_tags, audience_tags and a 9-category political_lean, monitoring becomes a filter on structured fields instead of a brittle keyword list you have to maintain.

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.newsagentdata.com/v1/feed?topic=energy&country=de&days=7"

Both sides of a story

The point of monitoring is often how something is being covered, not just that it is. Pull one event across state, independent and Western sources and compare the lean distribution — a measurable narrative signal, not a vibe. More in our guide on measuring political bias.

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.newsagentdata.com/v1/feed?topic=sanctions&political_lean=state&days=3"

Spot the spike

Items covering the same event share a cluster_id, and cluster_size tells you how widely a story has spread. A cluster that jumps from 3 to 40 outlets in an hour is a coverage spike — exactly the moment a comms or research team wants to know. Group by cluster to track that automatically.

Russian coverage others can't read

A lot of what breaks first lives on Telegram, which web-only monitoring tools can't ingest. We read thousands of public channels via MTProto alongside RSS, so your monitoring includes sources most vendors miss. See the coverage and Telegram news API guide.

Wire it to alerts

Register a webhook on your topic and country and matching items arrive in ~60s — feed a Slack channel, a Telegram bot or a BI dashboard without a polling loop. Full field list in the docs.

Try it free

Grab a free API key — no card — and query live data in under a minute.

Get a free API key