Sector News

Retrieve sector related news articles and announcements across the market.

GET/3.0/news/sector

Description

This endpoint returns news articles, press releases, and corporate announcements for a specific sector. Retrieve targeted news updates for a sector by providing the sector code, with optional filtering by date range.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
symbol	string	Yes	Stock symbol to filter news for specific company. This parameter is required.	GENERIC
sector_code	string	No	Optional - filter news by industry/sector code (e.g., COMMERCIAL_BANKS). If present the news returned will be filtered by sector.	COMMERCIAL_BANKS
date_from	string	No	Start date for filtering (format: YYYY-MM-DD). When provided the server will include news from this date (inclusive).	2023-01-01
date_to	string	No	End date for filtering (format: YYYY-MM-DD). When provided it is interpreted up to end-of-day on that date.	2023-12-31
next	string	No	Pagination cursor returned by a previous response's next field (base64 encoded). Use this to fetch the next page of results.	MTU7MTU7ODk=

Response

Success Response (200)

{
  "status": "ok",
  "next": "NTA7NTA7NDA1MTM5",
  "offset": 0,
  "count": 50,
  "total": 405139,
  "data": [
      {
        "symbol": "GENERIC",
        "date": "2025-12-11T09:49:00Z",
        "title": "Govt hails Faiz Hamid's sentence as 'historic, landmark' for accountability system",
        "sector_code": "",
        "description": "This collage shows Faisal Vawda, Khawaja Asif and Atta Tarar. - Radio Pakistan/Radio Pakistan/X@NAofPakistanVawda says May 9 perpetrators will also face consequences.Nation to face effects of Bajwa...",
        "link": "https://www.geo.tv/latest/638716-govt-hails-faiz-hamids-sentence-as-historic-landmark-for-accountability-system",
        "image": "https://www.geo.tv/assets/uploads/updates/2025-12-11/l_638716_025831_updates.jpg",
        "source": "GEO News",
        "source_url": "https://www.geo.tv"
      },
      {
        "symbol": "GENERIC",
        "date": "2025-12-11T09:36:04Z",
        "title": "K-Electric, PSRM partner to build dedicated grid station in Gharo",
        "sector_code": "",
        "description": "PSRM (Pvt.) Limited and K-Electric have entered into an agreement under which a dedicated distribution system comprising a 132 kV grid station and transmission line will be built at Gharo. \"The...",
        "link": "https://www.brecorder.com/news/40396928/k-electric-psrm-partner-to-build-dedicated-grid-station-in-gharo",
        "image": "https://i.brecorder.com/large/2025/12/111433438866e12.webp",
        "source": "Business Recorder",
        "source_url": "https://www.brecorder.com"
      },
  ]
}

Response Fields

Field	Type	Description
symbol	string	Stock symbol associated with the news
date	string (ISO 8601)	Publication timestamp (server returns RFC3339 format)
title	string	News title
sector_code	string	Sector/industry code for the item
description	string|null	Short description or excerpt (nullable)
link	string	URL to the original or canonical source
image	string|null	Optional URL to an image for the story
source	string	Source or publisher name
source_url	string	Original source URL

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Symbol (200)

{
  "status": "error",
  "message": "No `symbol` specified"
}

Invalid next Cursor (200)

{
  "status": "error",
  "message": "Invalid next cursor provided"
}

Examples

Get Company News

curl -X GET "https://csapis.com/3.0/news/sector?sector_code=GENERIC" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Event-Driven Trading: Monitor company news for trading signals
• Sentiment Analysis: Analyze news sentiment for investment decisions
• Corporate Actions Tracking: Track dividends, mergers, and other corporate events
• Research and Analysis: Gather comprehensive company news for research
• Risk Management: Monitor negative news and reputational risks