GET Ratings - Benzinga

Introduction

Benzinga APIs

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

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

string

Unique ID of this entry

date

string

Date for rating

time

string

Time for rating

ticker

string

Ticker symbol of company that is subject of rating

exchange

string

Exchange (NYSE, NASDAQ, etc...)

name

string

Name of company that is subject of rating

currency

string

Currency the data is denominated in

action_pt

enum<string>

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

Available options:

Announces,

Maintains,

Lowers,

Raises,

Removes

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

rating_current

string

The analyst's rating for the company

pt_current

string

Analyst's current price target

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.

rating_prior

string

Prior analyst rating for the company

pt_prior

string

Analyst's prior price target

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.

url

string

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

url_calendar

string

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

url_news

string

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

analyst

string

Name of the analyst firm that published the rating

analyst_id

string

Id of the analyst

analyst_name

string

Name of the analyst (person) that published the rating

ratings_accuracy

object

Analyst accuracy scores

ratings_accuracy.smart_score

string

A weighted average of the total_ratings_percentile, overall_avg_return_percentile, and overall_success_rate

ratings_accuracy.overall_success_rate

string

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

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_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_accuracy.total_ratings

integer

Number of recommendations made by this analyst

ratings_accuracy.overall_gain_count

integer

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

ratings_accuracy.overall_loss_count

integer

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

ratings_accuracy.overall_average_return

string

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

ratings_accuracy.overall_stdev

string

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

ratings_accuracy.1m_gain_count

string

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

ratings_accuracy.1m_loss_count

string

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

ratings_accuracy.1m_average_return

string

The average percent price difference per rating over the last month

ratings_accuracy.1m_stdev

string

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

ratings_accuracy.3m_gain_count

string

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

ratings_accuracy.3m_loss_count

string

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

ratings_accuracy.3m_average_return

string

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

ratings_accuracy.3m_stdev

string

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

ratings_accuracy.9m_gain_count

string

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

ratings_accuracy.9m_loss_count

string

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

ratings_accuracy.9m_average_return

string

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

ratings_accuracy.9m_stdev

string

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

ratings_accuracy.1y_gain_count

string

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

ratings_accuracy.1y_loss_count

string

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

ratings_accuracy.1y_average_return

string

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

ratings_accuracy.1y_stdev

string

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

ratings_accuracy.2y_gain_count

string

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

ratings_accuracy.2y_loss_count

string

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

ratings_accuracy.2y_average_return

string

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

ratings_accuracy.2y_stdev

string

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

ratings_accuracy.3y_gain_count

string

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

ratings_accuracy.3y_loss_count

string

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

ratings_accuracy.3y_average_return

string

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

ratings_accuracy.3y_stdev

string

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

ratings_accuracy.updated

integer

Last update timstamp in UTC Unix epoch timestamp (seconds)

importance

enum<string>

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

Available options:

0,

1,

2,

3,

4,

5

notes

string

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

updated

integer

Last updated timestamp, UTC

Was this page helpful?

GET Offerings GET Mergers and Acquisitions