Sector Reports

Retrieve research reports focused on specific market sectors and industry analysis.

GET/3.0/research/sector-reports

Description

This endpoint returns research reports that analyze specific market sectors, including sector dynamics, competitive landscape, regulatory environment, and investment opportunities within sectors.

Request

Authentication

Type: Bearer Token
Required: Yes

Parameters

Name	Type	Required	Description	Example
`symbol`	string	No	Stock symbol to filter company reports	`UBL`
`date_range`	string	No	Start date for filtering (format: `YYYY-MM-DD:YYYY-MM-DD`)	`2024-01-01:2024-12-31`
`offset`	integer	No	Number of records to skip for pagination	`0`
`count`	integer	No	Maximum number of records to return (default: 50)	`25`

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "count": 2,
  "offset": 0,
  "total": 8,
  "data": [
    {
      "id": "64ad34123c85e1d1d902c9ca",
      "ref": 201,
      "cid": 18,
      "uid": 1001,
      "cat_ids": ["64ad34123c85e1d1d902c9a2"],
      "an_ids": ["507f1f77bcf86cd799439011"],
      "sy": ["UBL", "MCB", "HBL", "BAFL"],
      "sc": ["BANK"],
      "ic": ["KSE-100"],
      "tags": ["sector-analysis", "npl-trends", "interest-rates"],
      "ty": "Sector Analysis",
      "tt": "Banking Sector: NIM Compression and Credit Quality Analysis FY2024",
      "dsc": "Comprehensive analysis of Pakistan's banking sector including net interest margin trends, credit quality metrics, regulatory changes, and earnings outlook for major banks.",
      "str": "Sector Comparative Analysis",
      "np": 20,
      "thm": "https://assets.csapis.com/research/64ad34123c85e1d1d902c9ca/thumbnail.jpg",
      "file": "https://assets.csapis.com/research/64ad34123c85e1d1d902c9ca/report.pdf",
      "vid": null,
      "crt": "2024-11-28T09:45:00+05:00",
      "mod": "2024-11-28T09:45:00+05:00",
      "cats": [
        {
          "id": "64ad34123c85e1d1d902c9a2",
          "ref": 52,
          "cid": 18,
          "name": "Sector Analysis",
          "rows": 12,
          "crt": "2024-01-01T00:00:00+05:00",
          "mod": "2024-01-01T00:00:00+05:00"
        }
      ]
    }
  ]
}

Response Fields

Same as Company Reports. See Company Reports documentation for field descriptions.

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get All Sector Reports

curl -X GET "https://csapis.com/3.0/research/sector-reports" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

Sector Analysis: Understand sector dynamics and trends
Comparative Analysis: Compare companies within a sector
Industry Outlook: Review industry-wide opportunities and risks
Portfolio Allocation: Make sector allocation decisions
Macro Analysis: Study sector-level economic indicators

Description​

Request​

Authentication​

Parameters​

Response​

Success Response (200)​

Response Fields​

Error Responses​

Examples​

Get All Sector Reports​

Use Cases​