Developer Docs

Content 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.

Read Newspapers

Base URL

https://www.countryherald.com/api/syndication

All endpoints return JSON. CORS-enabled — safe to call directly from browser-based apps.

Endpoints

GET /latest— Latest articles across all categories

Parameters:

limit (optional) — Number of articles. Default 20, max 50.
category (optional) — Filter by category (e.g. Weather, Crime & Safety, Politics).

curl "https://www.countryherald.com/api/syndication/latest?limit=10"

GET /category/:category— Articles from a specific category

Parameters:

limit (optional) — Default 20, max 50.

Categories: News, Local News, Weather, Crime & Safety, Traffic, Business, Politics, Community, Sports, Science, Space, Breaking News, and more.

Read Daily News

curl "https://www.countryherald.com/api/syndication/category/weather?limit=10"

GET /search?q=...— Keyword search over article titles and summaries

Parameters:

q (required) — Search query.
limit (optional) — Default 20, max 50.

curl "https://www.countryherald.com/api/syndication/search?q=weather&limit=10"

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.

{ "count": 1, "items": [ "id": "abc123", "title": "Indiana Nuclear Oversight Shift Puts 213 Licenses in State Hands", "summary": "Indianapolis, IN — Indiana is about to assume direct regulatory authority over 213 federal nuclear materials licenses currently overseen by the U.S. Nuclear Regulatory Commission...", "hero_image": "https://media.base44.com/images/public/.../example.jpg", "published_at": "2026-09-24T19:34:17.023Z", "category": "Science", "location": { "city": "Indianapolis", "state_abbr": "IN" }, "source_url": "https://www.countryherald.com/article/indiana-nuclear-oversight-shift-puts-213-licenses-in-state-hands", "read_more": "https://www.countryherald.com/article/indiana-nuclear-oversight-shift-puts-213-licenses-in-state-hands", "attribution": { "name": "Country Herald", "url": "https://www.countryherald.com", "logo": "https://media.base44.com/images/public/6a932ceec135e260e92a33db/87731c6bf_chprimelogo1.png" } } ], "attribution": { "name": "Country Herald", "url": "https://www.countryherald.com", "logo": "https://media.base44.com/images/public/6a932ceec135e260e92a33db/87731c6bf_chprimelogo1.png" }, "documentation": "https://www.countryherald.com/api-docs" }

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.