Analyst Ratings API
Receive an API key immediately and have access to the analyst ratings data right away
Analyst Ratings API: Features
The Analyst Ratings API is available through JSON REST API while the financial database is accessed through downloadable csv or excel files. The data is sourced from analysts and financial experts in all sectors and industries. Finnworlds Analyst Ratings API allows rapid data transfer that makes developers use it intuitively for building systems, platforms and software applications.
Accessible through API
The data is available through JSON REST API and it is instantly updated when the system has processed new sell-side analyst price targets, estimates and recommendations. Any changes in ratings or stock revisions provided by equity analysts are stored in the database making the API up to date.
Downloadable Databases
The Analyst Ratings data is also accessible from the financial database in downloadable excel or CSV files. Notifications on the updates and the maintenance of the database are received via emails or through downloadable links occuring in the customer’s profile on the website.
Historical, Current and Forecasts
The data on analyst ratings includes historical and current analyst ratings as well as forecasts about the future stock prices.
Analyst Ratings
By using the historical data provided by Finnworlds’ system, you can draw conclusions about the quality of an analyst’s ratings and the accuracy of consensus estimates and forecasts. A typical case of checking accuracy of different analysts’ predictions is the comparison between their revenue and stock price forecasts.
Code examples for Analyst Ratings API
https://www.finnworlds.com/api/v1/analystratings
?key=YOUR-KEY&
stock_ticker_symbol=AAPL
{
"status": {
"code": 200,
"message": "Success."
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
},
"output": {
"averageRecommendation": {
"current": "1.33",
"one_month_ago": "1.29",
"two_months_ago": "1.35",
"three_months_ago": "1.35"
},
"strongBuy": {
"current": "18",
"one_month_ago": "19",
"two_months_ago": "20",
"three_months_ago": "20"
},
"hold": {
"current": "2",
"one_month_ago": "2",
"two_months_ago": "3",
"three_months_ago": "3"
},
"strongSell": {
"current": "0",
"one_month_ago": "0",
"two_months_ago": "0",
"three_months_ago": "0"
}
}
]
}
https://www.finnworlds.com/api/v1/analystratings
?key=YOUR-KEY&
stock_ticker_symbol=AAPL,GOOG
{
"status": {
"code": 200,
"message": "Success."
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
},
"output": {
"averageRecommendation": {
"current": "1.33",
"one_month_ago": "1.29",
"two_months_ago": "1.35",
"three_months_ago": "1.35"
},
"strongBuy": {
"current": "18",
"one_month_ago": "19",
"two_months_ago": "20",
"three_months_ago": "20"
},
"hold": {
"current": "2",
"one_month_ago": "2",
"two_months_ago": "3",
"three_months_ago": "3"
},
"strongSell": {
"current": "0",
"one_month_ago": "0",
"two_months_ago": "0",
"three_months_ago": "0"
}
},
{
"basics": {
"name": "Alphabet Inc.",
"stock_ticker_symbol": "GOOG"
"isin_identifier": "US02079K1079"
"exchange": "nasdaq"
},
"output": {
"averageRecommendation": {
"current": "1.21",
"one_month_ago": "1.22",
"two_months_ago": "1.21",
"three_months_ago": "1.15"
},
"strongBuy": {
"current": "24",
"one_month_ago": "22",
"two_months_ago": "23",
"three_months_ago": "23"
},
"hold": {
"current": "1",
"one_month_ago": "1",
"two_months_ago": "1",
"three_months_ago": "0"
},
"strongSell": {
"current": "0",
"one_month_ago": "0",
"two_months_ago": "0",
"three_months_ago": "0"
}
}
]
}
https://www.finnworlds.com/api/v1/analystratings
?key=YOUR-KEY&
analyst_name=Brian Schwartz
{
"status": {
"code": 200,
"message": "Success."
},
"results": [
{
"basics": {
"analyst_name": "Brian Schwartz",
NO EXAMPLE PROVIDED, CONTACT US FOR EXAMPLES
}
}
]
}
https://www.finnworlds.com/api/v1/analystratings
?key=YOUR-KEY&
analyst_firm=JP Morgan
{
"status": {
"message": "Success."
},
"results": [
{
"basics": {
"analyst_firm": "JP Morgan",
NO EXAMPLE PROVIDED, CONTACT US FOR EXAMPLES
}
}
]
}
https://www.finnworlds.com/api/v1/analystratings
?key=YOUR-KEY&
analyst_return_rate=25
{
"status": {
"message": "Success."
},
"results": [
{
"basics": {
"analyst_return_rate": "25",
NO EXAMPLE PROVIDED, CONTACT US FOR EXAMPLES
}
}
]
}
https://www.finnworlds.com/api/v1/analystratings
?key=YOUR-KEY&
analyst_success_rate=25
{
"status": {
"message": "Success."
},
"results": [
{
"basics": {
"analyst_success_rate": "55",
NO EXAMPLE PROVIDED, CONTACT US FOR EXAMPLES
}
}
]
}
https://www.finnworlds.com/api/v1/analystratings
?key=YOUR-KEY&
&date_from=2021:01:01
&date_to=2021:06:01
{
"status": {
"message": "Success."
},
"results": [
{
"basics": {
"date_from": "2021:01:01"
"date_to": "2021:06:01"
NO EXAMPLE PROVIDED, CONTACT US FOR EXAMPLES
}
}
]
}
| Objects | Description |
| stock_ticker_symbol | Stock for which you want output |
| analyst_name | Analyst name from who you want ratings |
| analyst_firm | Analyst firm from which you want ratings |
| analyst_return_rate | Minimum return rate of analysts you want output from. (removes analyst with worse returns) |
| analyst_success_rate | Minimum success rate of analysts you want output from. (removes analysts with worse success rate) |
| date_from | Used for getting historical ratings in a certain date range |
| date_to | Used for getting historical ratings in a certain date range |
Current Analyst Buy Sell Hold Ratings
Classified as buy, sell and hold, the analyst ratings are immediately updated after analysts publish new equity research reports, which are added into our internal system for processing. The changes in the current ratings compared to the previous ratings will be applied to the data available through the analyst ratings API or via downloadable files.
Historical Analyst ratings API
Buy Sell Hold and price consensus
The historical analyst database maintains buy, sell, hold – ratings, recommendations and price targets from analysts for the last 15+ years. It allows customers to track the changes happening to an individual stock over time.The historical analyst ratings data can also be used to follow the success rate of an individual analyst over time and to draw conclusions about the quality of his/her rating.
Analyst Stock Price Forecasts
When it comes to the analyst stock price forecast, customers should know that it is possible to get such data from an individual analyst on his entire portfolio of forecasted stocks. Furthermore, customers are able to choose to obtain data on multiple forecasts of one particular stock made by different analysts. The data on stock price forecasts shows at what time frame the forecast is predicted to be reached and indicates an average consensus price from all analysts. When such data is available, the system will display a price range or a bull, bear and average case, provided by the analysts.
Ranking data about Stock Analysts
The ranking of individual stock analysts is easy and convenient using the analyst ratings API. You are able to filter the data based on an individual analyst, individual stock or the combination of the individual analyst and the individual stock.This way you can see the success rate over time of this analyst in general or for the specific stock. It is also possible to compare analysts and rank them compared to each other and track this over time.
For example an analyst may have had a high ranking in the past but has made some incorrect predictions lately on a specific stock. In this case, you may choose not to completely give up on the analyst.
Analyst consensus for the upcoming financial results
On a monthly and quarterly basis, we gather the recommendations of many analysts and we provide this data as both individual ratings and as consensus. This includes revenue estimates and sales data.
Formats to Download the Data
The analyst ratings data is accessible in three main formats. In this way, Finnworlds fully addresses your needs for data delivery formats. Request your data format and get analyst ratings data instantly. No matter the format of your choice, you obtain analyst ratings data without any differences in the data transfer time. Please, contact support@finnworlds.com for notifying which data format you prefer. You can always change the data delivery format.
Developer Notes
The API for analyst ratings is developed in a way that makes it easy to implement using JSON REST API or using XML representation. We provide examples of code within our SDKs, as well as clear input and output examples. On this page you will find a few examples of HTTP header use and for all other examples and SKDs you can visit the documentation page.
SDKs and Devkits
REST JSON and XML
Excel and CSV
Control the Data
/analystratings&stock_ticker_symbol= GOOG AAPL AMZN TSLA NFLX SQ AMD FB MSFT
stock_ticker_symbol= GOOG AAPL AMZN TSLA NFLX SQ AMD FB MSFT