# Yahoo API: Read article > Reads a public Yahoo News article from its link or headline and returns its text and details. Headline matching uses Yahoo News search results. Unofficial. Not affiliated with or endorsed by Yahoo. - Page: https://fous.com/methods/yahoo.com/read-article - Method: `yahoo.com/read_article`, version 1 - Website: yahoo.com - Returns: headline, summary, authors, dates, section, tags, main image, paragraphs, word count, link, id - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `article` | string | yes | `"https://www.yahoo.com/news/world/articles/two-dead-26-injured-coach-074835373.html"` | Yahoo News article link or headline, such as Two dead, 26 injured after coach overturns in southern Germany. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "article": "https://www.yahoo.com/news/world/articles/two-dead-26-injured-coach-074835373.html" } ``` Its output: ```json { "tags": [ "southern German", "police spokeswoman", "coach" ], "authors": [ "DPA" ], "section": "World", "summary": "Two people were killed and around 25 others slightly injured after a coach overturned on the A96 motorway in southern Germany on Sunday, police told dpa. A police spokeswoman said one more person was ...", "headline": "Two dead, 26 injured after coach overturns in southern Germany", "article_id": "9896c0e0-2b00-3f55-a7a0-4b6e8ca0635d", "paragraphs": [ "Two people were killed and around 25 others slightly injured after a coach overturned on the A96 motorway in southern Germany on Sunday, police told dpa.", "A police spokeswoman said one more person was critically injured and in life-threatening condition. The number of injured could rise further.", "The accident occurred in the early morning at just before 6 am (0400 GMT) on the A96 motorway near the town of Buchloe in the eastern Allgäu district of Bavaria. It happened between the junctions to the east of Buchloe and to the west of Landsberg am Lech." ], "updated_at": "2026-09-27T07:48:35+00:00", "word_count": 276, "article_link": "https://www.yahoo.com/news/world/articles/two-dead-26-injured-coach-074835373.html", "published_at": "2026-09-27T07:48:35+00:00", "main_image_link": "https://s.yimg.com/lo/mysterio/api/ee8f294c347bea8620614753cb9cf181dd3058dc59e4cd170bae97ca44603c8b/lightyear_networkapi/resizefill_w1200%3Bquality_80%3Bformat_webp/https%3A%2F%2Fmedia.zenfs.com%2Fen%2Fdpa_international_526%2Fb52734f62e88ae6e387af14ce91e7fe6.jpg", "main_image_caption": "Emergency services and firefighters are on the scene near the southern German town of Buchloe, where a coach overturned on the A96 motorway. (is associated with: «Two dead, 26 injured after coach overturns in southern Germany») Karl-Josef Hildenbrand/dpa", "full_text_available": true } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"yahoo.com/read_article","input":{"article":"https://www.yahoo.com/news/world/articles/two-dead-26-injured-coach-074835373.html"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Can you pull up the full text of this Yahoo News story about the coach crash in southern Germany that left two dead and 26 injured? - I need the author, publication date, and section for the article titled Two dead, 26 injured after coach overturns in southern Germany. - Read the Yahoo article at https://www.yahoo.com/news/ and give me its summary, tags, and word count. - Find the news story about a bus accident in Bavaria and return its headline, main image, and paragraphs. - Look up the article on the German coach overturning and tell me its section and the article id. ## Input schema ```json { "type": "object", "required": [ "article" ], "properties": { "article": { "type": "string", "description": "Yahoo News article link or headline, such as Two dead, 26 injured after coach overturns in southern Germany." } } } ``` ## Output schema ```json { "type": "object", "required": [ "headline", "summary", "authors", "published_at", "updated_at", "section", "tags", "main_image_link", "main_image_caption", "paragraphs", "full_text_available", "word_count", "article_link", "article_id" ], "properties": { "tags": { "type": "array", "items": { "type": "string" } }, "authors": { "type": "array", "items": { "type": "string" } }, "section": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "article_id": { "type": [ "string", "null" ], "x-fous-developer": true }, "paragraphs": { "type": "array", "items": { "type": "string" } }, "updated_at": { "type": [ "string", "null" ], "description": "Last update date and time in ISO 8601 with offset." }, "word_count": { "type": "integer" }, "article_link": { "type": "string" }, "published_at": { "type": [ "string", "null" ], "description": "Publication date and time in ISO 8601 with offset." }, "main_image_link": { "type": [ "string", "null" ] }, "main_image_caption": { "type": [ "string", "null" ] }, "full_text_available": { "type": "boolean" } }, "additionalProperties": false } ``` ## See more - [Yahoo API: List Yahoo News headlines](https://fous.com/methods/yahoo.com/list-headlines.md): Lists the latest Yahoo News headlines for a section in page order, with summary, byline, original publisher, image and publication time when the article provides them. - [Yahoo API: Search Yahoo News](https://fous.com/methods/yahoo.com/search-news.md): Searches Yahoo News articles by keyword, newest first or by relevance, with optional publication dates and pages; returns only articles hosted on Yahoo News, with authors, original publisher and section. - [Yahoo API: Get company news](https://fous.com/methods/finance.yahoo.com/get-company-news.md): Looks up a company by name or ticker on Yahoo Finance and returns its latest news headlines, with article summaries when the article page provides one. - [Yahoo API: Get player stats](https://fous.com/methods/sports.yahoo.com/get-player-stats.md): Looks up a Yahoo Sports player by name and returns the player's regular-season statistics for a season, alongside career totals. Each stat includes season and career values. - [Yahoo API: Get quote](https://fous.com/methods/finance.yahoo.com/get-quote.md): Looks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed. - [Yahoo API: Get analyst ratings](https://fous.com/methods/finance.yahoo.com/get-analyst-ratings.md): Shows analyst recommendations, price targets, earnings estimates and recent rating changes for a public company on Yahoo Finance. - [Yahoo API: Get scores](https://fous.com/methods/sports.yahoo.com/get-scores.md): Gets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games. - [Yahoo API: List market movers](https://fous.com/methods/finance.yahoo.com/list-market-movers.md): Lists Yahoo Finance's top gainers, top losers, most active stocks, or regional trending tickers in Yahoo's order, with price, change, volume and market cap. - [All Yahoo methods](https://fous.com/methods/yahoo.com.md)