API Documentation

We have released a new API version! Select v1 to see the old version.

Zacks Analyst Ratings

Zacks Analyst Ratings

Returns buy, sell, and hold recommendations from analysts at brokerages for the Security with the given `identifier`. Zack’s storied research team aggregates and validates the ratings from professional analysts.

Endpoint:
https://api-v2.intrinio.com/securities/{identifier}/zacks/analyst_ratings
Available in Sandbox

Parameters

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

Output Fields

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
next_page The token required to request the next page of the data string
analyst_ratings
security
The Security resolved from the given identifier
next_page
The token required to request the next page of the data