Docs menu
Raw Story API endpoint
Raw Story article API
Returns a Raw Story article by canonical `url` on `rawstory.com`, for example `https://www.rawstory.com/trump-media-ban-2677933730/`: title, description, publication and update times, section, authors, image and body `paragraphs` (embedded videos excluded). `section` is omitted for slug-only URLs. Hub, tag and author URLs return an invalid-params error; a missing story returns not-found.
GETapiKey2 credits/requestRaw Storypublicnews.articleResponseDoc
Raw Story/rawstory/articleEndpoint facts
- Method
- GET
- API path
- /rawstory/article
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- Raw Story
- Response schema
- #/definitions/publicnews.articleResponseDoc
How this endpoint behaves
Query parameter: url is a canonical HTTPS Raw Story story URL on rawstory.com or www.rawstory.com, e.g. https://www.rawstory.com/trump-media-ban-2677933730/. Stories live at /<slug>/, /<channel>/<slug>/ (for example /raw-investigates/<slug>/) or, for the archive, /<yyyy>/<mm>/<slug>/. Section and topic hubs, tag pages, author profiles (/u/<slug>), static pages, feed paths, and other hosts return an invalid-params error.
The endpoint returns public metadata (title, description, published_at, updated_at, section, authors, image_url) and the body paragraphs (paragraphs, subheadings and list items; embedded videos and their captions are not included). section is the name of the hub a story is nested under in its URL (Raw Exclusives for /raw-investigates/...) and is omitted for slug-only URLs because the page does not state a section. A story URL that does not exist returns a not-found error.
Paywall behavior: Raw Story sells an ad-free membership but live checks on 2026-09-25 (home feed stories, opinion, investigations, a 2020 archive story) found no gated stories: the full body is in the response an anonymous request receives, no page is marked as restricted, and paywalled is therefore never set. The endpoint returns exactly the paragraphs Raw Story's server sends and never tries to bypass a gate; no gated example URL was found.
Example response (truncated):
{"code":200,"data":{"url":"https://www.rawstory.com/trump-media-ban-2677933730","title":"Expert sounds the alarm as Trump's press ban points to historic danger: 'An outrage'","description":"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","updated_at":"2026-09-25T00:08:50Z","authors":["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=1200","paragraphs":["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.","On Thursday, legal expert Laurence Tribe, a constitutional law professor emeritus at Harvard, warned of Trump's larger attack on the law amid his insistence on banning CNN, MS NOW and Politico from the White House."]}}
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| url | string | Yes | Canonical Raw Story article URL | https://www.rawstory.com/trump-media-ban-2677933730/ | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/rawstory/article?url=https%3A%2F%2Fwww.rawstory.com%2Ftrump-media-ban-2677933730%2F" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"url": "https://www.rawstory.com/trump-media-ban-2677933730",
"title": "Expert sounds the alarm as Trump's press ban points to historic danger: 'An outrage'",
"description": "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",
"updated_at": "2026-09-25T00:08:50Z",
"authors": [
"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=1200",
"paragraphs": [
"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.",
"On Thursday, legal expert Laurence Tribe, a constitutional law professor emeritus at Harvard, warned of Trump's larger attack on the law amid his insistence on banning CNN, MS NOW and Politico from the White House."
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.articleResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.ArticleResponse | No | ||||
| data.authors | array | No | ||||
| data.description | string | No | ||||
| data.image_url | string | No | ||||
| data.paragraphs | array | No | ||||
| data.paywalled | boolean | No | Paywalled is true when the publisher serves only a teaser of this article to anonymous readers, so Paragraphs is a partial body rather than the full text. It is omitted when the full public body was returned. | |||
| data.published_at | string | No | ||||
| data.section | string | No | ||||
| data.title | string | No | ||||
| data.updated_at | string | No | ||||
| data.url | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/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/article?url=https%3A%2F%2Fwww.rawstory.com%2Ftrump-media-ban-2677933730%2F" \
-H "x-api-key: $CRAWLORA_API_KEY"