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
`client_id`	integer	No	Client ID to filter ratings for specific client/Organization	`148`
`symbol`	string	No	Stock symbol to filter ratings for specific company	`UBL`

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "id": "507f1f77bcf86cd799439021",
      "client_id": 18,
      "research_id": "507f1f77bcf86cd799439031",
      "symbol": "UBL",
      "sector_name": "Commercial Banks",
      "eps": 25.50,
      "eps_period": "2024-12-31",
      "target": 450.00,
      "target_period": "2025-06-30",
      "position": "Overweight",
      "forward_pe": 12.50,
      "expected_dps": 15.00,
      "action": "Buy",
      "created": "2024-11-15T10:30:00+05:00",
      "modified": "2024-12-08T14:22:00+05:00"
    }
  ]
}

Response Fields

Field	Type	Description
`id`	string	Unique target/rating ID
`client_id`	integer	Client ID
`research_id`	string	Research report ID this rating is based on
`symbol`	string	Stock symbol
`sector_name`	string	Sector name
`eps`	float	Estimated Earnings Per Share
`eps_period`	string	EPS period (YYYY-MM-DD)
`target`	float	Price target value
`target_period`	string	Target price period (YYYY-MM-DD)
`position`	string	Position recommendation (Overweight, Equal-weight, Underweight)
`forward_pe`	float	Forward Price-to-Earnings ratio
`expected_dps`	float	Expected Dividend Per Share
`action`	string	Investment action (Buy, Hold, Sell)
`created`	string (ISO 8601)	Record creation timestamp
`modified`	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​