This database offers consensus analyst recommendations for over 5,000 US and Canadian listed companies.
| Name | Description | Example |
|---|---|---|
|
identifier
* required
|
A Security identifier (Ticker, FIGI, ISIN, CUSIP, Intrinio ID) | AAPL |
|
start_date
|
Limit ratings to those on or after this date | 2019-01-01 |
|
end_date
|
Limit ratings to those on or before this date | 2019-12-31 |
|
mean_greater
|
Return only records with a mean (average) higher than this value | 1.5 |
|
mean_less
|
Return only records with a mean (average) lower than this value | 3.0 |
|
strong_buys_greater
|
Return only records with more than this many Strong Buy recommendations | 5 |
|
strong_buys_less
|
Return only records with fewer than this many Strong Buy recommendations | 10 |
|
buys_greater
|
Return only records with more than this many Buy recommendations | 2 |
|
buys_less
|
Return only records with fewer than this many Buy recommendations | 1 |
|
holds_greater
|
Return only records with more than this many Hold recommendations | 3 |
|
holds_less
|
Return only records with fewer than this many Hold recommendations | 5 |
|
sells_greater
|
Return only records with more than this many Sell recommendations | 8 |
|
sells_less
|
Return only records with fewer than this many Sell recommendations | 7 |
|
strong_sells_greater
|
Return only records with more than this many Strong Sell recommendations | 8 |
|
strong_sells_less
|
Return only records with fewer than this many Strong Sell recommendations | 8 |
|
total_greater
|
Return only records with more than this many recommendations, regardless of type | 20 |
|
total_less
|
Return only records with fewer than this many recommendations, regardless of type | 7 |
|
page_size
|
The number of results to return | - |
|
identifier
* required
A Security identifier (Ticker, FIGI, ISIN, CUSIP, Intrinio ID)
|
||
|
start_date
* required
Limit ratings to those on or after this date
|
||
|
end_date
* required
Limit ratings to those on or before this date
|
||
|
mean_greater
* required
Return only records with a mean (average) higher than this value
|
||
|
mean_less
* required
Return only records with a mean (average) lower than this value
|
||
|
strong_buys_greater
* required
Return only records with more than this many Strong Buy recommendations
|
||
|
strong_buys_less
* required
Return only records with fewer than this many Strong Buy recommendations
|
||
|
buys_greater
* required
Return only records with more than this many Buy recommendations
|
||
|
buys_less
* required
Return only records with fewer than this many Buy recommendations
|
||
|
holds_greater
* required
Return only records with more than this many Hold recommendations
|
||
|
holds_less
* required
Return only records with fewer than this many Hold recommendations
|
||
|
sells_greater
* required
Return only records with more than this many Sell recommendations
|
||
|
sells_less
* required
Return only records with fewer than this many Sell recommendations
|
||
|
strong_sells_greater
* required
Return only records with more than this many Strong Sell recommendations
|
||
|
strong_sells_less
* required
Return only records with fewer than this many Strong Sell recommendations
|
||
|
total_greater
* required
Return only records with more than this many recommendations, regardless of type
|
||
|
total_less
* required
Return only records with fewer than this many recommendations, regardless of type
|
||
|
page_size
* required
The number of results to return
|
| Name | Description | Type |
|---|---|---|
| analyst_ratings | array | |
|
id
|
The Intrinio ID for the record | string |
|
date
|
The date of the Zacks Analyst Rating. | date |
|
mean
|
The mean (average) weighing of analyst recommendations, from 1 (strong buy) to 5 (strong sell). | number |
|
strong_buys
|
The number of analysts recommending Strong Buy. | integer |
|
buys
|
The number of analysts recommending Buy. | integer |
|
holds
|
The number of analysts recommending Hold. | integer |
|
sells
|
The number of analysts recommending Sell. | integer |
|
strong_sells
|
The number of analysts recommending Strong Sell. | integer |
|
total
|
The total number of analyst recommendations. | integer |
| security | The Security resolved from the given identifier | object |
|
id
|
The Intrinio ID for Security | string |
|
company_id
|
The Intrinio ID for the Company for which the Security is issued | string |
|
name
|
The name of the Security | string |
|
code
|
A 2-3 digit code classifying the Security (reference) | string |
|
currency
|
The currency in which the Security is traded on the exchange | string |
|
ticker
|
The common/local ticker of the Security | string |
|
composite_ticker
|
The country-composite ticker of the Security | string |
|
figi
|
The OpenFIGI identifier | string |
|
composite_figi
|
The country-composite OpenFIGI identifier | string |
|
share_class_figi
|
The global-composite OpenFIGI identifier | string |
|
primary_listing
|
If true, the Security is the primary issue for the company, otherwise it is a secondary issue on a secondary stock exchange | boolean |
| next_page | The token required to request the next page of the data. If null, no further results are available. | string |
|
analyst_ratings
|
||
|
security
The Security resolved from the given identifier
|
||
|
next_page
The token required to request the next page of the data. If null, no further results are available.
|
