Docs menu
Townhall API endpoint
Townhall top stories API
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.
GETapiKey1 credit/requestTownhallpublicnews.newsResponseDoc
Townhall/townhall/newsEndpoint facts
- Method
- GET
- API path
- /townhall/news
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Townhall
- Response schema
- #/definitions/publicnews.newsResponseDoc
How this endpoint behaves
Returns the latest public Townhall stories from the site's public site-wide feed: title, canonical article URL, a short summary, publication time, author byline, and lead image. The feed mixes news stories and opinion columns, newest first (about 50 items). Items that are not news or column stories (for example video pages) are dropped.
Example response (truncated):
{"code":200,"data":{"items":[{"title":"A Second Man Was Arrested in Mississippi Hanging Case. Guess What the AP Didn't Tell Us.","url":"https://townhall.com/news/amy-curtis/2026/09/24/second-man-arrested-in-mississippi-hanging-ap-ignores-race-n2683524","summary":"The Associated Press should be ashamed. Just two days ago, they were the recipients of a Community Note after their X post conveniently omitted some important facts about the murder of Tasia Fortune.","published_at":"2026-09-24T22:00:53Z","author":"Amy Curtis","image_url":"https://media.townhall.com/cdn/hodl/2026/161/9eb18b91-0a9e-4d95-9083-0b888275e26a.png"}]}}
Sampled response
- Request, 14 Oct 2026
- GET /townhall/news
- Items in items
- 50
- Fields filled in every checked item
- 6
| Field | Filled in, of 50 checked | Values in the sample |
|---|---|---|
| title | 50 | median 73 characters |
| url | 50 | townhall.com |
| summary | 50 | median 297 characters |
| published_at | 50 | 2026-10-11 to 2026-10-13 |
| author | 50 | |
| image_url | 50 | media.townhall.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/townhall/news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"items": [
{
"title": "A Second Man Was Arrested in Mississippi Hanging Case. Guess What the AP Didn't Tell Us.",
"url": "https://townhall.com/news/amy-curtis/2026/09/24/second-man-arrested-in-mississippi-hanging-ap-ignores-race-n2683524",
"summary": "The Associated Press should be ashamed. Just two days ago, they were the recipients of a Community Note after their X post conveniently omitted some important facts about the murder of Tasia Fortune.",
"published_at": "2026-09-24T22:00:53Z",
"author": "Amy Curtis",
"image_url": "https://media.townhall.com/cdn/hodl/2026/161/9eb18b91-0a9e-4d95-9083-0b888275e26a.png"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.newsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.NewsResponse | No | ||||
| data.items | array | No | ||||
| data.items[].author | string | No | ||||
| data.items[].image_url | string | No | ||||
| data.items[].published_at | string | No | ||||
| data.items[].summary | string | No | ||||
| data.items[].title | string | No | ||||
| data.items[].type | string | No | ||||
| data.items[].url | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/townhall/news" \
-H "x-api-key: $CRAWLORA_API_KEY"