Analyst Ratings API
The analyst ratings API allows customers to retrieve data on historical and current analyst recommendations, consensus estimates and price targets. The database is immediately updated after sell-side analysts have published their revised stock ratings and sales recommendations. Any ratings changes or revisions made by stock experts are available in the API database on analyst ratings. Our data is obtained from leading equity analysts and financial experts who analyze all industries and sectors. Tradefeeds analyst ratings API makes developers able to build applications and internal systems for large customer base including investors, traders, financial analysts, investing firms and many more. The data on historical and current analyst recommendations, consensus estimates and price target is accessible through JSON REST API, and downloadable excel or CSV files.
Analyst Ratings and Recommendations
The database of analysts ratings for stocks including buy, hold and sell is immediately updated when stock analysts release equity research reports on companies operating in various industries and sectors. The changes in analyst recommendations are recorded in the system. However, the database has become an archive of ratings, recommendations and price targets that allows you to track the progress of an individual stock over time. This archive also serves as a way for customers to view the success rate of an individual analyst and use the data to draw conclusions about the value of their rating.
Consensus Estimates
The API database collects stock analysts estimates including revenue and earnings estimates predicted by different equity analysts. The data can be provided separately or published as consensus estimates. Customers can check for accuracy of the predictions when using the data. In this way, they can track which analyst provides more accurate and correct revenue and earnings estimates.
Analyst Stock Price Forecasts
The analyst ratings API allows you to retrieve analyst stock price forecasts in two ways: you either obtain data on forecasts of the entire coverage of stocks prepared by an individual analyst or you choose to get the price forecasts of an individual stock and have all analysts’ forecasts displayed. The data will show in which time frame the forecast is predicted to be reached and will also show a consensus price from all analysts put together. When available, the system will also display a price range or a bull, bear and average case, provided by the analysts.
ready to start?
Get our API key in an instant!
Ranking of an Individual Analyst
Customers retrieve data on the ranking of individual stock analysts through the user-friendly analyst ratings API. They are able to filter the data by individual analyst, individual stock or the combination of the individual analyst and the individual stock. By filtering, they can see the success rate over time of the particular analyst in general or for the specific stock. In addition, customers can compare individual analysts and rank them. By comparing analysts, customers are able to track their failures and successes in ratings. 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, customers may not choose to discredit the analyst entirely. The analyst ranking provides insights about the failures and successes of the ratings of the given analyst. Their work history can be further researched.
Developer Documentation
Analyst Raings API is available in a JSON format. Tradefeeds API also support all API programming languages, which satifies the needs of all our customers. Check the other formats through which you obtain data on analyst ratings and recommendations on stocks. Pay attention to the key filtering parameters as well as input and output response examples
https://data.tradefeeds.com/api/v1/company_ratings
?key=API-KEY
&ticker=TSLA
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"company": "Tesla Motors",
"ticker": "TSLA"
},
"output": {
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "294.02",
"high_pricetarget": "436.00",
"low_pricetarget": "85.00",
"number_pricetarget": "27",
"buy": "19",
"hold": "5",
"sell": "3",
"date": "2022-11-17"
},
"analysts": [
{
"name_analyst": "john-murphy",
"firm": "Bank of America Securities",
"role": "analyst",
"rating": {
"rating_date": "2022-11-14",
"target_date": "2023-11-14",
"price_target": "275.0",
"rating": "Hold",
"change": "maintained"
}
},
{
"name_analyst": "daniel-ives",
"firm": "Wedbush",
"role": "analyst",
"rating": {
"rating_date": "2022-11-09",
"target_date": "2023-11-09",
"price_target": "300.0",
"rating": "Buy",
"change": "maintained"
}
},
{
"name_analyst": "craig-irwin",
"firm": "Roth Capital",
"role": "analyst",
"rating": {
"rating_date": "2022-11-09",
"target_date": "2023-11-09",
"price_target": "85.0",
"rating": "Hold",
"change": "maintained"
}
},
{
"name_analyst": "toni-sacconaghi",
"firm": "Bernstein",
"role": "analyst",
"rating": {
"rating_date": "2022-11-02",
"target_date": "2023-11-02",
"price_target": "150.0",
"rating": "Sell",
"change": "maintained"
}
},
{
"name_analyst": "george-gianarikas",
"firm": "Canaccord Genuity",
"role": "analyst",
"rating": {
"rating_date": "2022-10-25",
"target_date": "2023-10-25",
"price_target": "304.0",
"rating": "Buy",
"change": "maintained"
}
},
{
ETC
https://data.tradefeeds.com/api/v1/analyst_ratings
?key=API-KEY
&name_analyst=Chris-Kotowski
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"name_analyst": "chris-kotowski",
"firm": "Oppenheimer",
"role": "analyst"
},
"output": [
{
"company": "GS",
"ticker": "Goldman Sachs Group",
"rating": {
"rating_date": "2022-10-19",
"target_date": "2023-10-19",
"price_target": "477.0",
"rating": "Buy",
"change": "maintained"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "396.91",
"high_pricetarget": "477.00",
"low_pricetarget": "290.00",
"number_pricetarget": "11",
"buy": "7",
"hold": "3",
"sell": "1",
"date": "2022-11-17"
}
},
{
"company": "MS",
"ticker": "Morgan Stanley",
"rating": {
"rating_date": "2022-10-17",
"target_date": "2023-10-17",
"price_target": "88.0",
"rating": "Buy",
"change": "maintained"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "91.91",
"high_pricetarget": "105.00",
"low_pricetarget": "80.00",
"number_pricetarget": "11",
"buy": "8",
"hold": "3",
"sell": "",
"date": "2022-11-17"
}
},
{
"company": "JPM",
"ticker": "JPMorgan Chase & Co.",
"rating": {
"rating_date": "2022-10-17",
"target_date": "2023-10-17",
"price_target": "154.0",
"rating": "Buy",
"change": "maintained"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "137.83",
"high_pricetarget": "158.00",
"low_pricetarget": "121.00",
"number_pricetarget": "12",
"buy": "8",
"hold": "3",
"sell": "1",
"date": "2022-11-17"
}
},
{
"company": "USB",
"ticker": "U.S. Bancorp",
"rating": {
"rating_date": "2022-10-17",
"target_date": "2023-10-17",
"price_target": "64.0",
"rating": "Buy",
"change": "maintained"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "51.25",
"high_pricetarget": "64.00",
"low_pricetarget": "42.00",
"number_pricetarget": "8",
"buy": "4",
"hold": "4",
"sell": "",
"date": "2022-11-17"
}
},
{
ETC
https://data.tradefeeds.com/api/v1/analyst_ratings
?key=API-KEY
&firm=Oppenheimer
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"firm": "Oppenheimer"
},
"output": [
{
"name_analyst": "bryan-blair",
"firm": "Oppenheimer",
"role": "Analyst",
"ratings": [
[
{
"company": "Evoqua Water Technologies",
"ticker": "AQUA",
"rating": {
"rating_date": "2022-11-16",
"target_date": "2023-11-16",
"price_target": "None",
"rating": "Hold",
"change": "downgraded"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "47.25",
"high_pricetarget": "51.00",
"low_pricetarget": "43.00",
"number_pricetarget": "4",
"buy": "4",
"hold": "",
"sell": "",
"date": "2022-11-17"
}
},
{
"company": "Mueller Water Products",
"ticker": "MWA",
"rating": {
"rating_date": "2022-11-08",
"target_date": "2023-11-08",
"price_target": "None",
"rating": "Hold",
"change": "rated"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "11.25",
"high_pricetarget": "13.00",
"low_pricetarget": "10.00",
"number_pricetarget": "4",
"buy": "",
"hold": "4",
"sell": "",
"date": "2022-11-17"
}
},
{
"company": "ITT Corporation",
"ticker": "ITT",
"rating": {
"rating_date": "2022-11-04",
"target_date": "2023-11-04",
"price_target": "None",
"rating": "Hold",
"change": "reiterated"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "87.75",
"high_pricetarget": "95.00",
"low_pricetarget": "82.00",
"number_pricetarget": "4",
"buy": "4",
"hold": "",
"sell": "",
"date": "2022-11-17"
}
},
{
"company": "Watts Water",
"ticker": "WTS",
"rating": {
"rating_date": "2022-11-04",
"target_date": "2023-11-04",
"price_target": "None",
"rating": "Hold",
"change": "rated"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "145.33",
"high_pricetarget": "155.00",
"low_pricetarget": "138.00",
"number_pricetarget": "3",
"buy": "1",
"hold": "2",
"sell": "",
"date": "2022-11-17"
}
},
{
"company": "SPX Corporation",
"ticker": "SPXC",
"rating": {
"rating_date": "2022-11-03",
"target_date": "2023-11-03",
"price_target": "74.0",
"rating": "Buy",
"change": "reiterated"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "74.00",
"high_pricetarget": "74.00",
"low_pricetarget": "74.00",
"number_pricetarget": "2",
"buy": "2",
"hold": "",
"sell": "",
"date": "2022-11-17"
}
},
{
"company": "Flowserve",
"ticker": "FLS",
"rating": {
"rating_date": "2022-11-01",
"target_date": "2023-11-01",
"price_target": "None",
"rating": "Hold",
"change": "rated"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "29.88",
"high_pricetarget": "33.00",
"low_pricetarget": "23.00",
"number_pricetarget": "8",
"buy": "3",
"hold": "4",
"sell": "1",
"date": "2022-11-17"
}
},
{
ETC
https://data.tradefeeds.com/api/v1/company_ratings?key=API-KEY
&ticker=TSLA
&date_from=2021-01-01
&rating=buy
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"company": "Tesla Motors",
"ticker": "TSLA"
},
"output": {
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "294.02",
"high_pricetarget": "436.00",
"low_pricetarget": "85.00",
"number_pricetarget": "27",
"buy": "19",
"hold": "5",
"sell": "3",
"date": "2022-11-17"
},
"analysts": [
{
"name_analyst": "daniel-ives",
"firm": "Wedbush",
"role": "analyst",
"rating": {
"rating_date": "2022-11-09",
"target_date": "2023-11-09",
"price_target": "300.0",
"rating": "Buy",
"change": "maintained"
}
},
{
"name_analyst": "george-gianarikas",
"firm": "Canaccord Genuity",
"role": "analyst",
"rating": {
"rating_date": "2022-10-25",
"target_date": "2023-10-25",
"price_target": "304.0",
"rating": "Buy",
"change": "maintained"
}
},
{
"name_analyst": "joseph-spak",
"firm": "RBC Capital",
"role": "analyst",
"rating": {
"rating_date": "2022-10-24",
"target_date": "2023-10-24",
"price_target": "325.0",
"rating": "Buy",
"change": "reiterated"
}
},
{
"name_analyst": "alexander-potter",
"firm": "Piper Sandler",
"role": "analyst",
"rating": {
"rating_date": "2022-10-24",
"target_date": "2023-10-24",
"price_target": "340.0",
"rating": "Buy",
"change": "maintained"
}
},
{
"name_analyst": "adam-jonas",
"firm": "Morgan Stanley",
"role": "analyst",
"rating": {
"rating_date": "2022-10-24",
"target_date": "2023-10-24",
"price_target": "330.0",
"rating": "Buy",
"change": "maintained"
}
},
{
"name_analyst": "julie-saussier",
"firm": "Credit Suisse",
"role": "analyst",
"rating": {
"rating_date": "2022-10-21",
"target_date": "2023-10-21",
"price_target": "330.0",
"rating": "Buy",
"change": "maintained"
}
},
{
"name_analyst": "colin-rusch",
"firm": "Oppenheimer",
"role": "analyst",
"rating": {
"rating_date": "2022-10-20",
"target_date": "2023-10-20",
"price_target": "436.0",
"rating": "Buy",
"change": "maintained"
}
},
{
"name_analyst": "mark-delaney",
"firm": "Goldman Sachs",
"role": "analyst",
"rating": {
"rating_date": "2022-10-20",
"target_date": "2023-10-20",
"price_target": "305.0",
"rating": "Buy",
"change": "maintained"
}
},
{
"name_analyst": "rod-lache",
"firm": "Wolfe Research",
"role": "analyst",
"rating": {
"rating_date": "2022-10-20",
"target_date": "2023-10-20",
"price_target": "288.0",
"rating": "Buy",
"change": "maintained"
}
},
{
"name_analyst": "patrick-hummel",
"firm": "UBS",
"role": "analyst",
"rating": {
"rating_date": "2022-10-20",
"target_date": "2023-10-20",
"price_target": "350.0",
"rating": "Buy",
"change": "maintained"
}
},
{
"name_analyst": "emmanuel-rosner",
"firm": "Deutsche Bank",
"role": "analyst",
"rating": {
"rating_date": "2022-10-20",
"target_date": "2023-10-20",
"price_target": "355.0",
"rating": "Buy",
"change": "maintained"
}
},
{
"name_analyst": "ben-kallo",
"firm": "Robert W. Baird",
"role": "analyst",
"rating": {
"rating_date": "2022-10-19",
"target_date": "2023-10-19",
"price_target": "316.0",
"rating": "Buy",
"change": "reiterated"
}
},
{
"name_analyst": "philippe-houchois",
"firm": "Jefferies",
"role": "analyst",
"rating": {
"rating_date": "2022-10-19",
"target_date": "2023-10-19",
"price_target": "350.0",
"rating": "Buy",
"change": "rated"
}
},
{
"name_analyst": "vijay-rakesh",
"firm": "Mizuho Securities",
"role": "analyst",
"rating": {
"rating_date": "2022-10-19",
"target_date": "2023-10-19",
"price_target": "330.0",
"rating": "Buy",
"change": "reiterated"
}
},
{
ETC
https://data.tradefeeds.com/api/v1/analyst_ratings?key=API-KEY
&name_analyst=Chris-Kotowski
&date_from=2021-01-01
&rating=buy
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"name_analyst": "chris-kotowski",
"firm": "Oppenheimer",
"role": "analyst"
},
"output": [
{
"company": "GS",
"ticker": "Goldman Sachs Group",
"rating": {
"rating_date": "2022-10-19",
"target_date": "2023-10-19",
"price_target": "477.0",
"rating": "Buy",
"change": "maintained"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "396.91",
"high_pricetarget": "477.00",
"low_pricetarget": "290.00",
"number_pricetarget": "11",
"buy": "7",
"hold": "3",
"sell": "1",
"date": "2022-11-17"
}
},
{
"company": "MS",
"ticker": "Morgan Stanley",
"rating": {
"rating_date": "2022-10-17",
"target_date": "2023-10-17",
"price_target": "88.0",
"rating": "Buy",
"change": "maintained"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "91.91",
"high_pricetarget": "105.00",
"low_pricetarget": "80.00",
"number_pricetarget": "11",
"buy": "8",
"hold": "3",
"sell": "",
"date": "2022-11-17"
}
},
{
"company": "JPM",
"ticker": "JPMorgan Chase & Co.",
"rating": {
"rating_date": "2022-10-17",
"target_date": "2023-10-17",
"price_target": "154.0",
"rating": "Buy",
"change": "maintained"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "137.83",
"high_pricetarget": "158.00",
"low_pricetarget": "121.00",
"number_pricetarget": "12",
"buy": "8",
"hold": "3",
"sell": "1",
"date": "2022-11-17"
}
},
{
"company": "USB",
"ticker": "U.S. Bancorp",
"rating": {
"rating_date": "2022-10-17",
"target_date": "2023-10-17",
"price_target": "64.0",
"rating": "Buy",
"change": "maintained"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "51.25",
"high_pricetarget": "64.00",
"low_pricetarget": "42.00",
"number_pricetarget": "8",
"buy": "4",
"hold": "4",
"sell": "",
"date": "2022-11-17"
}
},
{
"company": "C",
"ticker": "Citigroup Inc",
"rating": {
"rating_date": "2022-10-17",
"target_date": "2023-10-17",
"price_target": "79.0",
"rating": "Buy",
"change": "maintained"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "54.65",
"high_pricetarget": "79.00",
"low_pricetarget": "37.00",
"number_pricetarget": "13",
"buy": "4",
"hold": "8",
"sell": "1",
"date": "2022-11-17"
}
},
{
"company": "CRBG",
"ticker": "Corebridge Financial, Inc.",
"rating": {
"rating_date": "2022-10-10",
"target_date": "2023-10-10",
"price_target": "30.0",
"rating": "Buy",
"change": "initiatedcoverage"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "25.08",
"high_pricetarget": "30.00",
"low_pricetarget": "23.00",
"number_pricetarget": "12",
"buy": "8",
"hold": "4",
"sell": "",
"date": "2022-11-17"
}
},
{
"company": "BAC",
"ticker": "Bank of America",
"rating": {
"rating_date": "2022-10-05",
"target_date": "2023-10-05",
"price_target": "48.0",
"rating": "Buy",
"change": "maintained"
},
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "40.09",
"high_pricetarget": "48.00",
"low_pricetarget": "28.00",
"number_pricetarget": "11",
"buy": "8",
"hold": "3",
"sell": "",
"date": "2022-11-17"
}
},
{
ETC
https://data.tradefeeds.com/api/v1/consensus_ratings
?key=API-KEY
&ticker=TSLA
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"company": "Tesla Motors",
"ticker": "TSLA"
},
"output": {
"consensus": {
"ratingconsensus": "",
"average_pricetarget": "294.02",
"high_pricetarget": "436.00",
"low_pricetarget": "85.00",
"number_pricetarget": "27",
"buy": "19",
"hold": "5",
"sell": "3",
"date": "2022-11-17"
}
}
}
}
| Objects | Description |
| stock_ticker_symbol | the ticker symbol of the stocks of a company for which you get an output |
| analyst_name | the analyst whose ratings you want to get |
| analyst_firm | the analyst firm whose ratings you want to get |
| date_from | select the date from which you want to get ratings |
| date_to | select the date till which you want to get ratings |