News monitoring
Use Yahoo News endpoints to turn news monitoring into repeatable API requests with documented inputs and JSON responses.
Turn the www.yahoo.com/news portal into structured JSON — homepage and section story streams, full article content, search autocomplete, and article comments with reactions and replies. Credential-free.
Extract Yahoo News's homepage and section story streams, full article content, autocomplete suggestions, and article comments as structured JSON.
Endpoint families
5
Documented params
19
Examples
6
Live catalog snapshot
Active endpoints
6
Methods
GET
Required params
12
Schema refs
6
{
"platform": "Yahoo News",
"endpoint": "yahoo-news-home",
"method": "GET",
"path": "/yahoo-news/home",
"auth": "apiKey"
}Use cases
Extract Yahoo News's homepage and section story streams, full article content, autocomplete suggestions, and article comments as structured JSON.
Use Yahoo News endpoints to turn news monitoring into repeatable API requests with documented inputs and JSON responses.
Use Yahoo News endpoints to turn content aggregation into repeatable API requests with documented inputs and JSON responses.
Use Yahoo News endpoints to turn comment sentiment tracking into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Yahoo News endpoint catalog — 6 endpoints, 19 documented request parameters, and 6 published response schemas — the same catalog Docs and Playground run against.
6 documented Yahoo News endpoints, grouped into 5 request families — Comments, Article and Category, plus 2 more.
19 request parameters are documented across those Yahoo News endpoints, 12 of them required — the full input contract is public before you write any integration code.
6 of the 6 Yahoo News endpoints ship a recorded example response, and 6 carry a documented response schema — you can code against the real JSON before the first request.
Yahoo News endpoints document their error responses (400, 404, 429, 500 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.
6 hosted MCP tools back the Yahoo News endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/yahoo-news/comments
/yahoo-news/article
/yahoo-news/category
/yahoo-news/home
/yahoo-news/suggest
Endpoint catalog
/yahoo-news/homeReturns Yahoo News's homepage "need to know" story stream: title, destination URL, summary, source, publish time, comment count, and thumbnail images for each story. Sourced from Yahoo News's own server-rendered homepage.
Response notes
- `published_at`, `summary`, `source`, `source_url`, `authors`, `category`, and `thumbnail_url` are omitted when Yahoo did not include them for a given story (this happens most often for `published_at` on syndicated/aggregated cards). - `images` lists every size rendition Yahoo generated for the story's thumbnail, largest listed values first as returned upstream. - A blocked or CAPTCHA-served response returns `503`. Example response: ```json { "code": 200, "msg": "OK", "data": { "items": [ { "id": "560b182d-c809-3b6d-828e-6b3e0ca44b7c", "title": "Sailors report dire conditions aboard USS Lincoln. Democrats want answers.", "url": "https://www.yahoo.com/news/politics/articles/senators-demand-inquiry-conditions-aboard-040819124.html", "summary": "In a letter to Defense Secretary Pete Hegseth Wednesday, Senator Richard Blumenthal called for the Navy to account for conditions aboard the aircraft carrier.", "published_at": "2026-08-13T04:08:19Z", "source": "AFP", "source_url": "https://www.afp.com/", "category": "U.S.", "comment_count": 6878, "thumbnail_url": "https://d29szjachogqwa.cloudfront.net/images/user-uploaded/c1861d18f6d85ba79a1ffe4419699286.jpg", "images": [ { "url": "https://s.yimg.com/lo/mysterio/api/.../smartcrop_w1104_h620.../https%3A%2F%2Fd29szjachogqwa.cloudfront.net%2F...", "width": 1104, "height": 620 } ] } ] } } ```
MCP tool yahoo_news_home
/yahoo-news/categoryReturns a Yahoo News section's story stream: title, destination URL, summary, source, publish time, comment count, and thumbnail images for each story. Sourced from Yahoo News's own server-rendered section pages.
Response notes
- Only the six values above are live Yahoo News sections (confirmed by live request; other guessed slugs such as `health`, `entertainment`, `business`, and `technology` 404 upstream); any other value returns `400`. - `originals` is a curated cross-section collection (its stories can carry any `category`, e.g. "Lifestyle" or "Entertainment" alongside "U.S.") rather than a single-topic section like the other five. - `published_at`, `summary`, `source`, `source_url`, `authors`, and `thumbnail_url` are omitted when Yahoo did not include them for a given story. Category feeds frequently omit `published_at` even when the homepage feed includes it for the same story. - A blocked or CAPTCHA-served response returns `503`. Example response: ```json { "code": 200, "msg": "OK", "data": { "category": "politics", "items": [ { "id": "1bfd4c19-ae78-369c-a4cb-8489000ca9d7", "title": "Hegseth criticized for locking Democrats out of closed-door defense budget talks", "url": "https://www.yahoo.com/news/politics/articles/hegseth-criticized-locking-democrats-closed-150610567.html", "summary": "Republican lawmakers express concern after US defense secretary repeatedly excluded Democrats from briefings", "source": "The Guardian", "source_url": "https://www.theguardian.com/international", "authors": ["Joseph Gedeon in Washington"], "category": "Politics", "comment_count": 0, "thumbnail_url": "https://media.zenfs.com/en/the_guardian_765/b0019faf1c513b027cd3fd20004640f3.jpg" } ] } } ```
MCP tool yahoo_news_category
/yahoo-news/articleReturns a single Yahoo News article's full content: headline, description, author, publish/update time, section, image, keywords, original publisher, and body paragraphs. Accepts a canonical yahoo.com/news article URL, such as one returned by the home or category story streams.
Response notes
- `id` is the article's internal id, usable as `content_id` on `/yahoo-news/comments` to fetch this article's comments. It is omitted when the id could not be extracted (very rare; treat it as best-effort). - `provider`/`provider_url` identify the original publisher (e.g. "The Guardian", "AFP") when the story is syndicated content Yahoo hosts; Yahoo News itself is the provider for original Yahoo News content. - `paragraphs` is the article's body text as a list of plain-text paragraphs, in order. Empty paragraphs are dropped. - A nonexistent article URL returns `404`. A blocked, CAPTCHA-served, or structurally different response (missing both the article metadata and body) returns `503`. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "1bfd4c19-ae78-369c-a4cb-8489000ca9d7", "url": "https://www.yahoo.com/news/politics/articles/hegseth-criticized-locking-democrats-closed-150610567.html", "title": "Hegseth criticized for locking Democrats out of closed-door defense budget talks", "description": "Republican lawmakers express concern after US defense secretary repeatedly excluded Democrats from briefings", "author": "Joseph Gedeon in Washington", "published_at": "2026-08-13T15:06:10Z", "updated_at": "2026-08-13T15:06:10Z", "category": "Politics", "image_url": "https://s.yimg.com/lo/mysterio/api/.../resizefill_w1200.../https%3A%2F%2Fmedia.zenfs.com%2F...", "keywords": ["Pete Hegseth", "the Pentagon", "Democrats", "Capitol Hill"], "provider": "The Guardian", "provider_url": "https://www.theguardian.com/international", "paragraphs": [ "Republican senators have criticized the Pentagon for locking Democrats out of classified briefings on defense spending, warning that Pete Hegseth's approach could jeopardize passage of Donald Trump's record $1.5tn military budget increase.", "The US defense secretary has made at least two trips to Capitol Hill in recent weeks to pitch the budget, but has repeatedly excluded Democrats from the closed-door sessions, according to lawmakers from both parties." ] } } ```
MCP tool yahoo_news_article
/yahoo-news/suggestReturns Yahoo News's own search-box autocomplete suggestions for a partial query: a flat list of suggested news search terms.
Response notes
- A query with no matches returns a genuine empty `suggestions` array, not an error. Example response: ```json { "code": 200, "msg": "OK", "data": { "query": "chatgpt", "suggestions": [ "chatgpt", "chatgpt open ai", "chatgpt free", "chatgpt ai" ], "source_url": "https://search.yahoo.com/sugg/gossip/gossip-us-news_vertical?command=chatgpt&nresults=10&output=sd1", "fetched_at": "2026-08-14T00:00:00Z" } } ```
MCP tool yahoo_news_suggest
/yahoo-news/commentsReturns a page of an article's top-level comments: author, body, reaction counts, reply count, and pin status, with sort order and cursor-based pagination. Sourced from Yahoo's own comment platform gateway.
Response notes
- `comments_count` is the article's total comment count, independent of `count`/pagination. - `has_next_page`/`next_cursor` drive pagination: pass `next_cursor` back as `cursor` to fetch the next page. `next_cursor` is omitted once `has_next_page` is `false`. - A `content_id` with no comments, or one that does not correspond to a real article, both return a successful empty page (`comments_count: 0`, `items: []`) rather than an error — this matches Yahoo's own upstream behavior, which does not distinguish the two cases. - `content_id` must look like a Yahoo News article id (a UUID); a malformed value returns `400` before any upstream request is made. Example response: ```json { "code": 200, "msg": "OK", "data": { "content_id": "70253ef0-7509-31ec-aabf-d8e369db3f73", "sort": "top", "comments_count": 365, "items": [ { "id": "eb4886ed-3ccc-4709-878f-70e239ca1e9c", "body": "Well let's see, that's \"interesting\".", "created_at": "2026-08-13T16:24:56.096Z", "pinned": false, "author": { "nickname": "Chuck", "handle": "chuck23117", "avatar_url": "https://s.yimg.com/ag/images/default_user_profile_pic_64sq.jpg", "has_default_avatar": true, "total_comment_count": 3931, "total_reaction_count": 14055 }, "reply_count": 11, "reactions": { "thumbs_up": 135, "thumbs_down": 8, "heart": 13, "laugh": 1, "clap": 4, "sad": 0, "total": 161 } } ], "has_next_page": true, "next_cursor": "eyJ0aW1lc3RhbXBNaWNyb3MiOjE3ODY2Mzg3NTUzODk0MjQsImlkIjoiMGI1YjhlYzAtNzk2Ny00OGI0LTg2ZDktZmRlYWVhYmQ4MTMyIiwiaW5zdGFudCI6IjIwMjYtMDgtMTNUMTY6MzI6MzUuMzg5NDI0WiJ9" } } ```
MCP tool yahoo_news_comments
/yahoo-news/comments/repliesReturns a page of a comment's replies: author, body, reaction counts, and pin status, with sort order and cursor-based pagination. Sourced from Yahoo's own comment platform gateway.
Response notes
- `total_count` is the comment's total reply count, independent of `count`/pagination. - `has_next_page`/`next_cursor` drive pagination the same way as `/yahoo-news/comments`. - A `comment_id` with no replies, or one that does not belong to `content_id`, returns a successful empty page (`total_count: 0`, `items: []`) rather than an error, matching Yahoo's own upstream behavior. - Replies do not carry a `pinned` flag (pinning is a top-level-comment-only feature); it is always `false` here. Example response: ```json { "code": 200, "msg": "OK", "data": { "content_id": "afd0da86-88c7-320f-a3c9-d1dcad7920c7", "comment_id": "f1168670-2356-4bcf-bfb9-240b8e4964b1", "sort": "newest", "total_count": 195, "items": [ { "id": "30f70e55-dd1c-4c38-802b-c4c87bef7799", "body": "He doesn't know how to do good for others.", "created_at": "2026-08-13T21:35:25.269Z", "pinned": false, "author": { "nickname": "Kelly", "handle": "kelly122116", "avatar_url": "https://s.yimg.com/ag/images/4556/23905210787_399a3c_64sq.jpg", "has_default_avatar": false, "total_comment_count": 1230, "total_reaction_count": 1999 }, "reply_count": 0, "reactions": { "thumbs_up": 1, "thumbs_down": 0, "heart": 0, "laugh": 0, "clap": 0, "sad": 0, "total": 1 } } ], "has_next_page": true, "next_cursor": "eyJ0aW1lc3RhbXBNaWNyb3MiOjE3ODY2NTY4NjMxMTY1OTIsImlkIjoiMDVhZjgzOTMtZjYzOS00ZTdmLWE0ZjEtNzI5M2YyMDVkOGZlIiwiaW5zdGFudCI6IjIwMjYtMDgtMTNUMjE6MzQ6MjMuMTE2NTkyWiJ9" } } ```
MCP tool yahoo_news_comment_replies
Related APIs
Media & Streaming
Research streaming catalogs, title availability, providers, offers, seasons, episodes, and release changes from JustWatch with normalized JSON.
Media & Streaming
Turn Apple Books ebook and audiobook pages into structured data — search, catalog detail, paginated customer reviews, similar titles, author bibliographies, series listings, and chart rankings as normalized JSON. Credential-free.
Media & Streaming
Search public Ticketmaster events and browse the full discovery hierarchy by category or city, with pagination plus event, attraction, and venue detail endpoints -- including fan reviews, related attractions, trending attractions, and enhanced venue branding -- for live-entertainment research.
How to scrape Yahoo News
Yahoo News has no public developer API, but its homepage, section pages, and articles are credential-free public pages. Crawlora's 6 Yahoo News endpoints return the homepage and section story streams, full article content, search suggestions, and article comments (with replies) as normalized JSON.
The homepage endpoint returns the "need to know" story stream; the category endpoint returns a section's stream (us, world, politics, science, weather-news, or the cross-vertical originals collection) — each story includes its title, destination URL, summary, source, publish time, comment count, and thumbnail images.
Pass a story's URL from either stream to the article endpoint to get its headline, description, author, publish/update time, section, image, keywords, original publisher, and full body paragraphs.
Pass an article's content id to the comments endpoint for a page of top-level comments (author, body, reaction counts, reply count, pin status), and comments/replies to expand any one comment's replies.
Send a partial query to /yahoo-news/suggest to get Yahoo News's own search-box suggestions.
FAQ
No. Yahoo News has no public developer API. Crawlora's endpoints read Yahoo News's own server-rendered pages and comment platform gateway, returning normalized JSON.
Pass the article's URL (returned by the home or category endpoints as each story's url field) to /yahoo-news/article.
us, world, politics, science, weather-news, and originals — a curated cross-section collection spanning multiple topics — the category endpoint's category parameter accepts exactly those six values.
Yes — /yahoo-news/comments returns a page of an article's top-level comments with reactions, and /yahoo-news/comments/replies expands any comment's replies, both with cursor-based pagination.