# Times of India API: List headlines > Lists Times of India headlines for a news section or city page, in page order, with article details. Skips video-only items and advertisements. Unofficial. Not affiliated with or endorsed by Times of India. - Page: https://fous.com/methods/timesofindia.indiatimes.com/list-headlines - Method: `timesofindia.indiatimes.com/list_headlines`, version 1 - Website: timesofindia.indiatimes.com - Returns: headline, summary, published_at, authors, section, image_link, article_link - 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 | |---|---|---|---|---| | `city` | string | no | | City whose news page to list instead, for example Mumbai. | | `section` | string | no | `"India"` | News section to list, for example India. Ignored when city is given. One of "top stories", "India", "world", "business", "cricket", "entertainment", "sports". Default "top stories". | | `max_results` | integer | no | `5` | Maximum stories to return, for example 20. Default 20. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "section": "India", "max_results": 5 } ``` Its output: ```json { "stories": [ { "authors": [ "Subhadra Srivastava" ], "section": "India", "summary": "NEW DELHI: The Congress on Friday accused Prime Minister Narendra Modi of remaining silent on reported face-offs between Indian and Chinese troops in", "headline": "'Deafening silence from PM': Congress targets Centre over reported 'face-offs' along Arunachal border", "image_link": "https://static.toiimg.com/thumb/resizemode-4,width-1280,height-720,msid-135139327/135139327.jpg", "article_link": "https://timesofindia.indiatimes.com/india/deafening-silence-from-pm-congress-targets-centre-over-reported-face-offs-along-arunachal-border/articleshow/135139190.cms", "published_at": "2026-10-23T13:53:00+05:30" }, { "authors": [ "Priyanka Jaiswal" ], "section": "India", "summary": "NEW DELHI: Businessman Robert Vadra has alleged that pressure was exerted on his son, artist and photographer Raihan Vadra, to remove photographs", "headline": "'Lot of pressure on him, happened in just 2 hrs': Robert Vadra on son Raihan’s Bikaner exhibition row", "image_link": "https://static.toiimg.com/thumb/resizemode-4,width-1280,height-720,msid-135138887/135138887.jpg", "article_link": "https://timesofindia.indiatimes.com/india/lot-of-pressure-on-him-happened-in-just-2-hrs-robert-vadra-on-son-raihans-bikaner-exhibition-row/articleshow/135138127.cms", "published_at": "2026-10-23T13:30:00+05:30" }, { "authors": [ "Priyanka Jaiswal" ], "section": "India", "summary": "NEW DELHI: Union minister for parliamentary affairs Kiren Rijiju on Friday said Indian authorities were helping Umrah pilgrims stranded in Saudi Arabia", "headline": "‘Stranded Umrah pilgrims being assisted’: Rijiju shares helpline numbers for Indians in Saudi Arabia", "image_link": "https://static.toiimg.com/thumb/resizemode-4,width-1280,height-720,msid-135139388/135139388.jpg", "article_link": "https://timesofindia.indiatimes.com/india/stranded-umrah-pilgrims-being-assisted-rijiju-shares-helpline-numbers-for-indians-in-saudi-arabia/articleshow/135139042.cms", "published_at": "2026-10-23T13:29:00+05:30" } ] } ``` ## 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":"timesofindia.indiatimes.com/list_headlines","input":{"section":"India","max_results":5}}' ``` 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 - Show me the latest top stories from the Times of India news page, about 15 of them. - What are the most recent headlines for the cricket section right now? Give me up to 10. - List the business news stories on the site with their summaries and authors. - I need the top 25 headlines from the Mumbai city news page, with links to each article. - Pull up the entertainment section headlines and their publication times, limited to 8 stories. ## Input schema ```json { "type": "object", "properties": { "city": { "type": "string", "description": "City whose news page to list instead, for example Mumbai." }, "section": { "enum": [ "top stories", "India", "world", "business", "cricket", "entertainment", "sports" ], "type": "string", "default": "top stories", "description": "News section to list, for example India. Ignored when city is given." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum stories to return, for example 20." } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "required": [ "stories" ], "properties": { "stories": { "type": "array", "items": { "type": "object", "required": [ "headline", "summary", "published_at", "authors", "section", "image_link", "article_link" ], "properties": { "authors": { "type": "array", "items": { "type": "string" } }, "section": { "type": "string" }, "summary": { "type": [ "string", "null" ] }, "headline": { "type": "string" }, "image_link": { "type": [ "string", "null" ] }, "article_link": { "type": "string" }, "published_at": { "type": [ "string", "null" ], "description": "Publication date-time with offset, when shown." } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Times of India API: Search news articles](https://fous.com/methods/timesofindia.indiatimes.com/search-news.md): Searches Times of India articles by words in their headline or summary, with optional publication date range and newest or most relevant ordering. - [Times of India API: Read article](https://fous.com/methods/timesofindia.indiatimes.com/read-article.md): Reads a Times of India article by link or by headline and returns its text and details. Live blogs return the updates on the public page. Headline searches work from the site's topic pages and can miss very recent or older articles. - [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. - [BBC News API: List headlines](https://fous.com/methods/bbc.com/list-headlines.md): Lists the article headlines shown on a BBC News section page, in page order, with summary, publish time, authors, image and link. - [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. - [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. - [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. - [All Times of India methods](https://fous.com/methods/indiatimes.com.md)