screenCompaniesByMetric

Free

Screen all SEC-reporting companies on one financial metric for one calendar period (XBRL frames): e.g. the largest revenues in 2025, companies with over $1B cash at Q2 2026 end, or California companies by R&D spend. Each company contributes the reported value whose fiscal period best matches the calendar period. US GAAP filers only.

Try it

Open in playground

kirha tools run sec_screenCompaniesByMetric \
  --input '{
    "metric": "revenue",
    "year": 2009
  }'

Uses the key saved by kirha auth login.

metricstring, required
One of revenue, grossProfit, operatingIncome, netIncome, epsDiluted, researchAndDevelopment, operatingCashFlow, capitalExpenditure, cashAndEquivalents, totalAssets, totalLiabilities, stockholdersEquity, longTermDebt, sharesOutstanding
yearinteger, required, 2009 to 2030
limitnumber, default 25, 1 to 100
maxValuenumber
minValuenumber
quarterinteger, 1 to 4
Omit for the full year (balance-sheet metrics then use the year-end value)
sortOrderstring, default "desc"
One of desc, asc
statestring, 2 to 2 characters
US state of the company's business address, e.g. CA

Works in any harness

Get your API key, then install with one command