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.  The data is sourced from analysts and financial experts in all sectors and industries. Finnworlds provides both Analyst Consensus data and Analyst Ratings data through the API. It allows instant data transfer and 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.

You can query historical and current consensus ratings as well as individual analyst ratings data with the API. 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. 

How many API calls?

Starter

25.000 calls
40 calls/min

Developers

85.000 calls
120 calls/min

Enterprise

200.000 calls
300 calls/min

Individual

10.000 calls
15 calls/min


 
 
 
 
 
 
 
 
 
 

Starter

Includes

(Other APIs coming soon!)

$199

$19,-

The discounted price is for the initial month, allowing developers to test and implement the API without being charged the full price. The subscription is automatically renewed each month at the normal rate of 199$ for the Starter package. In case the API is not what you are looking for, you can cancel 10 days before renewal by emailing to support@finnworlds.com. If you have questions about our premium monthly subscription packages, contact support@finnworlds.com.

Also see our Cancellation Policy and Terms and Conditions.

Developers

Includes

(Other APIs coming soon!)

$499

$49,-

The discounted price is for the initial month, allowing developers to test and implement the API without being charged the full price. The subscription is automatically renewed each month at the normal rate of 499$ for the Developers package. In case the API is not what you are looking for, you can cancel 10 days before renewal by emailing to support@finnworlds.com. If you have questions about our premium monthly subscription packages, contact support@finnworlds.com.

Also see our Cancellation Policy and Terms and Conditions.

Enterprise

Includes

(Other APIs coming soon!)

$1000

$99,-

The discounted price is for the initial month, allowing developers to test and implement the API without being charged the full price. The subscription is automatically renewed each month at the normal rate of 1000$ for the Enterprise package. In case the API is not what you are looking for, you can cancel 10 days before renewal by emailing to support@finnworlds.com. If you have questions about our premium monthly subscription packages, contact support@finnworlds.com.

Also see our Cancellation Policy and Terms and Conditions.

Individual

Includes

(Other APIs coming soon!)

$99

$9,-

The discounted price is for the initial month, allowing developers to test and implement the API without being charged the full price. The subscription is automatically renewed each month at the normal rate of 99$ for the Individual package. In case the API is not what you are looking for, you can cancel 10 days before renewal by emailing to support@finnworlds.com. If you have questions about our premium monthly subscription packages, contact support@finnworlds.com.

Also see our Cancellation Policy and Terms and Conditions.

Code examples of Analyst API

Code examples of Analyst API

				
					https://api.finnworlds.com/api/v1/companyratings
    ?key=API-KEY
        &company_ticker=AAPL
{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "basics": {
            "company_name": "Apple Inc",
            "company_ticker": "AAPL"
        },
        "output": {
            "analyst_consensus": {
                "consensus_conclusion": "",
                "analyst_average": "181.65",
                "analyst_highest": "220.00",
                "analyst_lowest": "136.00",
                "analysts_number": "28",
                "buy": "22",
                "hold": "5",
                "sell": "1",
                "consensus_date": "2022-10-18"
            },
            "analysts": [
                {
                    "analyst_name": "ivan-feinseth",
                    "analyst_firm": "Tigress Financial",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-10-04T00:00:00",
                        "price_target": "210.0",
                        "target_date": "2023-10-04",
                        "rated": "Buy",
                        "conclusion": "reiterated",
                    }
                },
                {
                    "analyst_name": "samik-chatterjee",
                    "analyst_firm": "J.P. Morgan",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-10-03",
                        "price_target": "None",
                        "target_date": "2023-10-03",
                        "rated": "Buy",
                        "conclusion": "maintained",
                    }
                },
                {
                    "analyst_name": "erik-woodring",
                    "analyst_firm": "Morgan Stanley",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-10-03",
                        "price_target": "180.0",
                        "target_date": "2023-10-03",
                        "rated": "Buy",
                        "conclusion": "maintained",
                    }
                },
                {
                    "analyst_name": "angelo-zino",
                    "analyst_firm": "CFRA",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-10-01",
                        "price_target": "175.0",
                        "target_date": "2023-10-01",
                        "rated": "Buy",
                        "conclusion": "maintained",
                    }
                },
                
                ETC
				
			

				
					https://api.finnworlds.com/api/v1/companyratings
    ?key=API-KEY
        &ticker=AAPL
            &date_from=2020-01-10
                &rated=buy
{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "basics": {
            "company_name": "Apple Inc",
            "company_ticker": "AAPL"
        },
        "output": {
            "analyst_consensus": {
                "consensus_conclusion": "",
                "analyst_average": "181.65",
                "analyst_highest": "220.00",
                "analyst_lowest": "136.00",
                "analysts_number": "28",
                "buy": "22",
                "hold": "5",
                "sell": "1",
                "consensus_date": "2022-10-18"
            },
            "analysts": [
                {
                    "analyst_name": "ivan-feinseth",
                    "analyst_firm": "Tigress Financial",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-10-04",
                        "price_target": "210.0",
                        "target_date": "2023-10-04",
                        "rated": "Buy",
                        "conclusion": "reiterated",
                    }
                },
                {
                    "analyst_name": "samik-chatterjee",
                    "analyst_firm": "J.P. Morgan",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-10-03",
                        "price_target": "None",
                        "target_date": "2023-10-03",
                        "rated": "Buy",
                        "conclusion": "maintained",
                    }
                },
                {
                    "analyst_name": "erik-woodring",
                    "analyst_firm": "Morgan Stanley",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-10-03",
                        "price_target": "180.0",
                        "target_date": "2023-10-03",
                        "rated": "Buy",
                        "conclusion": "maintained",
                    }
                },
                {
                    "analyst_name": "angelo-zino",
                    "analyst_firm": "CFRA",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-10-01",
                        "price_target": "175.0",
                        "target_date": "2023-10-01",
                        "rated": "Buy",
                        "conclusion": "maintained",
                    }
                },
                {
                    "analyst_name": "barton-crockett",
                    "analyst_firm": "Rosenblatt Securities",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-09-29",
                        "price_target": "189.0",
                        "target_date": "2023-09-29",
                        "rated": "Buy",
                        "conclusion": "upgraded",

                    }
                },
                {
                    "analyst_name": "david-vogt",
                    "analyst_firm": "UBS",
                    "analyst_role": "analyst",
                    "rating": {
                        "date_rating": "2022-09-29",
                        "price_target": "185.0",
                        "target_date": "2023-09-29",
                        "rated": "Buy",
                        "conclusion": "maintained",
                    }
                },
				
			

				
					https://api.finnworlds.com/api/v1/analystratings
    ?key=API-KEY
        &analyst_name=daniel-ives
{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "basics": {
            "analyst_name": "daniel-ives",
            "analyst_firm": "Wedbush",
            "analyst_role": "analyst"
        },
        "output": [
            {
                "company_name": "TWTR",
                "company_ticker": "Twitter Inc",
                "analyst_consensus": {
                    "consensus_conclusion": "",
                    "analyst_average": "45.27",
                    "analyst_highest": "54.20",
                    "analyst_lowest": "22.00",
                    "analysts_number": "11",
                    "buy": "",
                    "hold": "11",
                    "sell": "",
                    "consensus_date": "2022-10-18"
                },
                "rating": {
                    "date_rating": "2022-10-05",
                    "price_target": "54.2",
                    "target_date": "2023-10-05",
                    "rated": "Hold",
                    "conclusion": "rated",
                }
            },
            {
                "company_name": "TSLA",
                "company_ticker": "Tesla Motors",
                "analyst_consensus": {
                    "consensus_conclusion": "",
                    "analyst_average": "306.97",
                    "analyst_highest": "400.00",
                    "analyst_lowest": "73.00",
                    "analysts_number": "27",
                    "buy": "18",
                    "hold": "5",
                    "sell": "4",
                    "consensus_date": "2022-10-18"
                },
                "rating": {
                    "date_rating": "2022-10-02",
                    "price_target": "360.0",
                    "target_date": "2023-10-02",
                    "rated": "Buy",
                    "conclusion": "maintained",
                }
            },
            {
                "company_name": "AAPL",
                "company_ticker": "Apple Inc",
                "analyst_consensus": {
                    "consensus_conclusion": "",
                    "analyst_average": "181.65",
                    "analyst_highest": "220.00",
                    "analyst_lowest": "136.00",
                    "analysts_number": "28",
                    "buy": "22",
                    "hold": "5",
                    "sell": "1",
                    "consensus_date": "2022-10-18"
                },
                "rating": {
                    "date_rating": "2022-09-28",
                    "price_target": "220.0",
                    "target_date": "2023-09-28",
                    "rated": "Buy",
                    "conclusion": "maintained",
                }
            },
            {
                "company_name": "GM",
                "company_ticker": "General Motors Company",
                "analyst_consensus": {
                    "consensus_conclusion": "",
                    "analyst_average": "53.29",
                    "analyst_highest": "90.00",
                    "analyst_lowest": "30.00",
                    "analysts_number": "14",
                    "buy": "10",
                    "hold": "4",
                    "sell": "",
                    "consensus_date": "2022-10-18"
                },
                "rating": {
                    "date_rating": "2022-09-22",
                    "price_target": "42.0",
                    "target_date": "2023-09-22",
                    "rated": "Buy",
                    "conclusion": "maintained",
                }
            },
            {
                "company_name": "LICY",
                "company_ticker": "Li-Cycle Holdings Corp.",
                "analyst_consensus": {
                    "consensus_conclusion": "",
                    "analyst_average": "9.38",
                    "analyst_highest": "13.00",
                    "analyst_lowest": "7.00",
                    "analysts_number": "8",
                    "buy": "6",
                    "hold": "2",
                    "sell": "",
                    "consensus_date": "2022-10-18"
                },
                "rating": {
                    "date_rating": "2022-09-15",
                    "price_target": "9.0",
                    "target_date": "2023-09-15",
                    "rated": "Buy",
                    "conclusion": "maintained",
                }
            },
            
            ETC
				
			

				
					https://api.finnworlds.com/api/v1/analystratings
    ?key=API-KEY
        &analyst_firm=wedbush


{
    "status": {
        "message": "Success."
    },
    "results": [
        {
        "basics": {
            "analyst_firm": "JP Morgan",
            NO EXAMPLE PROVIDED, CONTACT US FOR EXAMPLES
            }
        }
    ]
}
				
			

				
					https://api.finnworlds.com/api/v1/analystratings
    ?key=API-KEY
        &analyst_name=daniel-ives
            &date_from=2020-01-10
            &date_to=2021-01-10

{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "basics": {
            "analyst_name": "daniel-ives",
            "analyst_firm": "Wedbush",
            "analyst_role": "analyst"
        },
        "output": [
            {
                "company_name": "BNFT",
                "company_ticker": "Benefitfocus Inc",
                "analyst_consensus": {
                    "consensus_conclusion": "",
                    "analyst_average": "6.00",
                    "analyst_highest": "6.00",
                    "analyst_lowest": "6.00",
                    "analysts_number": "1",
                    "buy": "",
                    "hold": "1",
                    "sell": "",
                    "consensus_date": "2022-10-18"
                },
                "rating": {
                    "date_rating": "2020-03-04",
                    "price_target": "22.0",
                    "target_date": "2021-03-04",
                    "rated": "Buy",
                    "conclusion": "maintained",
                }
            },
            {
                "company_name": "CTXS",
                "company_ticker": "Citrix Systems",
                "analyst_consensus": {
                    "consensus_conclusion": "",
                    "analyst_average": "",
                    "analyst_highest": "",
                    "analyst_lowest": "",
                    "analysts_number": "",
                    "buy": "",
                    "hold": "",
                    "sell": "",
                    "consensus_date": ""
                },
                "rating": {
                    "date_rating": "2020-04-24",
                    "price_target": "135.0",
                    "target_date": "2021-04-24",
                    "rated": "Hold",
                    "conclusion": "maintained",
                }
            },
            {
                "company_name": "NLOK",
                "company_ticker": "Nortonlifelock Inc.",
                "analyst_consensus": {
                    "consensus_conclusion": "",
                    "analyst_average": "28.50",
                    "analyst_highest": "29.00",
                    "analyst_lowest": "28.00",
                    "analysts_number": "2",
                    "buy": "1",
                    "hold": "1",
                    "sell": "",
                    "consensus_date": "2022-10-18"
                },
                "rating": {
                    "date_rating": "2020-05-15",
                    "price_target": "23.0",
                    "target_date": "2021-05-15",
                    "rated": "Hold",
                    "conclusion": "maintained",
                }
            },
            {
                "company_name": "MNDT",
                "company_ticker": "Mandiant, Inc.",
                "analyst_consensus": {
                    "consensus_conclusion": "",
                    "analyst_average": "",
                    "analyst_highest": "",
                    "analyst_lowest": "",
                    "analysts_number": "",
                    "buy": "",
                    "hold": "",
                    "sell": "",
                    "consensus_date": ""
                },
                "rating": {
                    "date_rating": "2020-07-29",
                    "price_target": "15.0",
                    "target_date": "2021-07-29",
                    "rated": "Hold",
                    "conclusion": "maintained",
                }
            },
            {
                "company_name": "CLDR",
                "company_ticker": "Cloudera",
                "analyst_consensus": {
                    "consensus_conclusion": "",
                    "analyst_average": "",
                    "analyst_highest": "",
                    "analyst_lowest": "",
                    "analysts_number": "",
                    "buy": "",
                    "hold": "",
                    "sell": "",
                    "consensus_date": ""
                },
                "rating": {
                    "date_rating": "2020-09-03",
                    "price_target": "16.0",
                    "target_date": "2021-09-03",
                    "rated": "Hold",
                    "conclusion": "maintained",
                }
            },
            {
                "company_name": "VMW",
                "company_ticker": "VMware Inc",
                "analyst_consensus": {
                    "consensus_conclusion": "",
                    "analyst_average": "138.83",
                    "analyst_highest": "142.50",
                    "analyst_lowest": "136.00",
                    "analysts_number": "3",
                    "buy": "1",
                    "hold": "2",
                    "sell": "",
                    "consensus_date": "2022-10-18"
                },
                "rating": {
                    "date_rating": "2020-11-25",
                    "price_target": "175.0",
                    "target_date": "2021-11-25",
                    "rated": "Buy",
                    "conclusion": "maintained",
                }
            },
            
            ETC
				
			

				
					https://api.finnworlds.com/api/v1/consensusratings
    ?key=API-KEY
        &ticker=AAPL
{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "basics": {
            "company_name": "Apple Inc",
            "company_ticker": "AAPL"
        },
        "output": {
            "analyst_consensus": {
                "consensus_conclusion": "",
                "analyst_average": "181.65",
                "analyst_highest": "220.00",
                "analyst_lowest": "136.00",
                "analysts_number": "28",
                "buy": "22",
                "hold": "5",
                "sell": "1",
                "consensus_date": "2022-10-18"
            }
        }
    }
}
				
			

Objects Description
company_ticker Stock for which you want output
analyst_name Analyst name from who you want ratings
analyst_firm Analyst firm from which you want ratings
rated In case you want to filter on buy, sell or hold
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.

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.

Analyst Ratings API - Get started!

All sounds good to start? Choose a subscription plan on the button below and receive your API key to your email address immediately. Benefit from the trial rates. Upgrade, downgrade or cancel your plan anytime. Start getting analyst ratings data within a minute!

For any questions, feel free to contact the team.

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