Market data and fundamentals

Analyst estimates and revisions

Consensus estimates and their recorded revisions by company and fiscal period

2 endpointsFrom 4 credits

Try it

curl https://api.gloom.sh/v1/analyst-estimates/AAPL \
  -H "Authorization: Bearer $GLOOM_DATASETS_KEY"

import os
import requests

response = requests.get(
    "https://api.gloom.sh/v1/analyst-estimates/AAPL",
    headers={"Authorization": f"Bearer {os.environ['GLOOM_DATASETS_KEY']}"},
)
response.raise_for_status()
print(response.json())

const response = await fetch(
  "https://api.gloom.sh/v1/analyst-estimates/AAPL",
  { headers: { Authorization: `Bearer ${process.env.GLOOM_DATASETS_KEY}` } },
)
if (!response.ok) throw new Error(await response.text())
console.log(await response.json())

Response

{
  "data": {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "currency": "USD",
    "exchange": "NasdaqGS",
    "priceTarget": {
      "high": 405,
      "median": 340,
      "low": 215,
      "average": 328.09384,
      "current": 339.345,
      "currency": "USD"
    },
    "recommendationRating": 6.988625,
    "recommendations": [
      {
        "period": "current month",
        "strongBuy": 6,
        "buy": 19,
        "hold": 13,
        "sell": 3,
        "strongSell": 3
      },
      {
        "period": "last month",
        "strongBuy": 6,
        "buy": 19,
        "hold": 13,
        "sell": 3,
        "strongSell": 3
      },
      // … 2 more items
    ],
    "ratings": [
      {
        "date": "2026-10-01",
        "firm": "Morgan Stanley",
        "action": "Lowers",
        "current": "Overweight",
        "prior": "Overweight"
      },
      {
        "date": "2026-10-01",
        "firm": "Needham",
        "action": "Reiterated",
        "current": "Hold",
        "prior": "Hold"
      },
      // … 98 more items
    ],
    "earningsEstimates": [
      {
        "date": "2026-09-30",
        "period": "current quarter",
        "analysts": 27,
        "currency": "USD",
        "average": 1.97865,
        "low": 1.93,
        "high": 2.07,
        "yearAgo": 1.85,
        "growth": 0.0695,
        "revisions": {
          "up7Days": 1,
          "down7Days": 0,
          "up30Days": 7,
          "down30Days": 14,
          "currency": "USD"
        },
        "trend": {
          "current": 1.97865,
          "sevenDaysAgo": 1.97754,
          "thirtyDaysAgo": 1.97656,
          "sixtyDaysAgo": 1.97549,
          "ninetyDaysAgo": 2.00836
        },
        "trendCurrency": "USD"
      },
      {
        "date": "2026-12-31",
        "period": "next quarter",
        "analysts": 22,
        "currency": "USD",
        "average": 2.90586,
        "low": 2.56,
        "high": 3.42,
        "yearAgo": 2.84,
        "growth": 0.0232,
        "revisions": {
          "up7Days": 0,
          "down7Days": 1,
          "up30Days": 1,
          "down30Days": 2,
          "currency": "USD"
        },
        "trend": {
          "current": 2.90586,
          "sevenDaysAgo": 2.90313,
          "thirtyDaysAgo": 2.89268,
          "sixtyDaysAgo": 2.90908,
          "ninetyDaysAgo": 2.94829
        },
        "trendCurrency": "USD"
      },
      // … 2 more items
    ],
    "revenueEstimates": [
      {
        "date": "2026-09-30",
        "period": "current quarter",
        "analysts": 27,
        "currency": "USD",
        "average": 113624521680,
        "low": 112248100000,
        "high": 117219700000,
        "yearAgo": 102466000000,
        "growth": 0.1089
      },
      {
        "date": "2026-12-31",
        "period": "next quarter",
        "analysts": 19,
        "currency": "USD",
        "average": 154392842060,
        "low": 131500061129,
        "high": 170414000000,
        "yearAgo": 143756000000,
        "growth": 0.074
      },
      // … 2 more items
    ],
    "fetchedAt": "2026-10-08T17:00:18.118Z"
  },
  "meta": {
    "dataset": "analyst-estimates",
    "requestId": "sample-request",
    "asOf": null,
    "dataThrough": "2026-10-08T17:00:18.118Z",
    "historyStart": null,
    "updatedAt": "2026-10-08T17:00:18.118Z",
    "page": null,
    "next": null,
    "coverage": null,
    "source": [
      {
        "attribution": "Exchange and market data providers"
      }
    ]
  }
}

Trimmed · 2026-10-08

Run it without a key: GET /v1/datasets/analyst-estimates/sample

Endpoints

GET/v1/analyst-estimates/{symbol}10 creditsAnalyst earnings and revenue estimates

Parameters

symbolstringrequired: Company symbol; normalized to uppercase.
exchangestring

GET/v1/analyst-estimates/{symbol}/revisions4 creditsAnalyst estimate revision history

Parameters

symbolstringrequired: Company symbol; normalized to uppercase.
exchangestring
fromstring: Calendar date: YYYY-MM-DD.
tostring: Calendar date: YYYY-MM-DD.

from must be on or before to.