The Earnings Analysis API: Track What Changed in a Company's SEC Filings

Risk-factor language is written by lawyers and changes reluctantly. That is precisely what makes it useful: when a company rewrites large parts of that section, it is often the earliest public signal of a newly disclosed risk.

Today we are documenting the Earnings Analysis API, and its anchor endpoint is What Changed, live now at /api/v1/stocks/{ticker}/what-changed.

What does the What Changed endpoint return?

What Changed compares the Item 1A Risk Factors section of each new 10-K or 10-Q against the company's prior filing of the same form, and returns excerpts of the passages that were added, removed, or modified along with a 0 to 1 materiality score.

Each entry carries:

• formType, filedAt, and reportDate
• materialityScore: how much the section moved versus the prior filing of the same form
• noMaterialChanges: true when the filer states the section is unchanged
• edgarUrl: the filing on the SEC public filing system
• diff: excerpts of the changed passages (up to 400 characters each), paragraph and character counts, changed and novelty ratios, and the most distinctive new terms

curl -H "X-SentiSense-API-Key: ss_live_YOUR_KEY" \
  "https://app.sentisense.ai/api/v1/stocks/AAPL/what-changed?limit=1"

Comparisons are deterministic. Trivial rewording is ignored; changed numbers never are.

Why diff filings instead of reading them?

A 10-K runs to hundreds of pages, and most of it is identical to last year's. Reading it end to end to find the twelve paragraphs that moved is the part nobody has time for, and it is the part a diff does perfectly.

The output is the short list: what is new, what was dropped, what was rewritten, and which terms appear now that did not before. Rank a watchlist by materiality score to see who revised most heavily this quarter, or pull the before and after excerpts directly for research and summarization.

Coverage is roughly 500 large-cap US companies, including 99% of the S&P 500 plus widely followed software and semiconductor names outside the index. It tracks 10-K and 10-Q Risk Factors and returns up to about three sequential comparisons per form, nearly all of them with full diff detail. The exception is structural: the earliest filing on record for a form has nothing before it, so it returns the summary fields alone. New filings are typically reflected within 48 hours, and tickers outside the covered set return a successful, empty response rather than an error.

What is free

Every call requires an API key. On a free key you get the per-filing summary for each comparison: form type, filing and report dates, section, materiality score, the no-material-changes flag, and the EDGAR link, plus a totalCount of how many comparisons exist. That is enough to rank a watchlist and find the filings worth reading.

PRO unlocks the diff object: excerpts of the changed passages, the ratios, and the new terms.

{
  "isPreview": true,
  "previewReason": "PRO_REQUIRED",
  "totalCount": 7,
  "data": [ { "formType": "10-K", "materialityScore": 0.71 } ]
}

What does the earnings analysis report return?

The diff tells you what management rewrote. The earnings analysis report tells you what the company reported, at /api/v1/stocks/{ticker}/earnings-summaries.

It returns one object per fiscal quarter, newest first, each carrying the editorial headline, the KPI highlights that matter for that company with year-over-year deltas, the guidance language as management phrased it, and a summary of the earnings call. It is the readout the SentiSense app itself renders, in one call rather than four.

curl -H "X-SentiSense-API-Key: ss_live_YOUR_KEY" \
  "https://app.sentisense.ai/api/v1/stocks/NVDA/earnings-summaries?limit=4"

A free key gets the latest quarter, shaped rather than truncated: fiscal period, report date, headline, up to two KPI cards, and the section titles of what sits inside. PRO returns every stored quarter in full. A quarter typically appears within 48 hours of the company reporting, and the call summary can arrive after the press-release content, so read generatedAt instead of assuming a fixed lag.

Its companion answers the cross-ticker question. /api/v1/earnings/recent returns who in the covered set reported on or after a given day, newest first, up to 31 days back. Find who printed this week, then pull each quarter's analysis. Any API key gets the full window it asks for, with no tier gate.

Both endpoints are in the Python and Node SDKs.

The rest of the earnings family

An earnings event is a lifecycle, not a moment, and the API follows it end to end:

• Earnings Calendar tells you who reports and when, with session timing, fiscal quarter, confirmation status, and consensus EPS.
• What Changed tells you what management altered in its own filings.
• The earnings analysis report and the recently-reported feed tell you what the quarter said once it lands.
• Fundamentals and company KPIs give you the reported numbers, including curated non-GAAP metrics pulled from filings and press releases.
• Analyst estimates carry forward EPS and beat/miss history.
• Insights surfaces the takeaway as AI-generated signals, including earnings-driven types.

The quarter is the unit that ties them together: a filing diff belongs to the quarter it covers, and consensus EPS from the Calendar is the anchor a headline beats or misses.

An agent skill, stock-earnings-analysis, walks the family in that order, so an assistant can answer "how did Nvidia's last quarter go, and what changed in the filing?" against real disclosures instead of guessing:

npx skills add SentiSenseApp/skills

Start here:

• API reference: sentisense.ai/docs/api/earnings
• Full agent skill: sentisense.ai/skill.md

No sign-up required to read the docs. Get an API key and run your first diff →

SentiSense is a product of SentiSense Labs LLC. This endpoint reports factual differences between public SEC filings for informational purposes only, not investment advice.