List news feed items

GET /v1/news

Returns lightweight news records over the news dataset, with optional filtering by symbol, scrip code, sentiment, and time window.

When to use it

Use this endpoint for research feeds, portfolio news panels, company-aware agents, and watchlist monitors. For near-live delivery, see WebSocket news streams.

Authentication and billing

Requires X-API-Key or api_key.
Credit cost: 1 credit / page. Bills 1 credit per page when results are returned. Empty pages are not charged.
See pricing for plan allowances and full billing details.

Request

This endpoint does not require a request body.

Field	Location	Required	Notes
`symbols`	query	No	Optional comma-separated values such as `RELIANCE,TCS` or repeated query parameters. Maximum 20 symbols.
`scrip_codes`	query	No	Optional comma-separated values such as `500325,532540` or repeated query parameters. Maximum 20 scrip codes.
`sentiment`	query	No	Optional sentiment filter. Allowed values: `positive`, `negative`, `neutral`.
`from`	query	No	Optional ISO date or datetime lower bound. The lower bound is inclusive.
`to`	query	No	Optional ISO date or datetime upper bound. The upper bound is inclusive.
`page`	query	No	Page number. Defaults to `1`.
`limit`	query	No	Page size. The default is route-specific and is usually `20` or `50`.
`api_key`	query	No	Optional alternative to the `X-API-Key` header. Prefer the header for server-side applications.

Response

Returns data as an array of news items and has_next for pagination. Items include title, summary, company, symbol, sentiment, source, link, scrip code, and date when available. date is the article publish time.

Show Schema

Successful Responseapplication/json

{
  "data": [
    {
      "id": "68216d8947693178bd4bb5a1",
      "title": "Reliance Industries gains after telecom tariff commentary",
      "specific_title": "Reliance Jio seen benefiting from improved tariff discipline",
      "summary": "Broker and market commentary pointed to stronger telecom pricing discipline, supporting sentiment around Reliance Jio.",
      "long_summary": "Telecom pricing commentary and sector checks suggested a constructive earnings setup for integrated operators, with Reliance seen as a key beneficiary.",
      "company": "Reliance Industries",
      "symbol": "RELIANCE",
      "sentiment": "positive",
      "source": "Moneycontrol",
      "article_type": "market_news",
      "link": "https://example.com/news/reliance-telecom-tariff-commentary",
      "scrip_code": "500325",
      "date": "2026-05-12T09:14:00+00:00"
    },
    {
      "id": "68216d8947693178bd4bb5a2",
      "title": "IT stocks mixed after US demand commentary",
      "summary": "Near-term deal commentary remained selective across large-cap IT names.",
      "company": "Tata Consultancy Services",
      "symbol": "TCS",
      "sentiment": "neutral",
      "source": "Economic Times",
      "article_type": "company_news",
      "link": "https://example.com/news/it-demand-commentary",
      "scrip_code": "532540",
      "date": "2026-05-12T08:42:00+00:00"
    }
  ],
  "has_next": true
}

Request pattern

curl -G "https://developers.manasija.in/v1/news" \
  -H "X-API-Key: $DRISHTI_API_KEY" \
  --data-urlencode "symbols=RELIANCE,TCS" \
  --data-urlencode "limit=10"

JavaScript / TypeScript SDK

const news = await client.getNews({
  symbols: ["RELIANCE", "TCS"],
  limit: 10,
})

Python SDK

news = client.get_news(
    symbols=["RELIANCE", "TCS"],
    limit=10,
)

Interactive reference

Use the Scalar API client for executable requests, schemas, and the full OpenAPI contract.