Stock Earnings Filing Tracker

Track US company earnings filings from SEC EDGAR. Past rows are 8-K Item 2.02 filing dates, not necessarily the time the earnings release first appeared. Without a symbol filter, future rows are unconfirmed estimates based on the same fiscal-quarter filing 52 weeks earlier, aligned to the weekday. For supplied symbols, the actor also uses recent Item 2.02 filing intervals. A company-announced date explicitly found in an SEC 8-K Item 7.01/8.01 is marked confirmed; an already-filed Item 2.02 is marked reported. Check date_status, date_is_estimated, date_method, and the supporting source_url before using a date. SEC public filing content is free to access and reuse.

Quick start

{"mode":"upcoming","daysAhead":7,"limit":10}

Without symbols, the actor builds a dynamic company universe from the SEC's own 8-K filing search index (up to 2,000 matching prior-year documents per window). Supply symbols, for example ["AAPL", "MSFT"], to inspect specific SEC-listed companies. recent queries past filings; search queries a wider window. A company without a matching prior-year filing may be absent. SEC outages or a quiet date window may yield zero rows.

Output and limitations

The existing output keys are retained. EDGAR provides symbol, name, a filing-derived report_date, industry (SEC SIC description, where available), source_url, and date-relative fields. nextEarningsDate is populated from the report_date for future rows; date_status distinguishes estimated from confirmed dates.

SEC does not publish analyst consensus, a confirmed earnings announcement time, current quote/market cap, or stock sector. Accordingly eps_forecast, num_estimates, revenue_forecast_usd, market_cap_usd, sector, current_price_usd, pe_ratio, forward_pe, and consensus-based beat analytics remain null. For a released Item 2.02 filing only, eps_actual and revenue_actual_usd may be filled from an unambiguous company-authored Exhibit 99.1 statement in that filing; otherwise they remain null.

New, separate expectation fields are not consensus. eps_guidance_low/high, revenue_guidance_low/high, guidance_period, their *_source fields, and guidance_source_url come only from explicit forward ranges in a company's own SEC-filed Exhibit 99.1; guidance_basis distinguishes adjusted from unqualified EPS. eps_model_estimate uses the same calendar quarter's prior-year diluted EPS plus the latest observed year-over-year EPS change from SEC XBRL company-concept facts, with eps_model_source_url pointing to the source. eps_model_mae_8q is its rolling absolute-error mean over the latest eight observed quarters, with eps_model_backtest_n showing how many could be predicted. The model requires at least four backtested observations to publish an MAE; eps_surprise/eps_surprise_pct are computed against the model only when that MAE exists, and eps_surprise_source is then model:v1. A Q4 EPS value inferred as annual minus nine-month EPS is approximate. See ../../docs/discuss/stock_earnings_model_backtest.md.

timing is an estimated BMO/AMC classification from the company's historical SEC 8-K acceptance hours, with timing_status=estimated and timing_source=sec_acceptance_hour; it is not a confirmed earnings-release time. The SIC industry label is not mapped to a stock-market sector. The old enrichWithMarketData and includeGuide switches are accepted for compatibility but do not enable vendor data. A positive minMarketCapUsd or nonempty sectors filter therefore cannot match rows. Sorting by unavailable metrics falls back to date/symbol order.

Telegram alerts, when configured with your bot token and chat ID, label each date's status. The SUMMARY key-value record reports row counts and the source. The actor never requests data from a market-data provider whose terms prohibit redistribution.

Pricing

The actor keeps the existing pay-per-event names: apify-actor-start and earnings-tracked. The first 25 rows per account are a one-time free allowance; check the Store pricing tab for the current prices.

SEC fair-access rules require an identified User-Agent and a request rate below 10 per second. This actor serializes SEC requests with a short gap. Set SEC_CONTACT_EMAIL to the operator's own address when deploying under another operator; the default contact is the actor owner's address.