Docs menu
Times of India API endpoint
Times of India top stories API
Returns the current Times of India top stories. It takes no parameters. Each item has its title, URL, summary, publication time with its UTC offset, author and image URL. Use the headlines endpoint for a section or city edition.
GETapiKey1 credit/requestTimes of Indiapublicnews.newsResponseDoc
Times of India/timesofindia/newsEndpoint facts
- Method
- GET
- API path
- /timesofindia/news
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Times of India
- Response schema
- #/definitions/publicnews.newsResponseDoc
How this endpoint behaves
Returns fresh Times of India top-stories headline metadata from the platform's public RSS feed (https://timesofindia.indiatimes.com/rssfeedstopstories.cms).
Sampled response
- Request, 14 Oct 2026
- GET /timesofindia/news
- Items in items
- 44
- Fields filled in every checked item
- 5
- Fields empty in some or all items
- 1
| Field | Filled in, of 44 checked | Values in the sample |
|---|---|---|
| title | 44 | median 78 characters |
| url | 44 | timesofindia.indiatimes.com |
| summary | 27 | median 406 characters |
| published_at | 44 | 2026-10-12 to 2026-10-13 |
| author | 44 | |
| image_url | 44 | static.toiimg.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/timesofindia/news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"items": [
{
"title": "Example Times of India headline",
"url": "https://timesofindia.indiatimes.com/business/india-business/example-story/articleshow/134456699.cms",
"summary": "A one-sentence description of the story.",
"published_at": "2026-09-24T14:22:47+05:30",
"author": "Jane Reporter",
"image_url": "https://static.toiimg.com/photo/msid-134456736.cms"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.newsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.NewsResponse | No | ||||
| data.items | array | No | ||||
| data.items[].author | string | No | ||||
| data.items[].image_url | string | No | ||||
| data.items[].published_at | string | No | ||||
| data.items[].summary | string | No | ||||
| data.items[].title | string | No | ||||
| data.items[].type | string | No | ||||
| data.items[].url | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/timesofindia/news" \
-H "x-api-key: $CRAWLORA_API_KEY"