US political narrative research
Use Raw Story endpoints to turn us political narrative research into repeatable API requests with documented inputs and JSON responses.
Track Raw Story’s political and commentary feeds without flattening their editorial roles.
Extract US political reporting, investigations, media criticism and progressive opinion from Raw Story as structured JSON.
Endpoint families
5
Documented params
9
Examples
5
Live catalog snapshot
Active endpoints
5
Methods
GET
Required params
7
Schema refs
5
{
"platform": "Raw Story",
"endpoint": "rawstory-news",
"method": "GET",
"path": "/rawstory/news",
"auth": "apiKey"
}Use cases
Extract US political reporting, investigations, media criticism and progressive opinion from Raw Story as structured JSON.
Use Raw Story endpoints to turn us political narrative research into repeatable API requests with documented inputs and JSON responses.
Use Raw Story endpoints to turn media coverage monitoring into repeatable API requests with documented inputs and JSON responses.
Use Raw Story endpoints to turn opinion and reporting comparison into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Raw Story endpoint catalog — 5 endpoints, 9 documented request parameters, and 5 published response schemas — the same catalog Docs and Playground run against.
5 documented Raw Story endpoints, grouped into 5 request families — Article, Author and Headlines, plus 2 more.
9 request parameters are documented across those Raw Story endpoints, 7 of them required — the full input contract is public before you write any integration code.
5 of the 5 Raw Story endpoints ship a recorded example response, and 5 carry a documented response schema — you can code against the real JSON before the first request.
Raw Story endpoints document their error responses (400, 404 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
5 hosted MCP tools back the Raw Story endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/rawstory/article
/rawstory/author
/rawstory/headlines
/rawstory/news
/rawstory/sections
Endpoint catalog
/rawstory/articleReturns 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.
MCP tool rawstory_article
/rawstory/authorReturns a Raw Story author's profile, looked up by `slug` (for example `bennitokelty`) or canonical `url`; exactly one is required. The response has the name, `bio`, avatar, social links and the 15 most recent stories, each with title, URL and a `YYYY-MM-DD` date. Older stories are not reachable, and an unknown author returns not-found.
MCP tool rawstory_author
/rawstory/headlinesReturns 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.
MCP tool rawstory_headlines
/rawstory/newsReturns 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.
MCP tool rawstory_news
/rawstory/sectionsLists 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.
MCP tool rawstory_sections
Related APIs
Media & Streaming
Follow German football from the Bundesliga down to the lowest Kreisklasse. Discover competitions in all 22 federations, then read matchdays, standings, scorers, clubs, teams, and players from the DFB's own amateur-football portal.
Media & Streaming
Browse Sportskeeda's sports and entertainment coverage, community wikis, quizzes, and fan games with the catalog's current slugs and filter limits.
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
How to scrape Raw Story
Raw Story is a US progressive digital news and commentary outlet. Its Investigates hub and election coverage are distinct editorial lanes from media criticism and opinion; preserve the original hub before comparing a report with a commentary item. Several topic hubs can overlap in the same stories, so join feed results by canonical URL and do not count a cross-listed story as separate coverage. Use the live sections response as the supported inventory rather than treating every website topic page as an independent API feed; author profiles' recent-work lists are not a historical archive.
Call /rawstory/sections to discover supported section and topic feeds, then request the selected one with /rawstory/headlines. Keep the hub label when examining a media critique versus a political news item.
/rawstory/news reads the public RSS feed. Join each item to section results by canonical URL, and distinguish repeated promotion from newly published material.
Use /rawstory/article for public body paragraphs and metadata. /rawstory/author supplies biography, avatar, public links and the most recent stories listed on a profile; its bounded recent list is not a complete archive.
FAQ
Yes. The sections endpoint lists hubs with live feeds, and the headlines endpoint takes a supported choice. Store that hub identity rather than relying only on keyword matching.
Label it as commentary when the article and hub indicate that form, then compare it with like material. A media opinion piece should not be silently counted as a straight news report.