Get analyst price targets and the buy-to-sell recommendation consensus for one Indian stock, with one-week to 90-day snapshots.

View all Indian Stock Exchange API endpoints →

Returns analyst target price statistics and recommendation consensus for one Indian listed stock as a single JSON object. The only input is the required query parameter stock_id; the catalog default and probe value is TCS, and the documentation describes it only as the unique identifier of the stock. The response has four sections: priceTarget (the current consensus target), priceTargetSnapshots, recommendation (the current consensus rating) and recommendationSnapshots. Observed in a live probe for stock_id=TCS (HTTP 200): priceTarget had nine members (CurrencyCode, UnverifiedMean, PreliminaryMean, Mean, High, Low, NumberOfEstimates, Median, StandardDeviation) with CurrencyCode INR. priceTargetSnapshots.PriceTargetSnapshot held four entries with Age values OneWeekAgo, ThirtyDaysAgo, SixtyDaysAgo and NinetyDaysAgo, each carrying CurrencyCode, Mean, High, Low, NumberOfEstimates, Median and StandardDeviation. recommendation had Mean, High, Low, NumberOfRecommendations, UnverifiedMean, PreliminaryMean and a Statistics.Statistic list of five rows pairing a Recommendation code from 1 to 5 with NumberOfAnalysts; the five analyst counts added up to NumberOfRecommendations in that probe. recommendationSnapshots.RecommendationSnapshot held the same four Age values, each with Mean, High, Low, NumberOfRecommendations and Statistics. The documented scale reads 1 Buy, 2 Outperform, 3 Hold, 4 Underperform and 5 Sell, so a lower Mean is more bullish, and High is the most bullish code (1) while Low is the most bearish (5). The documentation also describes a 404 body with the text Stock target price not found and a 500 body starting An error occurred; neither was observed in the probe, and only TCS was probed, so the figures in the documentation example and the behaviour for other identifiers are unverified. The data is an informational market snapshot, not investment advice or a licensed feed.

API Features

Consensus target price in INR priceTarget returns CurrencyCode plus Mean, Median, High, Low, StandardDeviation and NumberOfEstimates, so one call shows both the central analyst target and how widely the individual targets are spread.
Target price history in four snapshots priceTargetSnapshots.PriceTargetSnapshot lists OneWeekAgo, ThirtyDaysAgo, SixtyDaysAgo and NinetyDaysAgo entries with the same statistics, which lets a chart show whether the consensus target is rising or falling.
Mean rating on a 1 to 5 scale recommendation.Mean condenses all analyst ratings into one number on the documented Buy, Outperform, Hold, Underperform, Sell scale, where a lower value is more bullish and High and Low mark the extremes.
Analyst head count for every rating recommendation.Statistics.Statistic gives a NumberOfAnalysts value for each Recommendation code from 1 to 5, so a client can draw a rating distribution bar instead of relying on the mean alone.
Rating drift with matching snapshots recommendationSnapshots.RecommendationSnapshot repeats Mean, High, Low, NumberOfRecommendations and Statistics for each Age, giving a direct comparison between the current consensus and earlier readings.
One required stock_id input The request needs only stock_id, with TCS as the catalog default, and returns all four sections together, so there is no second call to assemble target price and rating for the same company.

Live API Demo

GET /api/project/indian-stock-exchange-api/analyst-recommendations

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/indian-stock-exchange-api/analyst-recommendations?key=<API_KEY>&stock_id=TCS'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

What does the stock_id parameter accept?

stock_id is required. The catalog default is TCS, which returned HTTP 200 in a probe, and the documentation describes it only as the unique identifier of the stock. It does not list other accepted forms such as company names, BSE scrip codes or other ticker codes, so test any other identifier yourself before building on it.

How do I read the recommendation Mean value?

The documentation maps 1 to Buy, 2 to Outperform, 3 to Hold, 4 to Underperform and 5 to Sell. A lower Mean therefore means a more bullish consensus. In the probe, High was 1 and Low was 5, so High refers to the most bullish rating code and Low to the most bearish one, not to numeric size.

Which snapshots does the response include?

The current consensus sits in priceTarget and recommendation. In the probe, priceTargetSnapshots.PriceTargetSnapshot and recommendationSnapshots.RecommendationSnapshot each held four entries with Age set to OneWeekAgo, ThirtyDaysAgo, SixtyDaysAgo and NinetyDaysAgo. The documentation also mentions a current-week entry, but the probe showed the current reading only in the top-level objects.

What does the Statistics list in the recommendation contain?

Statistics.Statistic is a list of five rows, each with a Recommendation code from 1 to 5 and the NumberOfAnalysts who gave that rating. In the probe the five counts added up to NumberOfRecommendations, so you can compute percentages per rating directly from the list.

Which currency are the target prices in, and are they guaranteed numeric?

The probe returned CurrencyCode INR in priceTarget and in each snapshot, with Mean, High, Low, Median and StandardDeviation as JSON numbers. The documentation shows the same layout. Rely on CurrencyCode rather than assuming a currency, and handle a missing field defensively because only one stock was probed.

What errors can this endpoint return?

The documentation lists a 404 response with the message Stock target price not found and a 500 response whose message begins An error occurred. Neither was seen in the probe, which only tested TCS. Check the HTTP status in your client and treat a 404 as no target price data for that identifier rather than as a transport failure.

Is this investment advice or a live feed?

No. The response is an informational snapshot of analyst consensus, and the documentation does not state how often it refreshes. Use it for dashboards, research notes and bots, and do not treat it as advice or as a licensed, tick-level data source.

Where can I find EPS and other analyst estimates for the same company?

This endpoint covers target price and recommendation consensus only. Earnings per share, dividend per share and return on equity estimates, with actuals and revision ages, are served by the stock forecasts endpoint in this catalog, and the stock data by name endpoint also returns an analystView block.

Related operations

Guides

View Subscription Plans →