GET /v1/trends/countries
What is covered, and how stale it might be.
curl "https://freenewsapi.ai/v1/trends/countries?min_trends=500"Why staleness is in the response
computed_minutes_ago is not decoration. Trends are precomputed, so a
country answered instantly may still have been calculated twenty minutes ago. Rather than
hide that, we hand it to you: if the number is larger than you can live with, say so and
we will look.
As of writing, all 120 countries sit inside fifteen minutes, four on average. That is after a specific fix — the incremental pass used to look two hours back on every run, which was sensible at a fifteen-minute interval and wasteful at five, and it pushed the worst country out to forty-four minutes before we caught it.
Parameters
1Skip countries with fewer stories than this. Small countries produce few stories not because we ignore them but because two independent outlets rarely cover the same thing there.
