GET Ratings - Benzinga

Documentation
API Suite
Blog
Contact Us

Introduction

Home

Introduction

Benzinga APIs

Newsfeed & Why is it Moving v2

Calendar

Historical Bar Data

Delayed Quote

Company Fundamentals

Fxstreet Economic Calendar

Bull vs. Bear

Analyst Insights

Conference Call Transcripts

Government Trades

Corporate Logos

Movers

Newsfeed (Streaming) v1

SEC Filings

Signals

Squawk

Webhook v1 Test Trigger

Libraries

Python Client

Javascript client

GET

calendar

ratings

fields

string

page

integer

pagesize

integer

parameters[date]

string

parameters[date_from]

string

parameters[date_to]

string

parameters[tickers]

string

parameters[importance]

enum<integer>

parameters[updated]

integer

parameters[action]

enum<string>

parameters[analyst_id]

string

parameters[firm_id]

string

analyst

string

firm

string

Authorizations

token

string

queryrequired

Headers

enum<string>

default: application/jsonrequired

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

Available options:

application/json

Query Parameters

fields

string

Available fields:

id
date
time
ticker
exchange
name
currency
action_pt
action_company
rating_current
pt_current
rating_prior
pt_prior
url
url_calendar
url_news
analyst
analyst_id
analyst_name
ratings_accuracy
importance
notes
updated

Default fields:

id
date
time
ticker
exchange
name
currency
action_pt
action_company
rating_current
pt_current
rating_prior
pt_prior
url
url_calendar
url_news
analyst
analyst_name
importance
notes
updated

page

integer

default: 0

Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.

pagesize

integer

Number of results returned. Limit 1000

parameters[date]

string

Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.

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 or more ticker symbols separated by a comma. 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 50 tickers. Note that for the IPOs endpoint, new tickers may not return results right away as we do not automatically link them to the underlying company's data. Thus, to obtain the most recent rows from the IPOs endpoint, send queries without this parameter specified.

parameters[importance]

enum<integer>

The importance level to filter by. Uses Greater Than or Equal To the importance indicated

Available options:

0,

1,

2,

3,

4,

5

parameters[updated]

integer

Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.

parameters[action]

enum<string>

Filter by a specific action_company (action for rating). Note that all of these terms are precisely defined.

Available options:

Downgrades,

Maintains,

Reinstates,

Reiterates,

Upgrades,

Assumes,

Initiates Coverage On,

Terminates Coverage On,

Removes,

Suspends,

Firm Dissolved

parameters[analyst_id]

string

One or more analyst ids (analyst_id) separated by a comma.

parameters[firm_id]

string

One or more firm ids (firm_id) separated by a comma.

analyst

string

A comma separated list of analyst (person) ID's to bring back. Omitting will bring back all available analysts.

firm

string

A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms.

Response

200 - application/json

ratings

object[]

ratings.id

string

Unique ID of this entry

ratings.date

string

Date for rating

ratings.time

string

Time for rating

ratings.ticker

string

Ticker symbol of company that is subject of rating

ratings.exchange

string

Exchange (NYSE, NASDAQ, etc...)

ratings.name

string

Name of company that is subject of rating

ratings.currency

string

Currency the data is denominated in

ratings.action_pt

enum<string>

Description of the change in price target from firm's last price target

Available options:

Announces,

Maintains,

Lowers,

Raises,

Removes

ratings.action_company

enum<string>

Description of the change in rating from firm's last rating. Note that all of these terms are precisely defined.

Available options:

Downgrades,

Maintains,

Reinstates,

Reiterates,

Upgrades,

Assumes,

Initiates Coverage On,

Terminates Coverage On,

Removes,

Suspends,

Firm Dissolved

ratings.rating_current

string

The analyst's rating for the company

ratings.pt_current

string

Analyst's current price target

ratings.adjusted_pt_current

string

Analyst's current price target, adjusted to account for stock splits and stock dividends. If none are applicable, the pt_current value is used.

ratings.rating_prior

string

Prior analyst rating for the company

ratings.pt_prior

string

Analyst's prior price target

ratings.adjusted_pt_prior

string

Analyst's prior price target, adjusted to account for stock splits and stock dividends. If none are applicable, the pt_prior value is used.

ratings.url

string

URL for analyst ratings page for this ticker on Benzinga.com

ratings.url_calendar

string

URL for analyst ratings page for this ticker on Benzinga.com

ratings.url_news

string

URL for analyst ratings news articles for this ticker on Benzinga.com

ratings.analyst

string

Name of the analyst firm that published the rating

ratings.analyst_id

string

Id of the analyst

ratings.analyst_name

string

Name of the analyst (person) that published the rating

ratings.ratings_accuracy

object

Analyst accuracy scores

ratings.ratings_accuracy.smart_score

string

A weighted average of the total_ratings_percentile, overall_avg_return_percentile, and overall_success_rate

ratings.ratings_accuracy.overall_success_rate

string

The percentage of gain/loss ratings that resulted in a gain overall

ratings.ratings_accuracy.overall_avg_return_percentile

string

The percentile of this analyst’s overall average return per rating in comparison to other analysts' overall average returns per rating

ratings.ratings_accuracy.total_ratings_percentile

string

The percentile of this analyst’s total number of ratings in comparison to the total number of ratings published by all other analysts

ratings.ratings_accuracy.total_ratings

integer

Number of recommendations made by this analyst

ratings.ratings_accuracy.overall_gain_count

integer

The number of ratings that have gained value since the date of recommendation

ratings.ratings_accuracy.overall_loss_count

integer

The number of ratings that have lost value since the date of recommendation

ratings.ratings_accuracy.overall_average_return

string

The average percent price difference per rating since the date of recommendation

ratings.ratings_accuracy.overall_stdev

string

The standard deviation in percent price difference in the analyst’s ratings since the date of recommendation

ratings.ratings_accuracy.1m_gain_count

string

The number of ratings that have gained value over the last month

ratings.ratings_accuracy.1m_loss_count

string

The number of ratings that have lost value over the last month

ratings.ratings_accuracy.1m_average_return

string

The average percent price difference per rating over the last month

ratings.ratings_accuracy.1m_stdev

string

The standard deviation in percent price difference in the analyst’s ratings over the last month

ratings.ratings_accuracy.3m_gain_count

string

The number of ratings that have gained value over the last three months

ratings.ratings_accuracy.3m_loss_count

string

The number of ratings that have lost value over the last three months

ratings.ratings_accuracy.3m_average_return

string

The average percent price difference per rating over the last three months

ratings.ratings_accuracy.3m_stdev

string

The standard deviation in percent price difference in the analyst’s ratings over the last three months

ratings.ratings_accuracy.9m_gain_count

string

The number of ratings that have gained value over the last nine months

ratings.ratings_accuracy.9m_loss_count

string

The number of ratings that have lost value over the last nine months

ratings.ratings_accuracy.9m_average_return

string

The average percent price difference per rating over the last nine months

ratings.ratings_accuracy.9m_stdev

string

The standard deviation in percent price difference in the analyst’s ratings over the last nine months

ratings.ratings_accuracy.1y_gain_count

string

The number of ratings that have gained value over the last year (TTM)

ratings.ratings_accuracy.1y_loss_count

string

The number of ratings that have lost value over the last year (TTM)

ratings.ratings_accuracy.1y_average_return

string

The average percent price difference per rating over the last year (TTM)

ratings.ratings_accuracy.1y_stdev

string

The standard deviation in percent price difference in the analyst’s ratings over the last year (TTM)

ratings.ratings_accuracy.2y_gain_count

string

The number of ratings that have gained value over the last two years

ratings.ratings_accuracy.2y_loss_count

string

The number of ratings that have lost value over the last two years

ratings.ratings_accuracy.2y_average_return

string

The average percent price difference per rating over the last two years

ratings.ratings_accuracy.2y_stdev

string

The standard deviation in percent price difference in the analyst’s ratings over the last two years

ratings.ratings_accuracy.3y_gain_count

string

The number of ratings that have gained value over the last three years

ratings.ratings_accuracy.3y_loss_count

string

The number of ratings that have lost value over the last three years

ratings.ratings_accuracy.3y_average_return

string

The average percent price difference per rating over the last three years

ratings.ratings_accuracy.3y_stdev

string

The standard deviation in percent price difference in the analyst’s ratings over the last three years

ratings.ratings_accuracy.updated

integer

Last update timstamp in UTC Unix epoch timestamp (seconds)

ratings.importance

enum<string>

Subjective Basis of How Important Event is to Market. 5 = High

Available options:

0,

1,

2,

3,

4,

5

ratings.notes

string

Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.

ratings.updated

integer

Last updated timestamp, UTC

Was this page helpful?

GET Offerings GET Mergers and Acquisitions