{"uid":"cap_nfmiyPupq9KfIbtq9CnTl","slug":"stock-screener-sec-fundamentals-57e15a1d","name":"Stock Screener SEC Fundamentals","description":"Stock screener on SEC fundamentals: filter all US filers by revenue, net income, margins, cash flow, assets and 30 more XBRL metrics. Typical call $0.005: $0.002 per company returned, min $0.005. upto: pay only for delivered rows; exact: pays the quote (default 10 rows; set maxResults). Nothing is settled on an error or empty result. By Bosco Labs: official sources, source link per row.","url":"https://api.boscolabs.dev/v1/sec-company-screen?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"period":{"type":"string","pattern":"^\\s*[Cc][Yy]\\d{4}([Qq][1-4])?\\s*$","description":"Calendar period in SEC frames format: \"CY2025\" = annual figures, \"CY2025Q3\" = 3-month quarter..."},"sortBy":{"enum":["revenue","cost_of_revenue","gross_profit","research_and_development","selling_general_and_administrative","operating_profit","profit_before_tax","net_income","net_income_attributable_to_parent","eps_basic","eps_diluted","weighted_average_shares_basic","weighted_average_shares_diluted","depreciation_amortisation","total_assets","current_assets","cash_and_equivalents","total_liabilities","current_liabilities","noncurrent_liabilities","long_term_debt","total_equity","equity_attributable_to_parent","shares_outstanding","operating_cash_flow","investing_cash_flow","financing_cash_flow","capex","dividends_paid","free_cash_flow","ebitda","gross_margin","operating_margin","net_margin","return_on_equity","equity_ratio"],"type":"string","description":"Metric to rank by, e.g. \"operating_cash_flow\""},"filters":{"type":"array","items":{"type":"object","required":["metric"],"properties":{"metric":{"enum":["revenue","cost_of_revenue","gross_profit","research_and_development","selling_general_and_administrative","operating_profit","profit_before_tax","net_income","net_income_attributable_to_parent","eps_basic","eps_diluted","weighted_average_shares_basic","weighted_average_shares_diluted","depreciation_amortisation","total_assets","current_assets","cash_and_equivalents","total_liabilities","current_liabilities","noncurrent_liabilities","long_term_debt","total_equity","equity_attributable_to_parent","shares_outstanding","operating_cash_flow","investing_cash_flow","financing_cash_flow","capex","dividends_paid","free_cash_flow","ebitda","gross_margin","operating_margin","net_margin","return_on_equity","equity_ratio"],"type":"string","description":"Metric name, same names as sortBy, e.g. \"revenue\""}}},"description":"Conditions every company must meet, as a list of {metric, min, max}"},"metrics":{"type":"array","items":{"enum":["revenue","cost_of_revenue","gross_profit","research_and_development","selling_general_and_administrative","operating_profit","profit_before_tax","net_income","net_income_attributable_to_parent","eps_basic","eps_diluted","weighted_average_shares_basic","weighted_average_shares_diluted","depreciation_amortisation","total_assets","current_assets","cash_and_equivalents","total_liabilities","current_liabilities","noncurrent_liabilities","long_term_debt","total_equity","equity_attributable_to_parent","shares_outstanding","operating_cash_flow","investing_cash_flow","financing_cash_flow","capex","dividends_paid","free_cash_flow","ebitda","gross_margin","operating_margin","net_margin","return_on_equity","equity_ratio"],"type":"string"},"description":"More fields to show per company besides the sortBy and filter metrics"},"sortOrder":{"enum":["desc","asc"],"type":"string","default":"desc","description":"\"desc\" = largest first (top N), \"asc\" = smallest first (e.g. the lowest net margin)"},"maxResults":{"type":"integer","default":10,"maximum":200,"minimum":1,"description":"Most companies to return (and charge for), e.g. 20 for a top 20"},"tickersOnly":{"type":"boolean","default":false,"description":"true = skip companies without a ticker in the SEC's company_tickers.json"},"includeSources":{"type":"boolean","default":true,"description":"true = each row has `sources`: per value the XBRL tag, the SEC accession number and the filing URL"}}},"responseSchema":{"type":"json","example":{"rows":[{"cik":"0000320193","period":"CY2025","ticker":"AAPL","revenue":416161000000,"sources":{"revenue":{"tag":"us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax","url":"https://www.sec.gov/Archives/edgar/data/320193/000032019326000026/0000320193-...","accession":"0000320193-26-000026"},"net_income":{"tag":"us-gaap:NetIncomeLoss","url":"https://www.sec.gov/Archives/edgar/data/320193/000032019326000026/0000320193-...","accession":"0000320193-26-000026"},"net_margin":{"derived":"net_income / revenue"}},"currency":"USD","warnings":[],"net_income":112010000000,"net_margin":0.2692,"period_end":"2025-09-27","company_name":"Apple Inc.","period_start":"2024-09-29","retrieved_at":"2026-11-05T22:18:21+00:00","schema_version":"1"}],"tool":"sec-company-screen","count":1,"message":"","paid_via":"x402","warnings":[],"balance_usd":0,"charged_usd":0.04,"duration_seconds":1.2}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_F_Zk32qXQVFN5qvgSclbu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Screens all US SEC filers by financial fundamentals (revenue, net income, margins, cash flow, assets, and 30+ XBRL metrics) for a given calendar period, returning ranked company rows with official source links.","exampleAgentPrompt":"Screen all US SEC filers for the annual period CY2024, filter to companies with revenue above $500 million and a net margin above 15%, sort by free cash flow descending, and return the top 20 companies with their ticker, revenue, net income, and SEC source links.","exampleUseCases":[{"title":"Top profitable tech companies by FCF","prompt":"Show me the top 15 US public companies by free cash flow for the full year CY2023, but only include those with revenue over $1 billion and a net margin above 20% — include their tickers and SEC source links."},{"title":"Dividend payers with strong equity ratios","prompt":"Find US companies that paid more than $500 million in dividends in CY2023 and have an equity ratio above 40%, sorted by dividends paid descending. Give me the top 10 with their company names and tickers."},{"title":"Q3 earnings screen for profitable small caps","prompt":"I want to screen SEC filers for Q3 2024 — CY2024Q3 — that have operating profit above $50 million but revenue under $500 million, sorted by operating margin descending. Return up to 25 companies with their CIK, ticker, and margin figures."}],"resultDescription":"A JSON array of company rows, each containing CIK, ticker, company name, period, period start/end date, requested metric values (e.g. revenue, net income, net margin, FCF), currency, SEC source links with EDGAR accession numbers and XBRL tag names for each reported field, any warnings, plus top-level metadata: total count, amount charged in USD, duration, and schema version.","failureModes":["Invalid period format (must match CYYYYQn or CYYYY pattern) returns a 400 error","Unsupported metric name in filters or sortBy returns a 400 validation error","No companies match the filter criteria — returns empty rows array with no charge","SEC EDGAR data not yet available for requested period — empty result or warning","Overly restrictive filters yielding zero rows — no charge applied","Network or upstream SEC EDGAR outage returns a 5xx error with no charge"],"whenToPreferThis":"Use this endpoint when you need to screen or rank US public companies using official SEC-reported XBRL fundamentals (revenue, margins, cash flow, assets, debt, EPS, etc.) for a specific calendar year or quarter. It is preferable to third-party financial data vendors when you require verifiable, source-linked data directly traceable to SEC EDGAR filings. Choose it over general web search or LLM-generated financial summaries when you need structured, filterable, multi-metric fundamental data across the full universe of US filers with per-row source citations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-13T18:30:32.920Z","isFirstParty":false,"canonicalSlug":"stock-screener-sec-fundamentals-57e15a1d"}