Skip to main content

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

NameTypeRequiredDescriptionExample
sector_codestringYesFilter news by industry/sector code (e.g., 0801). If present the news returned will be filtered by sector as defined in Sectors API .0801
date_fromstringNoStart date for filtering (format: YYYY-MM-DD). When provided the server will include news from this date (inclusive).2023-01-01
date_tostringNoEnd date for filtering (format: YYYY-MM-DD). When provided it is interpreted up to end-of-day on that date.2023-12-31
offsetnumberNoNumber of records to skip for pagination. Page size is fixed at 50, so use multiples of 50 (e.g., 50, 100) to retrieve subsequent pages.50

Response

Success Response (200)

{
"status": "ok",
"next": "NTA7NTA7NDA1MTM5",
"offset": 0,
"count": 50,
"total": 405139,
"data": [
{
"symbol": "ATLH",
"date": "2025-06-30T15:01:28Z",
"title": "Atlas Honda hikes bike prices in Pakistan following new tax imposition",
"sector_code": "0801",
"description": "Atlas Honda Limited, Pakistan`s leading motorcycle manufacturer, has increased the prices of its bikes by Rs2,000 to Rs6,000 per unit, effective July 1, 2025, mainly due to the imposition of a new tax...",
"link": "https://www.brecorder.com/news/40370336/atlas-honda-hikes-bike-prices-in-pakistan-following-new-tax-imposition",
"image": "https://i.brecorder.com/large/2025/06/30195941f48d25b.jpg?r=200129",
"source": "Business Recorder",
"source_url": "https://www.brecorder.com"
},
{
"symbol": "ATLH",
"date": "2025-06-25T03:45:54Z",
"title": "Atlas Honda to launch electric scooter",
"sector_code": "0801",
"description": "KARACHI: Atlas Honda Ltd (AHL) plans to launch an electric scooters specifically designed for Pakistani consumers, following the government`s announcement of the National Electric Vehicle Policy...",
"link": "https://www.dawn.com/news/1919881/atlas-honda-to-launch-electric-scooter",
"image": "https://i.dawn.com/large/2025/06/250843046925d73.gif?r=084554",
"source": "The Dawn News",
"source_url": "https://www.dawn.com"
},
{
"symbol": "ATLH",
"date": "2025-06-24T05:02:50Z",
"title": "National EV Policy: Atlas Honda to launch electric scooter in Pakistan this fiscal year",
"sector_code": "0801",
"description": "Atlas Honda announced on Tuesday of launching an electric scooter tailored for Pakistani consumers in the current fiscal year. As per an official notice sent to the Pakistan Stock Exchange (PSX), the...",
"link": "https://www.brecorder.com/news/40369355/national-ev-policy-atlas-honda-to-launch-electric-scooter-in-pakistan-this-fiscal-year",
"image": "https://i.brecorder.com/large/2025/06/240953556802c2b.jpg?r=095920",
"source": "Business Recorder",
"source_url": "https://www.brecorder.com"
}
]
}

Response Fields

FieldTypeDescription
symbolstringStock symbol associated with the news
datestring (ISO 8601)Publication timestamp (server returns RFC3339 format)
titlestringNews title
sector_codestringSector/industry code for the item
descriptionstring|nullShort description or excerpt (nullable)
linkstringURL to the original or canonical source
imagestring|nullOptional URL to an image for the story
sourcestringSource or publisher name
source_urlstringOriginal source URL

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Sector Code (200)

{
"status": "error",
"message": "No `sector_code` provided"
}

Examples

Get Sector News

curl -X GET "https://csapis.com/3.0/news/sector?sector_code=0801" \
-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