GET Consensus Ratings

Introduction

Benzinga APIs

Introduction
Newsfeed & Why is it Moving v2
Calendar
Data Websocket
Historical Bar Data
Delayed Quote
Company Fundamentals
Bull vs. Bear
Analyst Insights
Conference Call Transcripts
Government Trades
Corporate Logos
Movers
Newsfeed (Streaming) v1
SEC Filings
Signals
Squawk
Webhook v1 Test Trigger
Short Interest

Libraries

GET

consensus-ratings

curl --request GET \
  --url https://api.benzinga.com/api/v1/consensus-ratings \
  --header 'accept: <accept>'

{
    "aggregate_ratings": {
        "buy": 74,
        "hold": 20,
        "sell": 6
    },
    "aggregate_type": "percentage",
    "low_price_target": 186,
    "high_price_target": 300,
    "consensus_price_target": 250.1784,
    "consensus_rating_val": 3.68,
    "consensus_rating": "BUY",
    "updated_at": "2024-10-16T06:53:04Z",
    "total_analyst_count": 50,
    "unique_analyst_count": 1
}

{
    "aggregate_ratings": {
        "buy": 74,
        "hold": 20,
        "sell": 6
    },
    "aggregate_type": "percentage",
    "low_price_target": 186,
    "high_price_target": 300,
    "consensus_price_target": 250.1784,
    "consensus_rating_val": 3.68,
    "consensus_rating": "BUY",
    "updated_at": "2024-10-16T06:53:04Z",
    "total_analyst_count": 50,
    "unique_analyst_count": 1
}

Authorizations

token

string

query

required

Headers

enum<string>

default:application/json

required

Specifies return format. Query parameters work the same for both formats.

Available options:

application/json

Query Parameters

pagesize

integer

Number of results returned. Limit 1000

parameters[date_from]

string

Date to query from point in time.

parameters[date_to]

string

Date to query to point in time.

parameters[tickers]

string

One ticker symbol to query the aggregate for. All calendars accept this parameter (not including the FDA endpoint; for the FDA endpoint, please use "parameters[securities]" instead). Ignored by the Economics endpoint. Maximum 1 ticker.

simplify

boolean

default:false

To simplify the aggregate ratings to only BUY, SELL, HOLD, default will return all ratings (STRONG_BUY, BUY, HOLD, SELL, STRONG_SELL).

aggregate_type

enum<string>

default:number

To aggregate the ratings by either number or percentage.

Available options:

number,

percentage

Response

200 - application/json

success

ratings

object[]

Was this page helpful?

Suggest edits Raise issue

GET Earnings GET Economics

curl --request GET \
  --url https://api.benzinga.com/api/v1/consensus-ratings \
  --header 'accept: <accept>'

{
    "aggregate_ratings": {
        "buy": 74,
        "hold": 20,
        "sell": 6
    },
    "aggregate_type": "percentage",
    "low_price_target": 186,
    "high_price_target": 300,
    "consensus_price_target": 250.1784,
    "consensus_rating_val": 3.68,
    "consensus_rating": "BUY",
    "updated_at": "2024-10-16T06:53:04Z",
    "total_analyst_count": 50,
    "unique_analyst_count": 1
}