Analyst · US only

Analyst consensus

GET/api/v2/analyst-consensusUS only

Coverage: US
Billing: 20 cr / thousand calls

One row per ticker: the five-tier distribution of each firm's latest rating within the last 90 days, plus the mean / high / low price target. 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).
A ticker with fewer than 2 firms rating it within the window returns no row and no error; rows map to the request by the ticker field, not by position. Any change to the window length is announced in the changelog.

Shared analyst conventions

Rating events are parsed from public press releases and news coverage — they are news-reported (secondhand), not the original text of the firms' research reports; consensus is derived from these events, aggregated by firm. Coverage is US only; tickers from other markets return 404.

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	string	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.