Docs menu
Raw Story API endpoint
Raw Story sections API
Lists the 15 section and topic hubs that `rawstory-headlines` accepts. Each entry has a `slug`, a display `name` such as `U.S. News` or `Raw Exclusives`, and the hub page `url`. Hubs overlap: `us-news`, `trump-news` and `smartnews` share most recent stories, and `presidential-campaign-issues` is dormant.
GETapiKey1 credit/requestRaw Storypublicnews.sectionsResponseDoc
Raw Story/rawstory/sectionsEndpoint facts
- Method
- GET
- API path
- /rawstory/sections
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Raw Story
- Response schema
- #/definitions/publicnews.sectionsResponseDoc
How this endpoint behaves
Returns the complete public section and topic hub inventory accepted by /api/v1/rawstory/headlines: all 15 hubs that rawstory.com publishes with a live feed (verified live 2026-09-25 by fetching every hub linked from the site's navigation and home page and its feed): 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.
Each section includes a stable slug (the last segment of the hub URL), a display name (U.S. News, Trump News, World, Science, Video, Raw Exclusives, Also Read, Opinion, Media, 2026 Midterm Elections, We Have Issues, SmartNews, Super Head, JD Vance, Supreme Court), and the public hub page url. Raw Story publishes no formal taxonomy, so hubs overlap: us-news, trump-news and smartnews share most recent stories, and also-read is a child of raw-investigates. Hubs whose feed is identical to a listed one are not offered separately (frontpage-commentary duplicates commentary, video duplicates all-video). presidential-campaign-issues is dormant and returns 2019 and 2020 stories.
Sampled response
- Request, 14 Oct 2026
- GET /rawstory/sections
- Items in sections
- 15
- Fields filled in every checked item
- 3
| Field | Filled in, of 15 checked | Values in the sample |
|---|---|---|
| slug | 15 | |
| name | 15 | “U.S. News” and 14 other values |
| url | 15 | 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/sections" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"sections": [
{
"slug": "us-news",
"name": "U.S. News",
"url": "https://www.rawstory.com/us-news/"
},
{
"slug": "world",
"name": "World",
"url": "https://www.rawstory.com/world/"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.sectionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.SectionsResponse | No | ||||
| data.sections | array | No | ||||
| data.sections[].name | string | No | ||||
| data.sections[].slug | string | No | ||||
| data.sections[].url | string | No |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/rawstory/sections" \
-H "x-api-key: $CRAWLORA_API_KEY"