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
`sector_code`	string	No	Sector code to filter reports (see Sectors for available codes)	`0801`
`date_range`	string	No	Date range 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": "685ea7ca720f2c38da2c2bb3",
            "category_ids": [
                "6523c4b376022da50d4fe538"
            ],
            "analyst_ids": [
                "6523c4b376022da50d4fe535"
            ],
            "symbol": null,
            "sector": null,
            "tags": null,
            "title": "JS Daily Highlights - SBP Forex reserves and Oil & Gas  discovery update",
            "description": "",
            "thumbnail": "148/685ea7ca720f2c38da2c2bb3.webp",
            "created": "2025-06-27T14:16:42.04Z",
            "modified": "2025-06-27T14:16:44.158Z"
        },
        {
            "id": "685e44512c4bf9b6397f2188",
            "category_ids": [
                "6523c4b376022da50d4fe537"
            ],
            "analyst_ids": [
                "6511241f528f5a5108e07563"
            ],
            "symbol": [
                "AGTL"
            ],
            "sector": [
                "0801"
            ],
            "tags": null,
            "title": "AGTL: Agriculture slowdown weighs on volumes",
            "description": "",
            "thumbnail": "148/685e44512c4bf9b6397f2188.webp",
            "created": "2025-06-27T07:12:17.818Z",
            "modified": "2025-06-27T07:12:19.37Z"
        }
    ]
}

Response Fields

Field	Type	Description
`id`	string	Research report unique ID
`category_ids`	array	Category IDs this report belongs to
`analyst_ids`	array	Analyst IDs who authored the report
`symbol`	array\|null	Stock symbols covered in the report (nullable)
`sector`	array\|null	Sector codes covered (nullable)
`tags`	array\|null	Report tags for classification (nullable)
`title`	string	Report title
`description`	string	Report description
`thumbnail`	string	Relative storage path to the report thumbnail (pass to the View Research Thumbnails endpoint)
`created`	string (ISO 8601)	Report creation timestamp
`modified`	string (ISO 8601)	Report last modified timestamp

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​