Analyst Ratings
GET
/benzinga/v1/ratings
Retrieve structured historical analyst ratings, including rating actions, price target changes, and firm names for publicly traded companies. Each record captures key attributes such as the rating date, action type (e.g., downgrade, maintain), and firm issuing the rating, along with optional price target changes and surprise indicators. Data can be filtered by ticker, firm, rating action, and date range. Price targets are optionally adjusted for corporate actions like splits and dividends. Records are timestamped and sortable for flexible integration into downstream applications.
Use Cases: Market sentiment tracking, portfolio alerts, backtesting rating impact, trend analysis.
Query Parameters
date
string
The calendar date (formatted as YYYY-MM-DD) when the rating was issued.
ticker
string
The stock symbol of the company being rated.
importance
integer
A subjective indicator of the importance of the earnings event, on a scale from 0 (lowest) to 5 (highest). Value must be an integer.
last_updated
string
The timestamp (formatted as an ISO 8601 timestamp) when the rating was last updated in the system.
rating_action
string
The description of the change in rating from the firm's last rating. Possible values include: downgrades, maintains, reinstates, reiterates, upgrades, assumes, initiates_coverage_on, terminates_coverage_on, removes, suspends, firm_dissolved.
price_target_action
string
The description of the directional change in price target. Possible values include: raises, lowers, maintains, announces, sets.
benzinga_id
string
The identifer used by Benzinga for this record.
benzinga_analyst_id
string
Filter equal to the value.
benzinga_firm_id
string
Filter equal to the value.
limit
integer
Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.
sort
string
A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'date' if not specified. The sort order defaults to 'desc' if not specified.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page.
request_id
string
A request id assigned by the server.
results
array (object)
The results for this request.
adjusted_price_target
number
optional
The current price target adjusted for stock splits and dividends.
analyst
string
optional
The name of the individual analyst who issued the rating.
benzinga_analyst_id
string
optional
benzinga_calendar_url
string
optional
A link to the Benzinga calendar page for this ticker
benzinga_firm_id
string
optional
benzinga_id
string
optional
The identifer used by Benzinga for this record.
benzinga_news_url
string
optional
A link to the Benzinga articles page for this ticker
company_name
string
optional
The name of the company being rated.
currency
string
optional
The ISO 4217 currency code in which the price target is denominated.
date
string
optional
The calendar date (formatted as YYYY-MM-DD) when the rating was issued.
firm
string
optional
The name of the research firm or investment bank issuing the rating.
importance
integer
optional
A subjective indicator of the importance of the earnings event, on a scale from 0 (lowest) to 5 (highest).
last_updated
string
optional
The timestamp (formatted as an ISO 8601 timestamp) when the rating was last updated in the system.
notes
string
optional
Additional context or commentary.
previous_adjusted_price_target
number
optional
The previous price target adjusted for stock splits and dividends.
previous_price_target
number
optional
The previous price target set by the analyst.
previous_rating
string
optional
The previous rating set by the analyst.
price_percent_change
number
optional
price_target
number
optional
The current price target set by the analyst.
price_target_action
string
optional
The description of the directional change in price target. Possible values include: raises, lowers, maintains, announces, sets.
rating
string
optional
The current rating set by the analyst.
rating_action
string
optional
The description of the change in rating from the firm's last rating. Possible values include: downgrades, maintains, reinstates, reiterates, upgrades, assumes, initiates_coverage_on, terminates_coverage_on, removes, suspends, firm_dissolved.
ticker
string
optional
The stock symbol of the company being rated.
time
string
optional
The time (formatted as 24-hour HH:MM:SS UTC) when the rating was issued.
status
enum (OK)
The status of this request's response.