GET Ratings
Returns analyst ratings data
Authorizations
Headers
Specifies return format. Query parameters work the same for both formats.
application/json Query Parameters
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 offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date.
Number of results returned. Limit 1000
Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest.
Date to query from point in time.
Date to query to point in time.
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.
The importance level to filter by. Uses Greater Than or Equal To the importance indicated
0, 1, 2, 3, 4, 5 Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated.
Filter by a specific action_company (action for rating). Note that all of these terms are precisely defined.
Downgrades, Maintains, Reinstates, Reiterates, Upgrades, Assumes, Initiates Coverage On, Terminates Coverage On, Removes, Suspends, Firm Dissolved One or more analyst ids (analyst_id) separated by a comma.
One or more firm ids (firm_id) separated by a comma.
A comma separated list of analyst (person) ID's to bring back. Omitting will bring back all available analysts.
A comma separated list of analyst firm ID's to bring back. Omitting will bring back all available firms.
Response
Unique ID of this entry
Date for rating
Time for rating
Ticker symbol of company that is subject of rating
Exchange (NYSE, NASDAQ, etc...)
Name of company that is subject of rating
Currency the data is denominated in
Description of the change in price target from firm's last price target
Announces, Maintains, Lowers, Raises, Removes Description of the change in rating from firm's last rating. Note that all of these terms are precisely defined.
Downgrades, Maintains, Reinstates, Reiterates, Upgrades, Assumes, Initiates Coverage On, Terminates Coverage On, Removes, Suspends, Firm Dissolved The analyst's rating for the company
Analyst's current price target
Analyst's current price target, adjusted to account for stock splits and stock dividends. If none are applicable, the pt_current value is used.
Prior analyst rating for the company
Analyst's prior price target
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 for analyst ratings page for this ticker on Benzinga.com
URL for analyst ratings page for this ticker on Benzinga.com
URL for analyst ratings news articles for this ticker on Benzinga.com
Name of the analyst firm that published the rating
Id of the analyst
Name of the analyst (person) that published the rating
Analyst accuracy scores
Subjective Basis of How Important Event is to Market. 5 = High
0, 1, 2, 3, 4, 5 Additional notes provided by the Benzinga Newsdesk where applicable. Notes may include HTML.
Last updated timestamp, UTC
Was this page helpful?