Docs menu
Raw Story API endpoint
Raw Story section headlines API
Returns the latest Raw Story stories, up to 30, for one section hub. `section` is required and takes one of 15 slugs such as `us-news`, `trump-news`, `world`, `commentary` or `supreme-court`. Each item has its title, URL, lead-paragraph summary, publication time, author and image when given. The dormant `presidential-campaign-issues` hub returns 9 stories.
GETapiKey1 credit/requestRaw Storypublicnews.headlinesResponseDoc
Raw Story/rawstory/headlinesEndpoint facts
- Method
- GET
- API path
- /rawstory/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Raw Story
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of us-news, trump-news, world, enviro-science, all-video, raw-investigates, also-read, commentary, blogs-media, 2026-midterm-elections-section, presidential-campaign-issues, smartnews, super-head, jd-vance, supreme-court. Any other value returns an invalid-params error; use /api/v1/rawstory/sections for names and URLs.
Headlines come from the hub's public feed (the 30 most recent stories; 9 for the dormant presidential-campaign-issues) and carry a title, canonical story URL, lead-paragraph summary, publication time, author byline, and image when the feed provides them. Links in a feed that are not stories are dropped.
Example response (truncated):
{"code":200,"data":{"section":"us-news","items":[{"title":"Trump mourns 'patriot' who died after being shot at Butler rally: 'Tremendous loss!'","url":"https://www.rawstory.com/trump-butler-rally-2677933808","published_at":"2026-09-24T19:47:07Z","author":"Matthew Chapman"}]}}
Sampled response
- Request, 14 Oct 2026
- GET /rawstory/headlines?section=us-news
- Items in items
- 30
- Fields filled in every checked item
- 6
| Field | Filled in, of 30 checked | Values in the sample |
|---|---|---|
| title | 30 | median 80 characters |
| url | 30 | rawstory.com |
| summary | 30 | median 181 characters |
| published_at | 30 | 2026-10-13 |
| author | 30 | |
| image_url | 30 | rawstory.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | Raw Story section slug Allowed values: us-news, trump-news, world, enviro-science, all-video, raw-investigates, also-read, commentary, blogs-media, 2026-midterm-elections-section, presidential-campaign-issues, smartnews, super-head, jd-vance, supreme-court. | us-news | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/rawstory/headlines?section=us-news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"section": "us-news",
"items": [
{
"title": "Trump mourns 'patriot' who died after being shot at Butler rally: 'Tremendous loss!'",
"url": "https://www.rawstory.com/trump-butler-rally-2677933808",
"published_at": "2026-09-24T19:47:07Z",
"author": "Matthew Chapman"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.HeadlinesResponse | No | ||||
| data.items | array | No | HeadlineItem record, 7 fields: author, image_url, published_at, summary, title, type, url. Described under Raw Story top stories API. | |||
| data.section | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 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/rawstory/headlines?section=us-news" \
-H "x-api-key: $CRAWLORA_API_KEY"