# Indiatimes Scraper - News, Tech, Sports & Entertainment (`fingolfin/indiatimes-scraper`) Actor

Scrape articles from Indiatimes.com - news trending news, technology, Bollywood, cricket, health, celebrity net worth, and more. 23 categories, keyword search, full article body extraction with structured JSON output. more details https://rapidapi.com/matepapava123/api/indiatimes-news-api

- **URL**: https://apify.com/fingolfin/indiatimes-scraper.md
- **Developed by:** [Mate Papava](https://apify.com/fingolfin) (community)
- **Categories:** News, AI, Agents
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Indiatimes Scraper — India News, Tech, Sports, Bollywood & Net Worth Data

Scrape and extract structured data from [Indiatimes.com](https://www.indiatimes.com), one of India's largest news, entertainment, and lifestyle portals owned by Times Internet (the Times of India group). This Actor turns any Indiatimes category, search query, or article URL into clean, ready-to-use JSON — no HTML parsing on your end.

> **Best for:** Indian news monitoring, Bollywood & cricket content feeds, trending-topic research, celebrity net worth data, Gen Z & pop-culture tracking, and building news aggregators or NLP/LLM datasets.

---

### What this Actor does

- **Browse 23 categories** — every main section and sub-section of Indiatimes
- **Keyword search** — find the latest articles for any topic, person, or brand
- **Full article extraction** — title, author, publish/update dates, paragraph body text, inline images, and tags
- **Structured JSON output** — stored in an Apify dataset, exportable to JSON, CSV, Excel, or API

---

### What data can you extract?

- **Trending & Viral News** — what's buzzing in India and globally
- **Technology** — smartphones, AI, gadgets, apps, gaming
- **Entertainment** — Bollywood, Hollywood, anime, web series, TV shows
- **Sports** — cricket (IPL, World Cup), football, NBA, WWE
- **News** — India, world, politics, weird news
- **Lifestyle** — fashion, food, travel, relationships, dating trends
- **Health & Wellness** — fitness, mental health, medical tips
- **Celebrity Net Worth** — income, salary, business breakdowns
- **Pop Culture** — Gen Z trends, memes, internet culture
- **Auto** — cars, bikes, EV news
- **Events** — festivals, concerts, gatherings
- **Fashion** — style, trends, designer news

---

### Use Cases

- **News aggregation** — feed Indian news into your app or dashboard
- **Content monitoring** — track coverage of brands, topics, or people
- **Media research** — analyze trending topics and audience interests
- **Data journalism** — structured data for editorial analysis
- **SEO research** — discover trending keywords and topics in India
- **Social listening** — monitor what Indian audiences are reading
- **AI / LLM datasets** — collect clean article text for training and RAG

---

### How to use it

1. Open the Actor and pick a **mode** (`articles`, `search`, or `detail`).
2. Fill the matching fields (a `category`, a `query`, or an `articleUrl`).
3. Optionally enable **Fetch Full Article Details** to enrich every listing with full body text.
4. Click **Start**, then download results from the **Dataset** tab (JSON, CSV, Excel) or pull them via the Apify API.

---

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `mode` | string | Yes | `articles` (browse a category), `search` (keyword search), or `detail` (one article) |
| `category` | string | For `articles` | Category key, e.g. `trending`, `sports/cricket` |
| `query` | string | For `search` | Search keyword, e.g. `cricket world cup`, `iphone` |
| `articleUrl` | string | For `detail` | Full Indiatimes article URL |
| `fetchDetails` | boolean | No | In `articles`/`search` mode, fetch full body text for each result (slower, richer data) |

---

### Available Categories

**Main:** `trending`, `news`, `technology`, `entertainment`, `sports`, `lifestyle`, `health`, `worth`, `culture`, `fashion`, `events`, `auto`

**Sub-categories:** `news/india`, `news/world`, `news/weird`, `technology/news`, `technology/apps`, `technology/gaming`, `entertainment/bollywood`, `entertainment/hollywood`, `sports/cricket`, `sports/wwe`, `lifestyle/relationships`

---

### Example Inputs

#### Get trending articles
```json
{
    "mode": "articles",
    "category": "trending"
}
````

#### Search for a topic

```json
{
    "mode": "search",
    "query": "cricket world cup"
}
```

#### Get full article with body text

```json
{
    "mode": "detail",
    "articleUrl": "https://www.indiatimes.com/trending/thailand-scraps-visa-free-stay-for-indians-where-gen-z-travellers-can-go-instead/articleshow/131304242.html"
}
```

#### Get technology articles enriched with full details

```json
{
    "mode": "articles",
    "category": "technology",
    "fetchDetails": true
}
```

***

### Output Format

Each dataset item is a clean JSON object. Listings include the core fields; `detail` mode and `fetchDetails: true` add the full body, images, tags, and timestamps:

```json
{
    "title": "Article headline",
    "url": "https://www.indiatimes.com/...",
    "author": "Author Name",
    "summary": "Brief description of the article",
    "image_url": "https://staticimg.publishstory.co/...",
    "category": "trending",
    "published_at": "2026-05-25T14:15:07+05:30",
    "updated_at": "2026-05-25T14:15:07+05:30",
    "tags": ["keyword1", "keyword2"],
    "body": ["Paragraph 1...", "Paragraph 2..."],
    "images": [{ "url": "...", "caption": "" }]
}
```

The dataset ships with an **Articles** table view (title, URL, author, summary, image, category, published date, tags) so you can preview results in the Apify Console without exporting.

***

### Tips & Notes

- Search results are server-rendered for the first page only (Indiatimes uses client-side infinite scroll for older items), so `search` mode returns the most recent matches for a keyword.
- Enable `fetchDetails` only when you need full text — it makes one extra request per article.
- Be considerate with run frequency; this Actor reads public content from a live website.

***

### Keywords

indiatimes scraper, india news api, indian news scraper, times of india scraper, bollywood news api, cricket news scraper, indian media api, indiatimes data extraction, india trending news, technology news india, sports news india api, celebrity net worth scraper, gen z trends india, lifestyle news api, entertainment news scraper india, india world news scraper, pop culture india data, indian news monitoring, india content aggregator, news dataset india

# Actor input Schema

## `mode` (type: `string`):

Scraping mode: 'articles' to browse by category, 'search' to search by keyword, 'detail' to get full article content

## `category` (type: `string`):

Category to scrape (used in 'articles' mode)

## `query` (type: `string`):

Keyword to search for (used in 'search' mode). Examples: 'cricket', 'iphone', 'elon musk'

## `articleUrl` (type: `string`):

Full indiatimes.com article URL (used in 'detail' mode)

## `fetchDetails` (type: `boolean`):

When enabled in 'articles' or 'search' mode, fetches full body text for each article (slower but more data)

## Actor input object example

```json
{
  "mode": "articles",
  "category": "trending",
  "fetchDetails": false
}
```

# Actor output Schema

## `articles` (type: `string`):

All scraped articles from the run, stored in the default dataset as structured JSON.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("fingolfin/indiatimes-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("fingolfin/indiatimes-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call fingolfin/indiatimes-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=fingolfin/indiatimes-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Indiatimes Scraper - News, Tech, Sports & Entertainment",
        "description": "Scrape articles from Indiatimes.com - news trending news, technology, Bollywood, cricket, health, celebrity net worth, and more. 23 categories, keyword search, full article body extraction with structured JSON output. more details https://rapidapi.com/matepapava123/api/indiatimes-news-api",
        "version": "1.0",
        "x-build-id": "B8Q7RWSSBjdw3WhHR"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/fingolfin~indiatimes-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-fingolfin-indiatimes-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/fingolfin~indiatimes-scraper/runs": {
            "post": {
                "operationId": "runs-sync-fingolfin-indiatimes-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/fingolfin~indiatimes-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-fingolfin-indiatimes-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "articles",
                            "search",
                            "detail"
                        ],
                        "type": "string",
                        "description": "Scraping mode: 'articles' to browse by category, 'search' to search by keyword, 'detail' to get full article content",
                        "default": "articles"
                    },
                    "category": {
                        "title": "Category",
                        "enum": [
                            "trending",
                            "news",
                            "technology",
                            "entertainment",
                            "sports",
                            "lifestyle",
                            "health",
                            "worth",
                            "culture",
                            "fashion",
                            "events",
                            "auto",
                            "news/india",
                            "news/world",
                            "news/weird",
                            "technology/news",
                            "technology/apps",
                            "technology/gaming",
                            "entertainment/bollywood",
                            "entertainment/hollywood",
                            "sports/cricket",
                            "sports/wwe",
                            "lifestyle/relationships"
                        ],
                        "type": "string",
                        "description": "Category to scrape (used in 'articles' mode)",
                        "default": "trending"
                    },
                    "query": {
                        "title": "Search Query",
                        "type": "string",
                        "description": "Keyword to search for (used in 'search' mode). Examples: 'cricket', 'iphone', 'elon musk'"
                    },
                    "articleUrl": {
                        "title": "Article URL",
                        "type": "string",
                        "description": "Full indiatimes.com article URL (used in 'detail' mode)"
                    },
                    "fetchDetails": {
                        "title": "Fetch Full Article Details",
                        "type": "boolean",
                        "description": "When enabled in 'articles' or 'search' mode, fetches full body text for each article (slower but more data)",
                        "default": false
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
