# Times of India API: Read article

> 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.

Unofficial. Not affiliated with or endorsed by Times of India.

- Page: https://fous.com/methods/timesofindia.indiatimes.com/read-article
- Method: `timesofindia.indiatimes.com/read_article`, version 1
- Website: timesofindia.indiatimes.com
- Returns: headline, summary, authors, published_at, updated_at, section, tags, main image, paragraphs, word count, article URL and 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 | `"Daily rashi Tarot predictions, September 29, 2026; Today’s tarot pull for every zodiac sign"` | The Times of India article link or headline, for example “Trump questions UK release of five suspects held over alleged attack on US airbase”. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "article": "Daily rashi Tarot predictions, September 29, 2026; Today’s tarot pull for every zodiac sign"
}
```

Its output:

```json
{
  "tags": [
    "Daily rashi Tarot predictions",
    "September 28 2026 tarot predictions",
    "Tarot predictions for zodiac signs"
  ],
  "authors": [
    "TOI Astrology"
  ],
  "section": "Numerology Predictions News",
  "summary": "MESHA RASHI / ARIES Today's Theme: Fresh ideas want action today, but pacing yourself matters more than proving speed.",
  "headline": "Daily rashi Tarot predictions, September 28, 2026; Today’s tarot pull for every zodiac sign",
  "article_id": "134516378",
  "paragraphs": [
    "MESHA RASHI / ARIES",
    "Today's Theme:",
    "Fresh ideas want action today, but pacing yourself matters more than proving speed."
  ],
  "updated_at": "2026-09-28T06:00:00+05:30",
  "word_count": 7060,
  "article_url": "https://timesofindia.indiatimes.com/astrology/numerology-tarot/daily-rashi-tarot-predictions-september-28-2026-todays-tarot-pull-for-every-zodiac-sign/articleshow/134516378.cms",
  "published_at": "2026-09-28T06:00:00+05:30",
  "main_image_url": "https://static.toiimg.com/thumb/resizemode-4,width-1280,height-720,msid-134516493/134516493.jpg",
  "main_image_caption": null,
  "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":"timesofindia.indiatimes.com/read_article","input":{"article":"Daily rashi Tarot predictions, September 29, 2026; Today’s tarot pull for every zodiac sign"}}'
```

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 Times of India article: Trump questions UK release of five suspects held over alleged attack on US airbase?
- Get me the headline, author, and publish time for the indiatimes story about a recent UK airbase attack suspects release.
- I need the paragraphs and word count from https://timesofindia.indiatimes.com/world/us/trump-questions-uk-release-of-five-suspects-held-over-alleged-attack-on-us-airbase/articleshow/example.cms
- Read the live updates page for an ongoing news blog and list the latest entries with their timestamps.
- Find the section, tags, and main image details for an Indian news story about a shooting near a US military base.

## 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”."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "headline",
    "summary",
    "authors",
    "published_at",
    "updated_at",
    "section",
    "tags",
    "main_image_url",
    "main_image_caption",
    "paragraphs",
    "full_text_available",
    "word_count",
    "article_url",
    "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"
      ]
    },
    "word_count": {
      "type": "integer"
    },
    "article_url": {
      "type": "string"
    },
    "published_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "main_image_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "main_image_caption": {
      "type": [
        "string",
        "null"
      ]
    },
    "full_text_available": {
      "type": "boolean"
    }
  },
  "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: List headlines](https://fous.com/methods/timesofindia.indiatimes.com/list-headlines.md): Lists Times of India headlines for a news section or city page, in page order, with article details. Skips video-only items and advertisements.
- [The Guardian API: Read article](https://fous.com/methods/theguardian.com/read-article.md): Reads one public Guardian article by link or headline and returns its details and available full-text paragraphs. Live blogs return the latest entries shown on the page; some older articles may be unavailable.
- [TechCrunch API: Read an article](https://fous.com/methods/techcrunch.com/read-article.md): Reads a public TechCrunch article by link or headline and returns its text, authors, dates, section, tags and image. Live blogs return their latest public updates.
- [BBC News API: Read article](https://fous.com/methods/bbc.com/read-article.md): Reads the text and details of a BBC News article from its link or headline. Live coverage pages return the latest entries available.
- [Yahoo API: Read article](https://fous.com/methods/yahoo.com/read-article.md): Reads a public Yahoo News article from its link or headline and returns its text and details. Headline matching uses Yahoo News search results.
- [NPR API: Read article](https://fous.com/methods/npr.org/read-article.md): Reads an NPR article by its link or headline and returns its text and publication details. For live blogs, returns the displayed updates.
- [Daily Mail API: Read an article](https://fous.com/methods/dailymail.co.uk/read-article.md): Reads a public Daily Mail article from its link, or from a headline (the best-matching result of the site's search), and returns its text and details; live blogs give the latest entries shown on the page.
- [All Times of India methods](https://fous.com/methods/indiatimes.com.md)