# Times of India API

> Times of India returns news headlines, article details, and article text as a workflow and API.

Times of India (TOI) lists headlines and article details from a section or city page; choose a section or city and a maximum number of results. Search news finds articles by words in headlines or summaries, with optional date range, sort order, page, and result count. Read article returns text and details for an article using its link or headline.

- Page: https://fous.com/tools/times-of-india
- Handle: `@times-of-india`
- Category: [News](https://fous.com/tools/category/news)
- Source website: https://timesofindia.indiatimes.com
- Last verified: Sep 29, 2026

## Methods

### List headlines

Operation `list_headlines`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List Times of India headlines in the order shown on a section or city page, with article details. Skips video-only items and advertisements; publication time and author may be missing when not shown.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `city` | string | no | `"Mumbai"` | 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. |
| `max_results` | integer | no | `4` | Maximum stories to return, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City whose news page to list instead, for example Mumbai.",
      "examples": [
        "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.",
      "examples": [
        "India",
        "cricket",
        "top stories"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum stories to return, for example 20.",
      "x-fous-developer": true,
      "examples": [
        4,
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "city": "Mumbai",
      "max_results": 4
    },
    {
      "section": "India",
      "max_results": 5
    },
    {
      "section": "cricket",
      "max_results": 4
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `stories` | array |  |  |
| `stories[].authors` | array |  |  |
| `stories[].section` | string | `"Mumbai"` |  |
| `stories[].summary` | string or null | `"IIT Bombay’s suicide probe panel is yet to contact BTech student Sahil Wakode’s family a week after being formed, as pa` |  |
| `stories[].headline` | string | `"1 week on, IIT-B suicide probe panel ‘yet to speak to family’"` |  |
| `stories[].image_link` | string or null | `"https://static.toiimg.com/thumb/resizemode-72,width-1280,height-720,msid-134549196/134549196.jpg"` |  |
| `stories[].article_link` | string | `"https://timesofindia.indiatimes.com/city/mumbai/1-week-on-iit-b-suicide-probe-panel-yet-to-speak-to-family/articleshow/` |  |
| `stories[].published_at` | string or null | `"2026-09-29T00:10:00+05:30"` | Publication date-time with offset, when shown. |

**Example input**

```json
{
  "city": "Mumbai",
  "max_results": 4
}
```

**Example output**

```json
{
  "stories": [
    {
      "authors": [
        "Yogita Rao"
      ],
      "section": "Mumbai",
      "summary": "IIT Bombay’s suicide probe panel is yet to contact BTech student Sahil Wakode’s family a week after being formed, as parents continue hunger strike.",
      "headline": "1 week on, IIT-B suicide probe panel ‘yet to speak to family’",
      "image_link": "https://static.toiimg.com/thumb/resizemode-72,width-1280,height-720,msid-134549196/134549196.jpg",
      "article_link": "https://timesofindia.indiatimes.com/city/mumbai/1-week-on-iit-b-suicide-probe-panel-yet-to-speak-to-family/articleshow/134549197.cms",
      "published_at": "2026-09-29T00:10:00+05:30"
    },
    {
      "authors": [
        "Yogita Rao"
      ],
      "section": "Mumbai",
      "summary": "Maharashtra proposes SMCSS 2026 to support college students of single mothers via counselling, career guidance and accommodation, with needs-based aid.",
      "headline": "Maharashtra govt proposes policy to provide support to college-going children of single mothers",
      "image_link": "https://static.toiimg.com/thumb/resizemode-72,width-1280,height-720,msid-134549143/134549143.jpg",
      "article_link": "https://timesofindia.indiatimes.com/city/mumbai/maharashtra-govt-proposes-policy-to-provide-support-to-college-going-children-of-single-mothers/articleshow/134549144.cms",
      "published_at": "2026-09-29T00:06:00+05:30"
    }
  ]
}
```

### Read article

Operation `read_article`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Read the text and details of a Times of India article by link or headline. Live blogs include the updates available on the public page; headline searches can miss very recent or older articles.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `article` | string | yes | `"https://timesofindia.indiatimes.com/world/us/trump-questions-uk-release-of-five-suspects-held-over-alleged-attack-on-us` | The Times of India article link or headline, for example “Trump questions UK release of five suspects held over alleged attack on US airbase”. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "article"
  ],
  "properties": {
    "article": {
      "type": "string",
      "description": "The Times of India article link or headline, for example “Trump questions UK release of five suspects held over alleged attack on US airbase”.",
      "examples": [
        "https://timesofindia.indiatimes.com/world/us/trump-questions-uk-release-of-five-suspects-held-over-alleged-attack-on-us-airbase/articleshow/134550101.cms",
        "Trump questions UK release of five suspects held over alleged attack on US airbase",
        "https://timesofindia.indiatimes.com/astrology/numerology-tarot/daily-rashi-tarot-predictions-september-29-2026-todays-tarot-pull-for-every-zodiac-sign/articleshow/134539065.cms"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "article": "https://timesofindia.indiatimes.com/world/us/trump-questions-uk-release-of-five-suspects-held-over-alleged-attack-on-us-airbase/articleshow/134550101.cms"
    },
    {
      "article": "Trump questions UK release of five suspects held over alleged attack on US airbase"
    },
    {
      "article": "https://timesofindia.indiatimes.com/astrology/numerology-tarot/daily-rashi-tarot-predictions-september-29-2026-todays-tarot-pull-for-every-zodiac-sign/articleshow/134539065.cms"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `tags` | array |  |  |
| `authors` | array |  |  |
| `section` | string or null | `"US News"` |  |
| `summary` | string or null | `"US President Donald Trump has criticised Britain’s decision to release on bail five men arrested over an alleged plot t` |  |
| `headline` | string | `"Trump questions UK release of five suspects held over alleged attack on US airbase"` |  |
| `article_id` | string or null | `"134550101"` |  |
| `paragraphs` | array |  |  |
| `updated_at` | string or null | `"2026-09-29T02:25:00+05:30"` |  |
| `word_count` | integer | `423` |  |
| `article_url` | string | `"https://timesofindia.indiatimes.com/world/us/trump-questions-uk-release-of-five-suspects-held-over-alleged-attack-on-us` |  |
| `published_at` | string or null | `"2026-09-29T02:25:00+05:30"` |  |
| `main_image_url` | string or null | `"https://static.toiimg.com/thumb/resizemode-4,width-1280,height-720,msid-134550102/134550102.jpg"` |  |
| `main_image_caption` | string or null | `"Trump raises Iran link after UK releases five suspects in alleged airbase plot"` |  |
| `full_text_available` | boolean | `true` |  |

**Example input**

```json
{
  "article": "https://timesofindia.indiatimes.com/world/us/trump-questions-uk-release-of-five-suspects-held-over-alleged-attack-on-us-airbase/articleshow/134550101.cms"
}
```

**Example output**

```json
{
  "tags": [
    "Trump criticism UK release suspects",
    "RAF Fairford attack plot",
    "US military UK airbase"
  ],
  "authors": [
    "Subhadra Srivastava"
  ],
  "section": "US News",
  "summary": "US President Donald Trump has criticised Britain’s decision to release on bail five men arrested over an alleged plot to attack RAF Fairford, a UK airbase",
  "headline": "Trump questions UK release of five suspects held over alleged attack on US airbase",
  "article_id": "134550101",
  "paragraphs": [
    "US President Donald Trump has criticised Britain’s decision to release on bail five men arrested over an alleged plot to attack RAF Fairford, a UK airbase used by the US military, saying he “would not…",
    "Speaking to reporters in the Oval Office on Monday, Trump said he was “surprised” the suspects had been released and suggested their actions “might be” connected to Iran. He declined to provide furthe…",
    "The five men were arrested early Sunday near the base in western England after a local farmer reported seeing three large white vans and a group of “hooded and masked men” running into a nearby field."
  ],
  "updated_at": "2026-09-29T02:25:00+05:30",
  "word_count": 423,
  "article_url": "https://timesofindia.indiatimes.com/world/us/trump-questions-uk-release-of-five-suspects-held-over-alleged-attack-on-us-airbase/articleshow/134550101.cms",
  "published_at": "2026-09-29T02:25:00+05:30",
  "main_image_url": "https://static.toiimg.com/thumb/resizemode-4,width-1280,height-720,msid-134550102/134550102.jpg",
  "main_image_caption": "Trump raises Iran link after UK releases five suspects in alleged airbase plot",
  "full_text_available": true
}
```

### Search news

Operation `search_news`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Search Times of India articles by words in their headline or summary. Date filtering and sorting cover up to the first 1,000 articles shown for a search; older matches outside that range may be missed.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `page` | integer | no | `2` | Result page number, for example 2. |
| `sort` | string | no | `"most_relevant"` | Sort order, for example newest. |
| `query` | string | yes | `"Tesla"` | Search words, for example Tesla. |
| `to_date` | string | no | `"2026-09-29"` | Latest publication date, for example 2026-09-29. |
| `from_date` | string | no | `"2026-09-01"` | Earliest publication date, for example 2026-09-01. |
| `max_results` | integer | no | `5` | Articles per page, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Result page number, for example 2.",
      "x-fous-developer": true,
      "examples": [
        2
      ]
    },
    "sort": {
      "enum": [
        "newest",
        "most_relevant"
      ],
      "type": "string",
      "default": "newest",
      "description": "Sort order, for example newest.",
      "examples": [
        "most_relevant"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Search words, for example Tesla.",
      "examples": [
        "Tesla",
        "NVIDIA",
        "a-rare-nonexistent-phrase-blarrrhzzzz"
      ]
    },
    "to_date": {
      "type": "string",
      "format": "date",
      "description": "Latest publication date, for example 2026-09-29.",
      "examples": [
        "2026-09-29"
      ]
    },
    "from_date": {
      "type": "string",
      "format": "date",
      "description": "Earliest publication date, for example 2026-09-01.",
      "examples": [
        "2026-09-01"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Articles per page, for example 20.",
      "x-fous-developer": true,
      "examples": [
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "page": 2,
      "sort": "most_relevant",
      "query": "Tesla",
      "max_results": 5
    },
    {
      "query": "Tesla"
    },
    {
      "query": "NVIDIA",
      "to_date": "2026-09-29",
      "from_date": "2026-09-01",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `articles` | array |  |  |
| `articles[].authors` | array |  |  |
| `articles[].section` | string | `"Technology"` |  |
| `articles[].summary` | string or null | `"Tesla is set to showcase its long-awaited next-gen Roadster sports car on October 1. This highly anticipated event come` |  |
| `articles[].headline` | string | `"Elon Musk’s teases ‘new Tesla Roadster’ launch almost a year after OpenAI CEO Sam Altman ‘cancelled’ his order"` |  |
| `articles[].article_link` | string | `"https://timesofindia.indiatimes.com/technology/tech-news/elon-musks-teases-new-tesla-roadster-launch-almost-a-year-afte` |  |
| `articles[].published_at` | string | `"2026-09-13T19:32:49+05:30"` | Publication date and time with offset. |

**Example input**

```json
{
  "page": 2,
  "sort": "most_relevant",
  "query": "Tesla",
  "max_results": 5
}
```

**Example output**

```json
{
  "articles": [
    {
      "authors": [
        "TIMESOFINDIA.COM"
      ],
      "section": "Technology",
      "summary": "Tesla is set to showcase its long-awaited next-gen Roadster sports car on October 1. This highly anticipated event comes after several years marked by significant delays and the cancellation of preord…",
      "headline": "Elon Musk’s teases ‘new Tesla Roadster’ launch almost a year after OpenAI CEO Sam Altman ‘cancelled’ his order",
      "article_link": "https://timesofindia.indiatimes.com/technology/tech-news/elon-musks-teases-new-tesla-roadster-launch-almost-a-year-after-openai-ceo-sam-altman-cancelled-his-order/articleshow/134205139.cms",
      "published_at": "2026-09-13T19:32:49+05:30"
    },
    {
      "authors": [
        "TIMESOFINDIA.COM"
      ],
      "section": "Technology",
      "summary": "Tesla 's new Cybercab robotaxis are now operating in Texas without traditional controls. The National Highway Traffic Safety Administration has opened an audit of these vehicles. US safety regulations…",
      "headline": "Elon Musk's Cybercab has no steering wheel, pedals or mirrors; US safety regulators open audit of about 1,000 cars over Tesla 's self-certification",
      "article_link": "https://timesofindia.indiatimes.com/technology/tech-news/elon-musks-cybercab-has-no-steering-wheel-pedals-or-mirrors-us-safety-regulators-open-audit-of-about-1000-cars-over-teslas-self-certification/a…",
      "published_at": "2026-09-11T17:49:00+05:30"
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@times-of-india",
  "visibility": "public",
  "operation": "list_headlines",
  "version": 1,
  "input": {
    "city": "Mumbai",
    "max_results": 4
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@times-of-india\",\n  \"visibility\": \"public\",\n  \"operation\": \"list_headlines\",\n  \"version\": 1,\n  \"input\": {\n    \"city\": \"Mumbai\",\n    \"max_results\": 4\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@times-of-india",
  "visibility": "public",
  "operation": "list_headlines",
  "version": 1,
  "input": {
    "city": "Mumbai",
    "max_results": 4
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/times-of-india`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `list_headlines`: List headlines. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `read_article`: Read article. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_news`: Search news. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-times-of-india https://api.fous.com/mcp/tools/times-of-india --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Track headlines from a chosen news section or city.
- Find articles that mention a company, person, or topic.
- Review article text, summaries, authors, and publication details.
- Collect article links and publication dates for research.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Times of India tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Times of India account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from timesofindia.indiatimes.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What are the latest headlines in a news section?

Use List headlines with the section and maximum number of results. It returns headlines in the order shown on the section page.

### Which articles mention a topic?

Use Search news with the topic as the query. You can also set a date range and sort order.

### Can I get the full text of an article?

Use Read article with its link or headline. The returned details include article text and indicate whether full text is available.

## Related

- [The New York Times API](https://fous.com/tools/the-new-york-times.md): The New York Times provides current section headlines and summaries, keyword-matched public listings with dates, authors, sections and links, and Best Sellers lists for the latest issue or dates within a week.
- [AP News API](https://fous.com/tools/ap-news.md): AP News provides reporting, up to 50 public-page headlines, searchable articles visible in its search, and full text when accessible.
- [Yahoo News API](https://fous.com/tools/yahoo-news.md): Yahoo News provides section headlines and searchable articles, plus public article text and details; health has no public stories, and search covers a limited results window.
- [Daily Mail API](https://fous.com/tools/daily-mail.md): Daily Mail provides ordered section headlines with available bylines and times, searches up to 200 published articles excluding syndicated wire stories, and reads public article text and details, including latest live-blog entries shown.
- [Reuters API](https://fous.com/tools/reuters.md): Reuters provides international news and reporting, with latest section headlines and keyword search; coverage and article details may be limited by access restrictions and news indexing.
- [BBC News API](https://fous.com/tools/bbc-news.md): BBC News returns section-ordered headlines, searchable articles with dates, authors and sections (filters/newest sorting cover 180 matches), and article text with available latest live entries.
- [Google News API](https://fous.com/tools/google-news.md): Google News returns recent publisher articles, up to 100 per search, current top stories by topic, country, and language, and local stories by city or region when available.
- [The Guardian API](https://fous.com/tools/the-guardian.md): The Guardian provides news, sport, culture and opinion, ordered headlines, keyword-search results that may omit older or less prominent stories, and article details with available text; live blogs show the latest entries.
- [All News tools](https://fous.com/tools/category/news)