Skip to main content
GET
/
analyst-estimates
Analyst Estimates
curl --request GET \
  --url https://api.financialdatasets.ai/analyst-estimates \
  --header 'X-API-KEY: <api-key>'
{
  "analyst_estimates": [
    {
      "fiscal_period": "2023-12-25",
      "period": "annual",
      "revenue": 123,
      "earnings_per_share": 123
    }
  ]
}

​
Overview

This API provides earnings per share (EPS) and revenue estimates for a given ticker. The data is generated from our own internal models and should be considered as probabilistic forecasts, not guarantees of future performance. Our mean estimates track consensus closely, with an average deviation of less than 1% compared to leading sell-side consensus providers.

​
Parameters

  • ticker (required) — the stock ticker symbol (e.g., AAPL, NVDA)
  • period (optional) — annual or quarterly (default: annual)
  • limit (optional) — max number of estimates to return (max 3 for annual, 12 for quarterly)

​
Available Tickers

You can fetch a list of available tickers with a GET request to: https://api.financialdatasets.ai/analyst-estimates/tickers/

​
Example

Analyst Estimates
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
ticker = 'AAPL'
period = 'annual'         # possible values are {'annual', 'quarterly'}

# create the URL
url = (
    f'https://api.financialdatasets.ai/analyst-estimates/'
    f'?ticker={ticker}'
    f'&period={period}'
)

# make API request
response = requests.get(url, headers=headers)

# parse estimates from the response
estimates = response.json().get('analyst_estimates')

Authorizations

​
X-API-KEY
string
header
required

API key for authentication.

Query Parameters

​
ticker
string
required

The ticker to get analyst estimates for.

​
period
enum<string>

The period to get analyst estimates for. Use the /analyst-estimates/periods endpoint to get a list of available periods. Defaults to 'annual'.

Available options:
annual,
quarterly
​
limit
integer

The maximum number of estimates to return (max 3 for annual, 12 for quarterly).

Response

Analyst estimates response

​
analyst_estimates
object[]