Yahoo Finance Analyst API
Ratings, upgrades, downgrades and price targets for one ticker.
GET /v1/yahoo-finance/instruments/{symbol}/analyst1 credit Failed requests are free
About this endpoint
GET /v1/yahoo-finance/instruments/{symbol}/analyst returns data.recommendationTrend, data.upgradeDowngradeHistory, data.financialData and data.insights. The trend rows carry period, strongBuy, buy, hold, sell and strongSell. Upgrade and downgrade rows carry firm, toGrade, fromGrade, action and epochGradeDate as an ISO 8601 UTC time. The financial data section carries targetMeanPrice, targetHighPrice, targetLowPrice, targetMedianPrice, numberOfAnalystOpinions, recommendationMean and recommendationKey.
data.insights is the recommendation record (targetPrice, provider, rating) from the insights route, when available. It can be null while the rest of the response is found. Analyst research-report metadata is available on the insights route.
Yahoo Finance Analyst API FAQ
What does the recommendation trend show?
One row per period with the count of strongBuy, buy, hold, sell and strongSell ratings, so you can see how the analyst mix changed over time.
Where are the price targets?
In data.financialData: targetMeanPrice, targetHighPrice, targetLowPrice, targetMedianPrice and numberOfAnalystOpinions, when available.
What is in data.insights?
The recommendation record from the insights route, with the rating, provider and target when available. It is null if that optional call did not answer.
How many credits does this route cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Other Yahoo Finance endpoints
- InstrumentGET /v1/yahoo-finance/instruments/{symbol}
- QuotesGET /v1/yahoo-finance/quotes
- ChartGET /v1/yahoo-finance/instruments/{symbol}/chart
- ProfileGET /v1/yahoo-finance/instruments/{symbol}/profile
- StatisticsGET /v1/yahoo-finance/instruments/{symbol}/statistics
- FinancialsGET /v1/yahoo-finance/instruments/{symbol}/financials
- FundamentalsGET /v1/yahoo-finance/instruments/{symbol}/fundamentals
- EarningsGET /v1/yahoo-finance/instruments/{symbol}/earnings