Developer DocsContent Syndication API
Surface Country Herald articles in your app, widget, or site. Teaser-first — summary, image, and link only. Always drives readers back to countryherald.com.
Base URL
All endpoints return JSON. CORS-enabled — safe to call directly from browser-based apps.
Endpoints
GET /latest— Latest articles across all categoriesParameters:
limit(optional) — Number of articles. Default 20, max 50.category(optional) — Filter by category (e.g. Weather, Crime & Safety, Politics).
GET /category/:category— Articles from a specific categoryParameters:
limit(optional) — Default 20, max 50.
Categories: News, Local News, Weather, Crime & Safety, Traffic, Business, Politics, Community, Sports, Science, Space, Breaking News, and more.
GET /search?q=...— Keyword search over article titles and summariesParameters:
q(required) — Search query.limit(optional) — Default 20, max 50.
Response Schema
Each response is a JSON envelope with a count, an items array, and an attribution object. Every item includes a source_url and read_more field pointing to the full article on countryherald.com.
| Field | Type | Description |
|---|---|---|
| id | string | Unique article ID |
| title | string | Article headline |
| summary | string | Dek or first ~250 chars — never the full body |
| hero_image | string|null | Public CDN image URL |
| published_at | string | ISO 8601 timestamp |
| category | string | Article category |
| location | object|null | City, state, county, region tags |
| source_url | string | Full canonical URL on countryherald.com |
| read_more | string | Same as source_url — link readers here |
| attribution | object | Name, URL, and logo — include in your display |
Attribution Guidelines
Link back required
Every article displayed via this API must include a clickable link to the source_url / read_more field, directing readers to the full story on countryherald.com.
Credit required
Display the Country Herald name and logo (from the attribution object) alongside any surfaced content.
No full-text republication
This API returns summaries only (≤250 characters). Full article body text is never included. Republishing full Country Herald articles requires a separate licensing agreement. Contact us for syndication partnerships.
Rate Limiting
60 requests per minute per IP address. Responses include standard Cache-Control headers (max-age=60, s-maxage=300) for CDN caching. Exceeding the rate limit returns HTTP 429.
RSS Feeds (Platform Ingestion)
For full-text platform ingestion (NewsBreak, SmartNews, RSS readers), use our RSS feeds instead:
- • https://www.countryherald.com/feed — Master RSS
- • https://www.countryherald.com/smartnews.xml — SmartNews
- • https://www.countryherald.com/feed/weather — Weather RSS
The API on this page is the teaser-first channel for partner integrations. The two serve different goals.
© 2026 Country Herald. Questions? news@country.ink