Browse the docs

Analyst view

GET/v1/companies/{symbol}/analysts

Sell-side analysts' price targets, the ratings consensus, and recent upgrades and downgrades.

Each call counts against your allowance.

Parameters

NameInTypeWhat it does
symbol (required)pathtickerStock ticker, like AAPL.

Any other parameter is refused, so a typo is caught rather than quietly ignored.

Answer

The answer is { data, asOf }. Here is data, abridged: real answers carry more fields.

data (abridged)
{
  "priceTargets": [
    {
      "targetHigh": 325,
      "targetLow": 200,
      "targetConsensus": 268.5
    }
  ],
  "ratings": [
    {
      "strongBuy": 4,
      "buy": 21,
      "hold": 13,
      "sell": 1,
      "strongSell": 1,
      "consensus": "Buy"
    }
  ],
  "recentChanges": [
    {
      "gradingCompany": "Example Securities",
      "previousGrade": "Hold",
      "newGrade": "Buy",
      "action": "upgrade"
    }
  ]
}

Answers and errors covers every answer’s shape and what an error carries.