Docs menu
Raw Story API endpoint
Raw Story top stories API
Returns the 30 newest Raw Story stories across all sections. Takes no parameters. Each item has its title, story URL, a lead-paragraph summary capped at 500 characters, publication time, author byline and lead image.
GETapiKey1 credit/requestRaw Storypublicnews.newsResponseDoc
Raw Story/rawstory/newsEndpoint facts
- Method
- GET
- API path
- /rawstory/news
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Raw Story
- Response schema
- #/definitions/publicnews.newsResponseDoc
How this endpoint behaves
Returns the latest public Raw Story stories from the site's public site-wide feed: title, canonical story URL, a short lead-paragraph summary (capped at 500 characters), publication time, author byline, and lead image. The feed carries the 30 newest stories across all sections.
Example response (truncated):
{"code":200,"data":{"items":[{"title":"Expert sounds the alarm as Trump's press ban points to historic danger: 'An outrage'","url":"https://www.rawstory.com/trump-media-ban-2677933730","summary":"President Donald Trump ignoring a judge's block on his media ban signals a significant step towards dictatorship amid a larger attack on U.S. law.","published_at":"2026-09-25T00:08:25Z","author":"Bennito L. Kelty","image_url":"https://www.rawstory.com/media-library/legal-expert-laurence-tribe-sounded-the-alarm-on-president-donald-trump-s-slide-toward-dictatorship-cnn-screenshot.png?id=67852549&width=980"}]}}
Sampled response
- Request, 14 Oct 2026
- GET /rawstory/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 |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/rawstory/news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"items": [
{
"title": "Expert sounds the alarm as Trump's press ban points to historic danger: 'An outrage'",
"url": "https://www.rawstory.com/trump-media-ban-2677933730",
"summary": "President Donald Trump ignoring a judge's block on his media ban signals a significant step towards dictatorship amid a larger attack on U.S. law.",
"published_at": "2026-09-25T00:08:25Z",
"author": "Bennito L. Kelty",
"image_url": "https://www.rawstory.com/media-library/legal-expert-laurence-tribe-sounded-the-alarm-on-president-donald-trump-s-slide-toward-dictatorship-cnn-screenshot.png?id=67852549&width=980"
}
]
}
}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/rawstory/news" \
-H "x-api-key: $CRAWLORA_API_KEY"