Analyst Estimates API
Last updated:
Track Wall Street consensus estimates for revenue and earnings per share (EPS) across annual and quarterly periods. Each response pairs forward-looking projections with reported actuals — including high, low, and consensus values for every period — so you can measure beats, misses, and estimate accuracy in a single API call. Business Quant sources these estimates and updates them as new analyst projections are published. The API is free to use.
Two estimate modes available:
https://data.businessquant.com/estimates?{identifier}&mode={mode}&api_key={api_key}
Related endpoints: Pair estimates with the Financial Statements API to compare projections against reported financials. Use the Company Profile API to resolve tickers and CIKs before querying estimates. Filter the universe first with the Stock Screener API, then pull estimates for the results.
1. Request Parameters
Provide an API key and exactly one identifier — either a ticker symbol or a CIK number — to retrieve consensus estimates. Use the mode parameter to switch between revenue and EPS projections. Each response includes both annual and quarterly periods, with reported actuals and forward estimates returned side by side.
| Parameter | Description |
|---|---|
| api_key |
Required
Your unique API key for authentication.
|
| ticker |
Conditional
Identifier
Stock Ticker. (Provide either this or cik).
Format:
ticker=SPOT |
| cik |
Conditional
Identifier
CIK Number. (Provide either this or ticker).
Format:
cik=1639920 |
| mode |
Optional
Estimate metric to retrieve. Valid values: revenue, eps. Defaults to revenue.
Format:
mode=eps |
curl -X GET "https://data.businessquant.com/estimates?ticker=SPOT&mode=eps&api_key=YOUR_API_KEY"
2. Sample Response
The viewer below shows a live sample response for Spotify's EPS estimates. The Table view renders annual and quarterly sections with reported actuals alongside consensus, high, and low projections. Rows where data_type is "estimate" represent forward projections and are highlighted in yellow; "reported" rows include the actual reported value. Switch to JSON to inspect the raw response structure.
Spotify Technology — EPS Estimates
Ticker: SPOT •
CIK: 1639920 •
Mode: eps •
9 annual + 15 quarterly periods
Annual Estimates
| Period | Type | Consensus | Reported | High | Low |
|---|---|---|---|---|---|
| 2021 | Reported | -0.98 | -0.20 | -1.06 | -0.90 |
| 2022 | Reported | -2.44 | -3.14 | -2.62 | -2.26 |
| 2023 | Reported | -2.91 | -3.01 | -3.03 | -2.79 |
| 2024 | Reported | 6.36 | 5.69 | 6.75 | 5.97 |
| 2025 | Reported | 8.98 | 12.34 | 9.36 | 8.60 |
| 2026 | Estimate | 15.77 | — | 17.09 | 14.45 |
| 2027 | Estimate | 18.31 | — | 19.72 | 16.90 |
| 2028 | Estimate | 21.56 | — | 22.78 | 20.34 |
| 2029 | Estimate | 23.34 | — | 24.18 | 22.50 |
Quarterly Estimates
| Period | Type | Consensus | Reported | High | Low |
|---|---|---|---|---|---|
| Q1 24 | Reported | 0.64 | 1.05 | 0.68 | 0.60 |
| Q2 24 | Reported | 1.09 | 1.42 | 1.18 | 1.00 |
| Q3 24 | Reported | 1.77 | 1.61 | 1.94 | 1.60 |
| Q4 24 | Reported | 2.00 | 1.82 | 2.20 | 1.80 |
| Q1 25 | Reported | 2.31 | 1.16 | 2.51 | 2.11 |
| Q2 25 | Reported | 2.38 | -0.49 | 2.57 | 2.19 |
| Q3 25 | Reported | 2.44 | 3.85 | 2.63 | 2.25 |
| Q4 25 | Reported | 3.12 | 5.20 | 3.39 | 2.85 |
| Q1 26 | Estimate | 3.54 | — | 3.82 | 3.26 |
| Q2 26 | Estimate | 3.50 | — | 3.75 | 3.25 |
| Q3 26 | Estimate | 3.80 | — | 4.18 | 3.42 |
| Q4 26 | Estimate | 4.25 | — | 4.43 | 4.07 |
| Q1 27 | Estimate | 3.79 | — | 4.09 | 3.49 |
| Q2 27 | Estimate | 4.07 | — | 4.40 | 3.74 |
| Q3 27 | Estimate | 4.25 | — | 4.53 | 3.97 |
3. Response Field Reference
Every estimate row — whether annual or quarterly, reported or forward — uses the same field structure. The data_type field tells you whether the row contains a completed result with an actual reported value or a forward-looking projection.
| Field | Type | Description |
|---|---|---|
| period | string |
Fiscal period label. Annual uses "2024", "2025", etc. Quarterly uses "Q1 24", "Q2 24", etc. |
| sno | integer |
Sequential ordering index within the dimension (1, 2, 3, …). Use this to maintain chronological sort order. |
| data_type | string |
"reported" — period has concluded; actual reported value is available. "estimate" — forward-looking period; reported value is null. |
| value_estimate | number |
Consensus (mean) analyst estimate. For revenue mode, this is in raw currency units (e.g., 19026551250.0). For EPS mode, this is per-share (e.g., 8.98). |
| value_reported | number|null |
Actual reported value. Non-null only when data_type is "reported". Compare against value_estimate to compute the surprise. |
| high_estimate | number |
Highest individual analyst estimate for the period. |
| low_estimate | number |
Lowest individual analyst estimate for the period. |
Revenue & EPS Estimate Request Examples
Copy any request below directly into your application, replacing YOUR_API_KEY with your credentials. Both variations return the same JSON schema — only the estimate metric changes based on the mode parameter.
https://data.businessquant.com/estimates?ticker=SPOT&mode=revenue&api_key=YOUR_API_KEY
https://data.businessquant.com/estimates?ticker=SPOT&mode=eps&api_key=YOUR_API_KEY
https://data.businessquant.com/estimates?cik=1639920&mode=eps&api_key=YOUR_API_KEY
Frequently Asked Questions
What estimate metrics does this API provide?
The API returns consensus estimates for two metrics: revenue and earnings per share (EPS). Each estimate includes the consensus value, high estimate, low estimate, and — for past periods — the actual reported value, so you can calculate beats and misses in the same response.
Does the API return both annual and quarterly estimates?
Yes. Every response contains two sections: annual estimates spanning multiple fiscal years and quarterly estimates spanning individual quarters. Both reported (historical) and forward-looking estimate periods are included in the same payload.
How far forward do the estimates extend?
Forward estimates typically extend 3 to 4 fiscal years ahead for annual periods and 6 to 8 quarters ahead for quarterly periods, depending on analyst coverage for each company.
Can I look up estimates by CIK instead of ticker?
Yes. The API accepts either a ticker symbol or a SEC Central Index Key (CIK) as the company identifier. This is useful for programmatic workflows that already reference companies by CIK from other SEC-related endpoints.
Is the Analyst Estimates API free to use?
Yes, the Analyst Estimates API is free to use. Sign up for an API key to start pulling consensus revenue and EPS estimates immediately.