Analyst · US only

Analyst consensus

GET/api/v2/analyst-consensusUS only

Coverage: US
Billing: 20 cr / thousand calls

Returns the analyst consensus for a stock: the five-tier distribution (strong buy to strong sell) of each firm's latest rating within the last 90 days, plus the mean / high / low price target, one row per ticker. Aggregated results only; this platform's own ratings are not included.

Each firm (firm) contributes to the distribution only through its latest rating-bearing event within the window; the price target statistics use that firm's latest event carrying a price target within the window (which may not be the same event that counts toward the distribution).
Rows come from the latest daily aggregation: a ticker with fewer than 2 firms rating it within the window is not aggregated, so it returns no row and no error; a ticker that qualified earlier does not keep its previous result. Rows map to the request by the ticker field, not by position. Any change to the window length is announced in the changelog.

Query parameters

Parameter	Type	Required	Description
ticker	string	required	Up to 50 tickers, comma-separated.

Response fields

Field	Type	Description
ticker	string	Canonical ticker; this endpoint is US-only, so there is no market suffix (e.g. `AAPL`)
total_analysts	int	Number of firms with a rating within the window
strong_buy	int	Five-tier distribution: strong buy count (the firm's own rating wording is normalized to the five-tier scale before counting; same for all five tiers)
buy	int	Five-tier distribution: buy count
hold	int	Five-tier distribution: hold count
sell	int	Five-tier distribution: sell count
strong_sell	int	Five-tier distribution: strong sell count
consensus_rating	stringenum	Consensus tier derived from the five-tier distribution: `strong_buy` / `buy` / `hold` / `sell` / `strong_sell`
price_target_consensus	number	Mean price target (each firm's latest price target within the window)
price_target_high	number	Highest price target
price_target_low	number	Lowest price target
price_target_count	int	Number of firms contributing to the price target statistics (may be less than `total_analysts`)

Request

curl -H "X-API-KEY: $DRILLR_API_KEY" \
  "https://gateway.drillr.ai/api/v2/analyst-consensus?ticker=NVDA,AMD"

Response · 200

{
  "data": [
    {
      "ticker": "NVDA",
      "total_analysts": 47,
      "strong_buy": 6,
      "buy": 24,
      "hold": 15,
      "sell": 2,
      "strong_sell": 0,
      "consensus_rating": "buy",
      "price_target_consensus": 172.5,
      "price_target_high": 220,
      "price_target_low": 120,
      "price_target_count": 41
    }
  ]
}

No key yet? Create one under API Keys — it is shown once, so store it where your shell can read it. Connecting an agent over MCP instead? That signs in through the browser and needs no key at all.

Authentication, conventions, rate limits and error shapes are the same for every endpoint — they live on REST API.