Earnings Calendar Scraper 📆

Bulk scraper focused on earnings-related data. It collects earnings calendars, upcoming earnings dates, and earnings history, then normalizes event times to UTC when possible and generates lightweight alerts.

✅ What You Get

• Earnings calendar: Raw calendar fields from the provider.
• Upcoming earnings dates: Structured rows of scheduled earnings dates.
• Earnings history: Historical EPS data when available.
• Normalized events: Standardized event types with UTC conversion when possible.
• Alerts: “Earnings week” flags and surprise/beat‑miss trend summary.

📦 Output Structure (per symbol)

{
  "symbol": "AAPL",
  "scraped_at": "2026-01-30T12:00:00+00:00",
  "earnings": {
    "calendar_raw": {"Earnings Date": ["2026-02-01T00:00:00-05:00"]},
    "calendar_events": [
      {
        "type": "earnings_date",
        "source": "calendar",
        "source_field": "Earnings Date",
        "date": "2026-02-01T00:00:00-05:00",
        "date_utc": "2026-02-01T05:00:00+00:00",
        "date_utc_assumed": false
      }
    ],
    "earnings_dates_request": {"limit": 12, "offset": 0},
    "earnings_dates": [
      {"Earnings Date": "2026-02-01T00:00:00-05:00", "EPS Estimate": 2.10}
    ],
    "earnings_dates_events": [
      {
        "type": "earnings_date",
        "source": "earnings_dates",
        "source_field": "Earnings Date",
        "date": "2026-02-01T00:00:00-05:00",
        "date_utc": "2026-02-01T05:00:00+00:00",
        "date_utc_assumed": false
      }
    ],
    "earnings_history": [
      {"quarter": "2025-11-01T00:00:00-04:00", "epsActual": 2.22, "epsEstimate": 2.10}
    ],
    "events": [
      {
        "type": "earnings_date",
        "source": "calendar",
        "source_field": "Earnings Date",
        "date": "2026-02-01T00:00:00-05:00",
        "date_utc": "2026-02-01T05:00:00+00:00",
        "date_utc_assumed": false
      }
    ],
    "alerts": {
      "earnings_week": {
        "window_days": 7,
        "count": 1,
        "has_upcoming": true,
        "upcoming": [
          {
            "date": "2026-02-01T00:00:00-05:00",
            "date_utc": "2026-02-01T05:00:00+00:00",
            "date_utc_assumed": false,
            "source": "calendar",
            "source_field": "Earnings Date"
          }
        ]
      },
      "surprise": {
        "latest": {"value": 5.7, "unit": "percent", "based_on": "actual_minus_estimate"},
        "previous": {"value": 3.2, "unit": "percent", "based_on": "surprise_pct"},
        "change": 2.5
      },
      "beat_miss_trend_last_4": ["beat", "beat", "miss", "beat"]
    }
  }
}

Notes:

• date_utc_assumed: true means the provider supplied a date without timezone; the scraper assumed UTC for comparison.
• Missing data is expected (availability can vary by ticker).

⚙️ Input

{
  "symbols": ["AAPL", "MSFT", "TSLA"],
  "earnings_dates_limit": 12,
  "earnings_dates_offset": 0,
  "earnings_alert_window_days": 7
}

Parameters

• symbols: List of stock symbols (or comma‑separated string).
• earnings_dates_limit: Max rows for earnings dates. Default 12.
• earnings_dates_offset: Offset for earnings dates. Default 0.
• earnings_alert_window_days: Window for “earnings week” alerts. Default 7 days.

Ready to monitor earnings? Click “Try for free” to start.