Overview
The Analyst Ratings API provides structured, real-time and historical access to equity analyst upgrades, downgrades, initiations, and reiterations across U.S. publicly traded companies. Built for developers, quant researchers, and fintech platforms, the API surfaces granular rating activity from major sell-side firms, normalized into a consistent JSON format for easy integration.
Key Features
- Normalized Ratings: Converts varied broker terminology (e.g., “Overweight,” “Outperform,” “Buy”) into a standardized rating scale: Buy, Hold, Sell.
- Firm Attribution: Each rating includes the originating firm, analyst name (if available), and timestamp of publication.
- Target Price Tracking: Captures both new and previous price targets for each rating event, enabling delta analysis.
- Historical Ratings Data: Query by ticker, firm, or rating type to retrieve past analyst actions for backtesting or trend analysis.
- Real-Time Feed: New rating actions are available in real time via push or polling endpoints — ideal for triggering alerts or updating frontend views.
- Ticker-Level Aggregation: Ratings data can be aggregated at the company level to derive current sentiment or analyst consensus.
Coverage
- Firms: Includes top-tier investment banks and independent research shops with consistent U.S. equity coverage.
- Universe: Primarily U.S.-listed equities, including large-cap and small-cap tickers across all sectors.
- Latency: Sub-minute delivery for new ratings published during market hours.
Use Cases
- Build consensus rating modules for investor dashboards
- Backtest price impact of analyst upgrades/downgrades
- Identify coverage changes and shifts in sentiment ahead of earnings
Generate alerts when multiple firms revise targets or change recommendations
The Analyst Ratings API is ideal for developers looking to integrate real-time sell-side sentiment into trading models, financial news feeds, or stock discovery tools. With consistent formatting and rich metadata, it offers a clean foundation for deeper analysis of analyst behavior over time.