Yahoo Finance Earnings Calendar Scraper

Fast, API-first extraction of the public Yahoo Finance earnings calendar. The Actor requests Yahoo's current structured calendar response one date at a time, validates it before parsing, normalizes source-backed fields, applies filters, and writes the final dataset atomically.

Modes and inputs

• singleDate: collect one fromDate.
• dateRange: collect the inclusive fromDate–toDate range (maximum 31 days).
• Filter by exact ticker symbols, company text, earnings timing (BMO, AMC, and Yahoo's TAS/TNS time-not-supplied codes), reported/upcoming status, EPS estimate, and surprise percent.
• Sort by Yahoo rank, symbol, date, EPS estimate, or surprise. Fair allocation across dates prevents the first busy day from consuming a global limit.
• maxItems, maxItemsPerDate, concurrency, retry, timeout, language, region, and optional proxy controls are exposed.

Output

Records include a stable event ID, global/date positions, exact source date and ISO event time, time-zone offset, timing code/label, ticker, company, fiscal period, typed EPS values, derived EPS difference and beat/miss/met/pending status, Yahoo rank, event certainty, canonical Yahoo links, request context, extraction method, and scrape time. Unavailable optional fields are omitted rather than emitted as null, empty strings, or dashes.

Proxies and safety

Direct HTTP is the default. Apify Residential and custom HTTP proxies are supported. GOOGLE_SERP is rejected because it is intended for supported Google Search/Shopping HTTP requests, not Yahoo Finance. Requests use bounded retries and sessions; non-200, non-JSON, malformed, redirected, oversized, changed, or truncated payloads fail closed without partial dataset writes.

Limits

Yahoo currently allows up to 1,000 structured events per requested day. The Actor checks totalCount and fails rather than silently returning an incomplete day if Yahoo reports more records than it supplies. Target inventory and optional EPS fields vary by date. A small subset of global source events can omit companyShortName; those malformed entries are excluded because the Actor will not fabricate a company name from the ticker.