Docs menu
India Today API endpoint
India Today section headlines API
Returns the text stories listed on one India Today section page, typically 12 to 60. `section` is required and takes one of 35 slugs such as `top-news`, `cricket`, `markets`, `bollywood` or `fact-check`; other values return 400. Items have title, URL, `type`, summary and image when shown, but no `published_at`.
GETapiKey1 credit/requestIndia Todaypublicnews.headlinesResponseDoc
India Today/indiatoday/headlinesEndpoint facts
- Method
- GET
- API path
- /indiatoday/headlines
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- India Today
- Response schema
- #/definitions/publicnews.headlinesResponseDoc
How this endpoint behaves
Query parameter: section is required and must be one of top-news, india, south-india, law, business, markets, world, us-news, sports, cricket, football, technology, science, health, environment, lifestyle, movies, bollywood, hollywood, movie-reviews, ott, television, education, elections, fact-check, opinion, trending, sunday-special, cities, auto, jobs, horoscopes, insight, data-intelligence, or history-of-it. Any other value returns a 400.
Headlines are the text stories listed on the section's page (typically 12 to 60); video, photo-gallery, and off-site links are omitted. Items carry title, url, type (the card's label such as a sub-section), summary, and image_url when the page provides them. Section pages do not print publish times, so published_at is not returned here; use indiatoday-article for it.
Sampled response
- Request, 14 Oct 2026
- GET /indiatoday/headlines?section=world
- Items in items
- 19
- Fields filled in every checked item
- 5
| Field | Filled in, of 19 checked | Values in the sample |
|---|---|---|
| title | 19 | median 78 characters |
| url | 19 | indiatoday.in |
| type | 19 | Global (16), US News (2), 2026 Midterms (1) |
| summary | 19 | median 223 characters |
| image_url | 19 | akm-img-a-in.tosshub.com |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| section | string | Yes | India Today section slug Allowed values: top-news, india, south-india, law, business, markets, world, us-news, sports, cricket, football, technology, science, health, environment, lifestyle, movies, bollywood, hollywood, movie-reviews, ott, television, education, elections, fact-check, opinion, trending, sunday-special, cities, auto, jobs, horoscopes, insight, data-intelligence, history-of-it. | top-news | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/indiatoday/headlines?section=top-news" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"section": "world",
"items": [
{
"title": "Example headline",
"url": "https://www.indiatoday.in/world/story/example-story-slug-3002364-2026-09-24",
"summary": "One-line summary."
}
]
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.headlinesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | newsplatform.HeadlinesResponse | No | ||||
| data.items | array | No | HeadlineItem record, 7 fields: author, image_url, published_at, summary, title, type, url. Described under India Today top stories API. | |||
| data.section | string | No |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/indiatoday/headlines?section=top-news" \
-H "x-api-key: $CRAWLORA_API_KEY"