Returns a snapshot of ratings data compared with previous timeframes. Also returns mean percentiles for comparing one security to the universe of securities covered by Zacks analyst ratings, at a specific point in time.
| Name | Description | Example |
|---|---|---|
|
identifier
* required
|
The identifier for the legal entity or a security associated with the security. | AAPL |
|
date
|
Lookup a historical snapshot on the given date | 2014-09-28 |
|
identifier
* required
The identifier for the legal entity or a security associated with the security.
|
||
|
date
* required
Lookup a historical snapshot on the given date
|
| Name | Description | Type |
|---|---|---|
| type | The snapshot type, signifying the age of the ratings data from the snapshot date | string |
| snapshot_date | The date of the snapshot, when data was recorded | date |
| rating_date | The date of the latest rating for the snapshot timeframe - this is the effective date of the ratings data | date |
| mean | The mean (average) weighing of analyst recommendations, from 1 (strong buy) to 5 (strong sell) | number |
| mean_percentile | The percentile of the mean, derived by comparing to all securities rated by analysts as of the rating date, ranging 0.0 (strong buy) to 1.0 (strong sell) | number |
| strong_buys | The number of analysts recommending Strong Buy | number |
| buys | The number of analysts recommending Buy | number |
| holds | The number of analysts recommending Hold | number |
| sells | The number of analysts recommending Sell | number |
| strong_sells | The number of analysts recommending Strong Sell | number |
| total | The total number of analysts recommendations | number |
|
type
The snapshot type, signifying the age of the ratings data from the snapshot date
|
||
|
snapshot_date
The date of the snapshot, when data was recorded
|
||
|
rating_date
The date of the latest rating for the snapshot timeframe - this is the effective date of the ratings data
|
||
|
mean
The mean (average) weighing of analyst recommendations, from 1 (strong buy) to 5 (strong sell)
|
||
|
mean_percentile
The percentile of the mean, derived by comparing to all securities rated by analysts as of the rating date, ranging 0.0 (strong buy) to 1.0 (strong sell)
|
||
|
strong_buys
The number of analysts recommending Strong Buy
|
||
|
buys
The number of analysts recommending Buy
|
||
|
holds
The number of analysts recommending Hold
|
||
|
sells
The number of analysts recommending Sell
|
||
|
strong_sells
The number of analysts recommending Strong Sell
|
||
|
total
The total number of analysts recommendations
|
Back to Product Docs