Analyst Ratings

Retrieve analyst ratings, price targets, and investment recommendations for stocks.

GET/3.0/research/targets

Description

This endpoint returns analyst price targets, investment actions (Buy/Hold/Sell), and related metrics for stocks. It provides consensus views on stock valuations and includes details like EPS estimates, forward PE ratios, and expected dividends per share.

Request

Authentication

Type: Bearer Token
Required: Yes

Parameters

Name	Type	Required	Description	Example
`cid`	integer	No	Client ID to filter ratings for specific client	`18`
`symbol`	string	No	Stock symbol to filter ratings for specific company	`UBL`
`research_id`	string	No	Research ID	`507f1f77bcf86cd799439031`

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "id": "507f1f77bcf86cd799439021",
      "ref": "507f1f77bcf86cd799439011",
      "cid": 18,
      "uid": 1001,
      "rid": "507f1f77bcf86cd799439031",
      "sym": "UBL",
      "sc": "BANK",
      "sn": "Commercial Banks",
      "eps": 25.50,
      "epsp": "2024-12-31",
      "tgt": 450.00,
      "tgtp": "2025-06-30",
      "pos": "Overweight",
      "fpe": 12.50,
      "edps": 15.00,
      "act": "Buy",
      "crt": "2024-11-15T10:30:00+05:00",
      "mod": "2024-12-08T14:22:00+05:00"
    }
  ]
}

Response Fields

Field	Type	Description
`id`	string	Unique target/rating ID
`ref`	string	Reference ID (analyst ID or research ID)
`cid`	integer	Client ID
`uid`	integer	User ID (analyst user ID)
`rid`	string	Research report ID this rating is based on
`sym`	string	Stock symbol
`sc`	string	Sector code
`sn`	string	Sector name
`eps`	float	Estimated Earnings Per Share
`epsp`	string	EPS period (YYYY-MM-DD)
`tgt`	float	Price target value
`tgtp`	string	Target price period (YYYY-MM-DD)
`pos`	string	Position recommendation (Overweight, Equal-weight, Underweight)
`fpe`	float	Forward Price-to-Earnings ratio
`edps`	float	Expected Dividend Per Share
`act`	string	Investment action (Buy, Hold, Sell)
`crt`	string (ISO 8601)	Record creation timestamp
`mod`	string (ISO 8601)	Record last modified timestamp

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get All Analyst Ratings

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

Use Cases

Investment Decision Support: Use analyst ratings and targets to inform buy/hold/sell decisions
Valuation Analysis: Compare analyst price targets with current market price
Earnings Tracking: Monitor consensus EPS estimates and forecast updates
Consensus Building: Track analyst sentiment across different experts
Portfolio Management: Identify stocks with positive/negative analyst coverage
Research Attribution: Understand which analysts are covering specific stocks

Description​

Request​

Authentication​

Parameters​

Response​

Success Response (200)​

Response Fields​

Error Responses​

Examples​

Get All Analyst Ratings​

Use Cases​