Zacks Sales Surprises Java API Documentation

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

API Class:

ZacksApi

Instance Method:

getZacksSalesSurprises()

Stock Price Code Example

Use my API Key

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
import com.intrinio.api.*;
import com.intrinio.models.*;
import com.intrinio.invoker.*;
import com.intrinio.invoker.auth.*;
import org.threeten.bp.*;
import java.math.BigDecimal;
import java.util.*;
public class Main {
  public static void main(String[] args) throws Exception {
    ApiClient defaultClient = Configuration.getDefaultApiClient();
    ApiKeyAuth auth = (ApiKeyAuth) defaultClient.getAuthentication("ApiKeyAuth");
    auth.setApiKey("YOUR_API_KEY");
    defaultClient.setAllowRetries(true);
    ZacksApi zacksApi = new ZacksApi();
    LocalDate startDate = null;
    LocalDate endDate = null;
    BigDecimal salesActualGreater = null;
    BigDecimal salesActualLess = null;
    BigDecimal salesMeanEstimateGreater = null;
    BigDecimal salesMeanEstimateLess = null;
    BigDecimal salesAmountDiffGreater = null;
    BigDecimal salesAmountDiffLess = null;
    BigDecimal salesPercentDiffGreater = null;
    BigDecimal salesPercentDiffLess = null;
    BigDecimal salesCountEstimateGreater = null;
    BigDecimal salesCountEstimateLess = null;
    BigDecimal salesStdDevEstimateGreater = null;
    BigDecimal salesStdDevEstimateLess = null;
    Integer pageSize = 100;
    String nextPage = null;
    ApiResponseZacksSalesSurprises result = zacksApi.getZacksSalesSurprises(startDate, endDate, salesActualGreater, salesActualLess, 
      salesMeanEstimateGreater, salesMeanEstimateLess, salesAmountDiffGreater, salesAmountDiffLess, salesPercentDiffGreater, salesPercentDiffLess, 
      salesCountEstimateGreater, salesCountEstimateLess, salesStdDevEstimateGreater, salesStdDevEstimateLess, pageSize, nextPage);
    System.out.println(result);
  }
}
הההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההההה
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Parameters

Name	Type	Description	Notes
startDate	LocalDate	Limit sales surprises to those on or after this date	[optional]
endDate	LocalDate	Limit sales surprises to those on or before this date	[optional]
salesActualGreater	BigDecimal	Return only records with an actual sales higher than this value	[optional]
salesActualLess	BigDecimal	Return only records with an actual sales lower than this value	[optional]
salesMeanEstimateGreater	BigDecimal	Return only records with a sales mean estimate greater than this value	[optional]
salesMeanEstimateLess	BigDecimal	Return only records with a sales mean estimate lower than this value	[optional]
salesAmountDiffGreater	BigDecimal	Return only records with a sales amount difference greater than this value	[optional]
salesAmountDiffLess	BigDecimal	Return only records with a sales amount difference less than this value	[optional]
salesPercentDiffGreater	BigDecimal	Return only records with a sales percent difference greater than this value	[optional]
salesPercentDiffLess	BigDecimal	Return only records with a sales percent difference less than this value	[optional]
salesCountEstimateGreater	BigDecimal	Return only records with a sales count estimate greater than this value	[optional]
salesCountEstimateLess	BigDecimal	Return only records with a sales count estimate less than this value	[optional]
salesStdDevEstimateGreater	BigDecimal	Return only records with a sales standard deviation greater than this value	[optional]
salesStdDevEstimateLess	BigDecimal	Return only records with a sales standard deviation less than this value	[optional]
pageSize	Integer	The number of results to return	[optional] [default to 100]
nextPage	String	Gets the next page of data from a previous API call	[optional]

Return Type

object

ApiResponseZacksSalesSurprises

Properties

Name	Type	Description
salesSurprises	List	Zacks Sales Surprise data for a Security in descending order by actual reported date
nextPage	String	The token required to request the next page of the data. If null, no further results are available.

object

ZacksSalesSurprise

Properties

Name	Type	Description
id	String	The Intrinio ID for the record
fiscalYear	BigDecimal	The company's fiscal year for the reported period
fiscalQuarter	String	The company's fiscal quarter for the reported period
calendarYear	BigDecimal	The closest calendar year for the company's fiscal year
calendarQuarter	String	The closest calendar quarter for the company's fiscal year
actualReportedDate	LocalDate	The actual report date for the earnings release
actualReportedTime	String	The actual report time for the earnings release
actualReportedCode	String	The code cooresponding to the earnings release BTO = BEFORE THE OPEN	DTM = DURING THE MARKET	AMC = AFTER MARKET CLOSE
actualReportedDesc	String	The description for the type of earnings release
lastRevDate	LocalDate	The last revision date for the analyst estimates
salesActual	BigDecimal	The actual Non-GAAP sales figure released by the company, interpreted by Zacks.
salesActualZacksAdj	BigDecimal	The adjustments Zacks made to get to Non-GAAP sales to reconcile with GAAP sales.
salesActualGaap	BigDecimal	The actual GAAP sales figured released by the company
salesMeanEstimate	BigDecimal	The pre-earnings release mean sales estimate for the company sales_count_estimate; the pre-earnings release number of estimates by analysts
salesAmountDiff	BigDecimal	The sales surprise amount difference
salesPercentDiff	BigDecimal	The sales surprise percent difference
salesStdDevEstimate	BigDecimal	The pre-earnings release standard deviation of sales estimates

Zacks Sales Surprises

SDKs

API Endpoints

Standardized & As-Reported Financial Statement Data

Company Reference & Metadata

Company News

Insider & Institutional Holdings Data

Upcoming & Historical IPOs

Raw Text Filings

XBRL Searchable Financial Statement Notes

Aggregate Standardized Financial Statement Data by SIC Codes

Economic Data

Security Reference Data

Real-Time Prices

Historical Intraday Prices

Historical End of Day Prices

Technical Indicators

Historical End of Day Index Prices

Reference & Metadata

Holdings

Returns & Analytics