The Hear API

Agentic Skill

While humans can use it programmatically, the API was developed with AI agents in mind. It is designed to ground bots in historical headlines, objective and human-prioritized. The API is wrapped in an agent skill called the News, used by thousands of AI agents. Install it with:

npx skills add https://github.com/sfkislev/the-news --skill the-news

or via openclaw:

openclaw skills install the-news

Or learn more at the News on skills.sh or the News on clawhub.

Endpoint

GET https://www.thehear.org/api/country-view/[country]

Live snapshot — current main headlines:

https://www.thehear.org/api/country-view/germany

Historical snapshot — main headlines as of a UTC timestamp:

https://www.thehear.org/api/country-view/germany?at=2026-05-01T20:00:00Z

Daily overviews — AI overviews across a date range (max 7 days):

https://www.thehear.org/api/country-view/germany?call=daily-overviews&from=2026-04-29&to=2026-05-01

• at must be a UTC timestamp.
• from and to use YYYY-MM-DD.
• daily-overviews is limited to 7 days per call.

Response

Each response contains headlines (one entry per source) and overviews (three AI-generated snapshots: current, previous, and yesterday). The raw headlines are the source of truth; overviews are an interpretive layer generated by a language model with access to current and prior headlines.

{
  "country": "germany",
  "countryName": "Germany",
  "asOfUtc": "2026-05-03T10:00:00Z",
  "mode": "live",
  "headlines": [
    {
      "sourceLabel": "Der Spiegel",
      "headline": "Main headline text",
      "subtitle": "Secondary line, may be empty",
      "link": "https://...",
      "capturedAt": "2026-05-03T09:55:00Z"
    }
  ],
  "overviews": {
    "current":   { "type": "ai_overview", "headline": "...", "summary": "...", "period": "current" },
    "previous":  { "...": "same structure, prior snapshot" },
    "yesterday": { "...": "same structure, previous day" }
  }
}

Available Countries

Twenty countries are supported. Source counts and earliest archive dates are listed below.