GET/townhall/articleapiKey2 credits/request
Returns public Townhall article metadata and body paragraphs from a canonical news or column URL. VIP stories are flagged with paywalled and return only the free lead paragraphs.
Required: url.
Sampled 14 Oct 2026: 9 fields returned with a value. In the sample: published_at: 2026-09-24; section: “Columns”; url: townhall.com; title: 40 characters; authors: 1 entry; description: 86 characters; updated_at: 2026-09-24; image_url: media.townhall.com.
Open in Playground
GET/townhall/authorapiKey2 credits/request
Returns a Townhall author profile by `slug` (such as `amy-curtis`) or by an author `url`; exactly one is required. The response has the name, photo, bio, X profile link and the first page of the author's archive, about 50 stories, each with its section label and a `vip` flag. Unknown authors return a not-found error.
Optional: slug, url.
Sampled 14 Oct 2026: 50 items. Filled in every item: title, url, section, published_at, image_url. Not in every item: vip (8). In the sample: published_at: 2026-10-09 to 2026-10-13; url: townhall.com; vip: true in 8 of 8; title: median 81 characters; image_url: media.townhall.com.
Open in Playground
GET/townhall/headlinesapiKey1 credit/request
Lists headlines for one Townhall section. `section` is required: `news` and `columnists` return the 20 most recent stories, while the topic sections (such as `congress`, `economy` or `iran`) return up to 30 stories mixing news and columns. Items carry title, URL, image and, when available, author, time and summary.
Required: section (10 allowed values: news, columnists, 2026-elections, congress, donald-trump, economy, foreign-policy, illegal-immigration, iran, supreme-court).
Sampled 14 Oct 2026: 20 items. Filled in every item: title, url, summary, published_at, author, image_url. In the sample: published_at: 2026-10-13; url: townhall.com; title: median 72 characters; summary: median 299 characters; image_url: media.townhall.com.
Open in Playground
GET/townhall/newsapiKey1 credit/request
Returns the latest Townhall stories, news and opinion columns mixed, newest first, about 50 items. Each has its title, URL, short summary, publication time, author byline and lead image. Video pages are left out. Takes no parameters.
Takes no parameters.
Sampled 14 Oct 2026: 50 items. Filled in every item: title, url, summary, published_at, author, image_url. In the sample: published_at: 2026-10-11 to 2026-10-13; url: townhall.com; title: median 73 characters; summary: median 297 characters; image_url: media.townhall.com.
Open in Playground
GET/townhall/sectionsapiKey1 credit/request
Returns the public Townhall section inventory: the site-wide news and column feeds plus the editorial topic hubs the site promotes.
Takes no parameters.
Sampled 14 Oct 2026: 10 items. Filled in every item: slug, name, url. In the sample: name: “News” and 9 other values; url: townhall.com.
Open in Playground
Townhall API endpoints