With three endpoints, this API covers analyst-specific ratings, company-wide consensus ratings, and detailed earnings & revenue estimates based on consensus. It is designed for fintech platforms, portfolio trackers, and academic research that rely on professional equity research insights.
This analyst ratings API ensures you can capture up-to-date recommendations, forward-looking EPS and revenue expectations, and compare real vs estimated performance over time.
– Displaying analyst recommendations on company profile pages
– Aggregating consensus buy/hold/sell ratings across multiple firms
– Backtesting analyst forecast accuracy for research purposes
– Building financial models that incorporate forward EPS & revenue estimates
- Analyst Ratings by Name – Retrieve ratings, target prices, and conclusions (upgrade, downgrade, maintained) from a specific analyst.
- Company-Wide Coverage – Get the latest recommendations for all analysts covering a given ticker.
- Earnings & Revenue Estimates – Consensus forecasts across quarters and years, including high/low ranges and growth percentages.
- Earnings History – Compare estimated EPS vs actual EPS to track forecast accuracy.
- Firm & Role Metadata – Includes analyst firm, role, and detailed rating context.
Get started by getting your API key on Finnworlds website. Looking for academic or non-profit use? Send us an email to start the conversation.
- JSON rest API
- Excel CSV download
- PDF reports
- Email link
1. Analyst Ratings Data by Analyst Name
https://api.finnworlds.com/api/v1/analystratings?key=APIKEY&analyst_name=Chris-Kotowski
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"company_name": "Microsoft",
"ticker": "MSFT"
},
"analysts": [
{
"analyst_name": "Mark Murphy",
"analyst_firm": "J.P. Morgan",
"analyst_role": "analyst",
"rating": {
"date_rating": "2025-05-13",
"target_date": "2026-05-13",
"price_target": "475.0",
"rated": "Buy",
"conclusion": "maintained"
}
},
{
"analyst_name": "Karl Keirstead",
"analyst_firm": "UBS",
"analyst_role": "analyst",
"rating": {
"date_rating": "2025-05-05",
"target_date": "2026-05-05",
"price_target": "500.0",
"rated": "Buy",
"conclusion": "maintained"
}
}
2. Analyst Ratings Data by Company Ticker
https://api.finnworlds.com/api/v1/companyratings?key=APIKEY&ticker=MSFT
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"company_name": "Microsoft",
"ticker": "MSFT"
},
"analysts": [
{
"analyst_name": "Mark Murphy",
"analyst_firm": "J.P. Morgan",
"analyst_role": "analyst",
"rating": {
"date_rating": "2025-05-13",
"target_date": "2026-05-13",
"price_target": "475.0",
"rated": "Buy",
"conclusion": "maintained"
}
},
{
"analyst_name": "Karl Keirstead",
"analyst_firm": "UBS",
"analyst_role": "analyst",
"rating": {
"date_rating": "2025-05-05",
"target_date": "2026-05-05",
"price_target": "500.0",
"rated": "Buy",
"conclusion": "maintained"
}
}
]
}
}
3. Consensus Ratings Data by Company Ticker
https://api.finnworlds.com/api/v1/consensusratings?key=APIKEY&ticker=AAPL
{
"status": {
"code": 200,
"message": "OK",
"details": ""
},
"result": {
"basics": {
"ticker": "AAPL"
},
"output": {
"earnings_estimate": {
"previous_quarter": {
"analysts_number": "29",
"average_estimate": "1.42",
"low_estimate": "1.32",
"high_estimate": "1.47",
"last_year_eps": "1.4",
"date": "quarter2_25"
},
"current_quarter": {
"analysts_number": "26",
"average_estimate": "1.76",
"low_estimate": "1.63",
"high_estimate": "1.82",
"last_year_eps": "0.97",
"date": "quarter3_25"
},
"next_quarter": {
"analysts_number": "22",
"average_estimate": "2.47",
"low_estimate": "2.29",
"high_estimate": "2.68",
"last_year_eps": "2.4",
"date": "quarter4_25"
},
"next_year": {
"analysts_number": "38",
"average_estimate": "7.95",
"low_estimate": "7.13",
"high_estimate": "9",
"last_year_eps": "7.38",
"year": "2026"
}
},
"earnings_history": {
"3_month_ago": {
"estimated_eps": "1.43",
"real_eps": "1.57",
"difference_points": "0.14",
"difference_perc": "10.12%",
"date": "quarter2_25"
},
"6_month_ago": {
"estimated_eps": "1.62",
"real_eps": "1.65",
"difference_points": "0.03",
"difference_perc": "1.69%",
"date": "quarter1_25"
},
"9_month_ago": {
"estimated_eps": "2.34",
"real_eps": "2.4",
"difference_points": "0.06",
"difference_perc": "2.52%",
"date": "quarter4_24"
},
"12_month_ago": {
"estimated_eps": "0.95",
"real_eps": "0.97",
"difference_points": "0.02",
"difference_perc": "2.48%",
"date": "quarter3_24"
}
},
"revenue_estimate": {
"previous_quarter": {
"analysts_number": "28",
"average_estimate": "88.96B",
"low_estimate": "86.92B",
"high_estimate": "91.84B",
"sales_last_year": "85.78B",
"growth_perc": "3.71%",
"date": "quarter2_25"
},
"current_quarter": {
"analysts_number": "24",
"average_estimate": "101.46B",
"low_estimate": "96.38B",
"high_estimate": "103.34B",
"sales_last_year": "94.93B",
"growth_perc": "6.87%",
"date": "quarter3_25"
},
"next_quarter": {
"analysts_number": "19",
"average_estimate": "129.75B",
"low_estimate": "124.25B",
"high_estimate": "139.37B",
"sales_last_year": "124.3B",
"growth_perc": "4.38%",
"date": "quarter4_25"
},
"next_year": {
"analysts_number": "37",
"average_estimate": "435.74B",
"low_estimate": "408.1B",
"high_estimate": "477.46B",
"sales_last_year": "415.62B",
"growth_perc": "4.84%",
"year": "2026"
}
}
}
}
}Need help, have questions? Get in touch with Support.
Use of the Finnworlds website, services like API and database are subject to the Finnworlds terms & Conditions