Zacks EPS Surprises

Zacks EPS Surprises Web API Documentation

This database returns historical estimated and actual earnings, guidance, and announcement dates for 17,000+ US and Canadian listed companies.

Endpoint:
https://api-v2.intrinio.com/zacks/eps_surprises

Parameters

Name Description Example
start_date
Limit EPS surprises to those on or after this date 2019-01-01
end_date
Limit EPS surprises to those on or before this date 2019-12-31
eps_actual_greater
Return only records with an actual EPS higher than this value 1.0
eps_actual_less
Return only records with an actual EPS lower than this value 2.0
eps_mean_estimate_greater
Return only records with an EPS mean estimate greater than this value 1.0
eps_mean_estimate_less
Return only records with an EPS mean estimate lower than this value 2.0
eps_amount_diff_greater
Return only records with an EPS amount difference greater than this value 1.0
eps_amount_diff_less
Return only records with an EPS amount difference less than this value 1.0
eps_percent_diff_greater
Return only records with an EPS percent difference greater than this value 0.0
eps_percent_diff_less
Return only records with an EPS percent difference less than this value 0.0
eps_count_estimate_greater
Return only records with an EPS count estimate greater than this value 5.0
eps_count_estimate_less
Return only records with an EPS count estimate less than this value 10.0
eps_std_dev_estimate_greater
Return only records with an EPS standard deviation greater than this value 0.0
eps_std_dev_estimate_less
Return only records with an EPS standard deviation less than this value 1.0
page_size
The number of results to return -
next_page
Gets the next page of data from a previous API call -
start_date
* required
Limit EPS surprises to those on or after this date
end_date
* required
Limit EPS surprises to those on or before this date
eps_actual_greater
* required
Return only records with an actual EPS higher than this value
eps_actual_less
* required
Return only records with an actual EPS lower than this value
eps_mean_estimate_greater
* required
Return only records with an EPS mean estimate greater than this value
eps_mean_estimate_less
* required
Return only records with an EPS mean estimate lower than this value
eps_amount_diff_greater
* required
Return only records with an EPS amount difference greater than this value
eps_amount_diff_less
* required
Return only records with an EPS amount difference less than this value
eps_percent_diff_greater
* required
Return only records with an EPS percent difference greater than this value
eps_percent_diff_less
* required
Return only records with an EPS percent difference less than this value
eps_count_estimate_greater
* required
Return only records with an EPS count estimate greater than this value
eps_count_estimate_less
* required
Return only records with an EPS count estimate less than this value
eps_std_dev_estimate_greater
* required
Return only records with an EPS standard deviation greater than this value
eps_std_dev_estimate_less
* required
Return only records with an EPS standard deviation less than this value
page_size
* required
The number of results to return
next_page
* required
Gets the next page of data from a previous API call

Output Fields

Name Description Type
eps_surprises
Zacks EPS Surprise data for a Security in descending order by actual reported date array
id
The Intrinio ID for the record string
fiscal_year
The company’s fiscal year for the reported period number
fiscal_quarter
The company’s fiscal quarter for the reported period string
calendar_year
The closest calendar year for the company’s fiscal year number
calendar_quarter
The closest calendar quarter for the company’s fiscal year string
actual_reported_date
The actual report date for the earnings release date
actual_reported_time
The actual report time for the earnings release string
actual_reported_code
The code cooresponding to the earnings release BTO = BEFORE THE OPEN | DTM = DURING THE MARKET | AMC = AFTER MARKET CLOSE string
actual_reported_desc
The description for the type of earnings release string
eps_actual
The actual Non-GAAP EPS figure released by the company, interpreted by Zacks. number
eps_actual_zacks_adj
The adjustments Zacks made to get to Non-GAAP EPS to reconcile with GAAP EPS. number
eps_mean_estimate
The pre-earnings release mean EPS estimate for the company number
eps_amount_diff
The EPS surprise amount difference number
eps_percent_diff
The EPS surprise percent difference number
eps_count_estimate
The pre-earnings release number of estimates by analysts number
eps_std_dev_estimate
The pre-earnings release standard deviation of EPS estimates number
security
The Security of the Zacks EPS Surprise 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
eps_surprises
Zacks EPS Surprise data for a Security in descending order by actual reported date
next_page
The token required to request the next page of the data. If null, no further results are available.