29 lines
1.3 KiB
Markdown
29 lines
1.3 KiB
Markdown
---
|
|
name: the-news
|
|
description: Gives agents real-time and archival access to front-page headlines across 20 countries for breaking news, current events, and comparative media analysis.
|
|
---
|
|
|
|
This skill gives agents access to the main headlines of many newspapers and news sites, across 20 countries, via a public API.
|
|
The API has two modes: a live mode, updated in near real-time, and an archive mode that lets you fetch the headlines from a given moment in time.
|
|
|
|
## Endpoint
|
|
`GET https://www.thehear.org/api/country-view/[country]`
|
|
|
|
Supported countries: us, uk, germany, france, italy, spain, portugal, netherlands, belgium, switzerland, austria, turkey, israel, india, japan, south-korea, china, brazil, mexico, argentina
|
|
|
|
## Calls
|
|
Snapshot of current headlines:
|
|
`https://www.thehear.org/api/country-view/[country]`
|
|
|
|
Historical snapshot at a UTC timestamp:
|
|
`https://www.thehear.org/api/country-view/[country]?at=2026-05-01T20:00:00Z`
|
|
|
|
Daily overview range:
|
|
`https://www.thehear.org/api/country-view/[country]?call=daily-overviews&from=YYYY-MM-DD&to=YYYY-MM-DD`
|
|
|
|
## Reading Guidance
|
|
- Be mindful of different biases and orientations of various sources
|
|
- The API gives headlines, subtitles, and links to full articles
|
|
- Treat this as a multi-source snapshot, not as final verification
|
|
- AI overviews help contextualize but headlines are the source of truth
|