Company News

Retrieve company related news articles and announcements across the market.

GET/3.0/news/company

Description

This endpoint returns news articles, press releases, and corporate announcements for a specific company. Retrieve targeted news updates for a company by providing the stock symbol, with optional filtering by sector code or 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.	DGKC
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
offset	number	No	Number 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": "DGKC",
            "date": "2025-03-13T00:48:32Z",
            "title": "Equities suffer third straight loss",
            "sector_code": "0804",
            "description": "KARACHI: Concerns about the economic outlook intensified following the announcement of a gas tariff increase for captive power plants (CPPs), which was prompted by the visiting International Monetary...",
            "link": "https://www.dawn.com/news/1897562/equities-suffer-third-straight-loss",
            "image": "https://i.dawn.com/primary/2025/03/67d20b16e629b.jpg",
            "source": "The Dawn News",
            "source_url": "https://www.dawn.com"
        },
        {
            "symbol": "DGKC",
            "date": "2025-02-21T03:16:10Z",
            "title": "Stocks stay buoyant on strong earnings",
            "sector_code": "0804",
            "description": "KARACHI: Despite a contraction in Large-Scale Manufacturing (LSM) during the first half of the current fiscal year, equity investors remained optimistic, helping the market extend gains for the third...",
            "link": "https://www.dawn.com/news/1893323/stocks-stay-buoyant-on-strong-earnings",
            "image": "https://i.dawn.com/large/2025/02/67b7f088d188f.jpg",
            "source": "The Dawn News",
            "source_url": "https://www.dawn.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` provided"
}

Examples

Get Company News

curl -X GET "https://csapis.com/3.0/news/company?symbol=DGKC" \
  -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