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",
      "earnings_per_share": 123
    }
  ]
}

​
👋 Overview

This API provides earnings per share 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 providers like Morningstar, S&P Global, etc.

​
📊 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

Response

Analyst estimates response

​
analyst_estimates
object[]