Quarterly Earnings Monitor

Quarterly Earnings Monitor turns public-company ticker lists into clean quarterly earnings rows with revenue, net income, diluted EPS, gross margin, operating cash flow, and trend signals. It is built for recurring watchlist monitoring during earnings season: one row per company per fiscal quarter, with simple options for latest quarter through long quarterly history.

The actor focuses on quarterly filings for public companies covered by SEC EDGAR XBRL data. It does not ask users to choose sources or parser settings; you provide tickers and a quarter range, and the actor returns normalized metrics plus buyer-facing signals.

Why use this actor

• Track quarterly earnings across a watchlist without building SEC XBRL plumbing.
• Compare recent quarters using YoY and QoQ revenue movement.
• Spot acceleration, declines, margin pressure, net losses, and cash-flow issues.
• Feed investor research, newsletters, corp dev screening, sales intelligence, or internal dashboards.
• Run the same watchlist every earnings season and append the rows to your own dataset.

What it returns

Each dataset row represents one ticker and one fiscal quarter. The actor returns:

• company and fiscal quarter identifiers
• filing and period-end dates
• revenue, net income, diluted EPS, gross profit, gross margin, operating income, and operating cash flow when available
• revenue QoQ and YoY percentages
• net income and EPS YoY percentages
• quarterSignalScore from 0 to 100
• growthSignal, profitabilitySignal, and cashSignal

The dataset intentionally avoids exposing internal source URLs, raw XBRL tags, source IDs, or debug telemetry. Operational details stay in RUN_SUMMARY.

Use cases

Investor watchlists: monitor 20-50 tickers every quarter and export a normalized table for screening, charting, or commentary.

Financial newsletters: prepare earnings-season tables with recent quarterly trends that point editors toward companies worth writing about.

Sales intelligence: watch target accounts for growth acceleration, revenue declines, cash pressure, or profitability changes before enterprise sales outreach.

Corp dev and competitive tracking: compare public competitors across the same fiscal-quarter row shape without manually downloading filings.

Input

The actor has two core inputs:

{
  "tickers": ["AAPL", "MSFT", "NVDA"],
  "period": "last_4_quarters"
}

tickers

Array of public company ticker symbols, for example AAPL, MSFT, NVDA, AMZN, or TSLA. The actor resolves tickers to SEC company identifiers internally.

period

How many recent fiscal quarters to return for each ticker:

• latest_quarter
• last_2_quarters
• last_4_quarters
• last_8_quarters
• last_12_quarters
• last_20_quarters
• last_40_quarters

All options are quarterly. The actor does not switch to annual rows for longer periods.

Optional pipeline fields

datasetId appends the same rows to a dataset you provide. runId is copied into output rows so you can join the results with your own workflow metadata.

Output example

{
  "ticker": "AAPL",
  "companyName": "Apple Inc.",
  "fiscalYear": 2026,
  "fiscalPeriod": "Q2",
  "periodEndDate": "2026-03-28",
  "filingDate": "2026-05-01",
  "form": "10-Q",
  "revenue": 95359000000,
  "revenueQoQPercent": 2.3,
  "revenueYoYPercent": 5.1,
  "netIncome": 24780000000,
  "netIncomeYoYPercent": 4.8,
  "dilutedEps": 1.57,
  "epsYoYPercent": 7.5,
  "grossProfit": 44400000000,
  "grossMarginPercent": 46.56,
  "operatingIncome": 29500000000,
  "operatingCashFlow": 28500000000,
  "quarterSignalScore": 82,
  "growthSignal": "accelerating",
  "profitabilitySignal": "stable",
  "cashSignal": "strong"
}

API usage

Start a run:

curl -X POST "https://api.apify.com/v2/acts/trovevault~quarterly-earnings-monitor/runs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -d '{
    "tickers": ["AAPL", "MSFT", "NVDA"],
    "period": "last_4_quarters"
  }'

Fetch dataset items after the run finishes:

curl "https://api.apify.com/v2/datasets/DATASET_ID/items" \
  -H "Authorization: Bearer $APIFY_TOKEN"

How the signals work

The score is a compact directional signal, not investment advice. It weighs revenue growth, sequential revenue pressure, gross-margin movement, net income, and operating cash flow when those fields are available. cashSignal is null when quarterly operating cash flow is not reported or cannot be derived from comparable year-to-date filings.

Missing values are left as null when a company does not report a comparable quarterly fact. The actor avoids fabricating metrics from unsupported fields.

Limitations

• Coverage is strongest for public companies with SEC EDGAR XBRL filings.
• This actor is quarterly-only. Longer ranges return more quarterly rows, not annual summaries.
• Some companies use reporting concepts that do not map cleanly to every metric. Those fields may be null.
• Q4 revenue, net income, gross profit, operating income, and operating cash flow may be derived from full-year filings when Q1-Q3 comparable quarterly values are available. Diluted EPS is not derived this way.
• The actor does not include analyst estimates, earnings surprise, transcripts, guidance, or non-GAAP adjustments.
• The output is for research and monitoring workflows, not financial advice.

Troubleshooting

Ticker returns no rows: check that the ticker appears in SEC company ticker data and has recent XBRL filings.

Some metrics are null: the company may not report that concept in a comparable quarterly XBRL fact, or the metric may use a company-specific extension that is not normalized yet.

Long periods return fewer rows than requested: the company may have less quarterly history available in comparable XBRL facts.

Rows appear after a filing delay: public filings can arrive and be processed at different times during earnings season. Re-run the actor later if a very recent filing is not yet reflected.

FAQ

Does this work for non-US companies?
Only when the company is covered by SEC EDGAR XBRL filings in a way the actor can normalize. The first version is intentionally SEC-first.

Can I request custom date ranges?
Not in the MVP. Use the predefined quarterly ranges so Store runs stay predictable and comparable.

Does it expose the raw source link?
No. The public dataset focuses on the normalized decision layer. Run diagnostics are stored in RUN_SUMMARY.

Can I use this with MCP or downstream agents?
Yes. Run it on a schedule, fetch the dataset through the Apify API, or pass rows into your own MCP-enabled research workflow.

Related actors

Use this actor alongside watchlist, market-intelligence, CRM enrichment, and reporting workflows when quarterly financial movement should influence prioritization.

Changelog

0.1

• Initial quarterly-only SEC EDGAR XBRL implementation.
• Supports latest quarter through last 40 quarters.
• Adds revenue, EPS, margin, cash-flow, trend, and score fields.

Feedback and support

Open an issue on the actor page with example tickers and the quarter range you used. Include what field looked missing or surprising so the normalization can be improved with a concrete case.