screen_companies
Find US public companies whose latest-fiscal-year fundamentals match filters (minimum revenue, margins, ROE, growth; sector; profitable-only), sorted and limited. Returns a ranked list of companies with their key figures. Data traces to SEC EDGAR filings.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Match ticker prefix or company-name substring | |
| sort | No | Sort column; prefix with - for descending. e.g. -revenue (default), net_margin, -return_on_equity, revenue_growth | |
| limit | No | Max results, 1-100 (default 25) | |
| sector | No | One of: Agriculture, Mining, Construction, Manufacturing, Transportation & Utilities, Wholesale Trade, Retail Trade, Finance & Real Estate, Services, Public Administration | |
| roe_min | No | Minimum return on equity, percent | |
| profitable | No | Only companies with positive net income | |
| revenue_min | No | Minimum annual revenue, USD (e.g. 1000000000 for $1B) | |
| net_income_min | No | Minimum annual net income, USD | |
| net_margin_min | No | Minimum net margin, percent | |
| gross_margin_min | No | Minimum gross margin, percent (e.g. 40) | |
| total_assets_min | No | Minimum total assets, USD | |
| debt_to_equity_max | No | Maximum debt-to-equity ratio | |
| revenue_growth_min | No | Minimum year-over-year revenue growth, percent | |
| operating_margin_min | No | Minimum operating margin, percent |