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.
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.
Consensus & Individual Analyst ratings
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

Includes
- 25.000 API calls
- 40 calls / minute
- Analyst Ratings
- Analyst Consensus
- Commodity Prices
- Bond Yields
- Stock Index
(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
- 85.000 API calls
- 120 calls / minute
- Analyst Ratings
- Analyst Consensus
- Commodity Prices
- Bond Yields
- Stock Index
(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
- 200.000 API calls
- 300 calls / minute
- Analyst Ratings
- Analyst Consensus
- Commodity Prices
- Bond Yields
- Stock Index
(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
- 10.000 API calls
- 15 calls / minute
- Analyst Ratings
- Analyst Consensus
- Commodity Prices
- Bond Yields
- Stock Index
(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
- /companyratings?key=KEY&company_ticker=AAPL
- &date_from=2020-01-10&rated=buy
- /analystratings?key=KEY&analyst_name=daniel-ives
- /analystratings?key=KEY&analyst_firm=jp-morgan
- &date_from=2020-01-10&date_to=2021-01-10
- /consensusratings?key=KEY&company_ticker=AAPL
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.

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
Excel and CSV
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