# Techmeme API: List top stories > Lists Techmeme's leading stories in page order, with each story's original article and linked coverage. Uses the live front page, or the evening archive for a given date. Unofficial. Not affiliated with or endorsed by Techmeme. - Page: https://fous.com/methods/techmeme.com/list-top-stories - Method: `techmeme.com/list_top_stories`, version 1 - Website: techmeme.com - Returns: headline, source publication, author, summary, time added, article link, related coverage - 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 | |---|---|---|---|---| | `date` | string | no | | Day of stories as YYYY-MM-DD, for example 2026-09-28. Omit for the live front page. Dates run from 2005-09-12 through today. | | `max_results` | integer | no | `1` | Maximum number of top stories to return, for example 20. Default 20. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "max_results": 1 } ``` Its output: ```json { "stories": [ { "author": "Kate Rooney", "summary": "OpenAI is closing in on a funding round that could value the artificial intelligence giant at more than $1 trillion ahead …", "headline": "Sources: OpenAI nears an up to $30B round led by investors from the UAE and Coatue at a $1.25T pre-money valuation, as an “opportunistic” bridge ahead of an IPO", "time_added": null, "article_link": "https://www.cnbc.com/2026/10/22/openai-funding-round-uae-investors.html", "related_coverage": [ { "link": "https://techcrunch.com/2026/10/22/openai-working-on-new-30b-raise-at-1-25t-valuation-ahead-of-ipo/", "publication_name": "TechCrunch" }, { "link": "https://www.theinformation.com/briefings/openai-fundraising-round-set-close-soon-uae-investors-coatue-leading-investment", "publication_name": "The Information" }, { "link": "https://www.implicator.ai/openai-30-billion-round-1-25-trillion/", "publication_name": "Implicator.ai" } ], "source_publication": "CNBC" } ] } ``` ## 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":"techmeme.com/list_top_stories","input":{"max_results":1}}' ``` 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 - What are the top stories on Techmeme's front page right now? - Show me the leading headlines from the live Techmeme homepage, limited to 10 items. - Give me the top tech stories from techmeme.com archive for 2026-03-14 with their source publications and authors. - I want the main stories from the evening archive of 2025-11-02, including linked related coverage for each one. - List the 25 most prominent tech news stories from yesterday's Techmeme page, with summaries and article links. ## Input schema ```json { "type": "object", "required": [], "properties": { "date": { "type": "string", "description": "Day of stories as YYYY-MM-DD, for example 2026-09-28. Omit for the live front page. Dates run from 2005-09-12 through today." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of top stories to return, for example 20." } } } ``` ## Output schema ```json { "type": "object", "required": [ "stories" ], "properties": { "stories": { "type": "array", "items": { "type": "object", "required": [ "headline", "source_publication", "author", "summary", "time_added", "article_link", "related_coverage" ], "properties": { "author": { "type": [ "string", "null" ] }, "summary": { "type": "string" }, "headline": { "type": "string" }, "time_added": { "type": [ "string", "null" ], "format": "date-time" }, "article_link": { "type": "string" }, "related_coverage": { "type": "array", "items": { "type": "object", "required": [ "publication_name", "link" ], "properties": { "link": { "type": "string" }, "publication_name": { "type": "string" } }, "additionalProperties": false } }, "source_publication": { "type": "string" } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Google API: List top stories](https://fous.com/methods/news.google.com/list-top-stories.md): Lists the current top Google News stories, overall or for one topic, in a chosen country and language edition. - [The New York Times API: List headlines](https://fous.com/methods/nytimes.com/list-headlines.md): Lists current New York Times headlines with summaries, authors, images and publication times, in the order shown on the chosen section page (top stories or a section). Video-only items, ads and promotions are left out; times come from the section's feed and may be missing. - [The Verge API: List headlines](https://fous.com/methods/theverge.com/list-headlines.md): Lists The Verge story headlines, including quick posts, in the order shown on a section page. Archive pages are added when more stories are needed. - [TechCrunch API: List headlines](https://fous.com/methods/techcrunch.com/list-headlines.md): Lists the latest TechCrunch story headlines in a section, in page order. Skips video, podcast and event promotion cards. - [Product Hunt API: List daily launches](https://fous.com/methods/producthunt.com/list-launches.md): Lists featured launches in Product Hunt's daily leaderboard order for a given US Pacific day, with each product's website when its public page shows one. - [CNBC API: List headlines](https://fous.com/methods/cnbc.com/list-headlines.md): Lists CNBC article headlines in the order they appear on a public news section page, with summary, time, authors and image. - [TechCrunch API: Search articles](https://fous.com/methods/techcrunch.com/search-news.md): Searches TechCrunch articles by keyword, with an optional publication date range and newest or most relevant order. - [Reuters API: List headlines](https://fous.com/methods/reuters.com/list-headlines.md): Lists the latest Reuters stories from a news section (top stories, business, markets, world, technology, legal or sustainability) in page order.