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.

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.

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.

The data on analyst ratings includes historical and current analyst ratings as well as forecasts about the future stock prices.

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
            }
        }
    ]
}
				
			

ObjectsDescription
stock_ticker_symbolStock for which you want output
analyst_nameAnalyst name from who you want ratings
analyst_firmAnalyst firm from which you want ratings
analyst_return_rateMinimum return rate of analysts you want output from. (removes analyst with worse returns)
analyst_success_rateMinimum success rate of analysts you want output from. (removes analysts with worse success rate)
date_fromUsed for getting historical ratings in a certain date range
date_toUsed 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.

Try The Data

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.

Sign Up

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.

Contact us
Excel and CSV
If you choose this data format, you will access analyst ratings data through database downloads formatted as either Excel or CSV files.
E-mail link
If you choose this data format, you will receive an email containing a link through which you can download the analyst ratings data.
Pdf Report
If you choose this data format, you will get analyst ratings data in a downloadable PDF report.

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

Javascript, JQuery, VueJS, Angular, JAVA, PHP, NodeJS, Python, Go, Ruby, C#, R, Strest, Rust, Swift and Scala

REST JSON and XML

Data output can be requested in REST Json format or XML format

Excel and CSV

In case you do not want the data through our API, request it in Excel or CSV format.

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