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.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- City optional
city City whose news page to list instead, for example Mumbai.
Not set
- Section optional
section News section to list, for example India. Ignored when city is given.
India
One of
top stories,India,world,business,cricket,entertainment,sports. Defaulttop stories.- Max Results optional
max_results Maximum stories to return, for example 20.
5
Whole number from 1 to 50. Default
20.
Input as JSON
{ "section": "India", "max_results": 5}Output
{ "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" } ]}Code
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}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "timesofindia.indiatimes.com/list_headlines" , "input": { "section": "India", "max_results": 5 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "timesofindia.indiatimes.com/list_headlines" , "input": { "section": "India", "max_results": 5 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run timesofindia.indiatimes.com/list_headlines# with {"section":"India","max_results":5}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
timesofindia.indiatimes.com/list_headlines- Returns
- headline, summary, published_at, authors, section, image_link, article_link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method timesofindia.indiatimes.com/list_headlines with the inputs above.
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.
See more
All Times of India methodsSearches Times of India articles by words in their headline or summary, with optional publication date range and newest or most relevant ordering.
timesofindia.indiatimes.com/search_newsReads 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.
timesofindia.indiatimes.com/read_articleLists 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.
nytimes.com/list_headlinesLists the article headlines shown on a BBC News section page, in page order, with summary, publish time, authors, image and link.
bbc.com/list_headlinesLists the latest Reuters stories from a news section (top stories, business, markets, world, technology, legal or sustainability) in page order.
reuters.com/list_headlinesLists 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.com/list_headlinesLists The Verge story headlines, including quick posts, in the order shown on a section page. Archive pages are added when more stories are needed.
theverge.com/list_headlinesLists the latest TechCrunch story headlines in a section, in page order. Skips video, podcast and event promotion cards.
techcrunch.com/list_headlines