datasets_sec_companies_search
Search SEC-reporting companies by ticker, CIK, SIC, exchange, financials, filings, or insider activity to retrieve structured company profiles.
Instructions
Search the SEC companies dataset. Searches SEC-reporting companies — filing history, financial-statement rollups (latest annual/quarterly revenue, net income, total assets) and trailing-90-day insider (Form 3/4/5) activity. Sort enum: relevance, name_asc, revenue_desc, net_income_desc, filing_recent_desc, insider_activity_desc. entity_type, sic, sic_description, exchange, and state_of_incorporation are open filters over the exact values EDGAR reports for each filer (not a fixed enum) — discover real values via the matching facet. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Full-text query over the company name, or an exact ticker match, max 256 characters | |
| cik | No | Exact CIK filter, numeric or zero-padded, e.g. 320193 or 0000320193 | |
| sic | No | Exact SIC industry-code filter, e.g. 3571, max 32 characters | |
| page | No | Page number, defaults to 1 | |
| sort | No | Sort enum: relevance, name_asc, revenue_desc, net_income_desc, filing_recent_desc, insider_activity_desc | |
| ticker | No | Exact ticker filter (case-insensitive), e.g. AAPL, max 32 characters | |
| exchange | No | Exact exchange filter as reported by EDGAR, e.g. Nasdaq, NYSE, max 64 characters | |
| page_size | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 | |
| form_filed | No | Exact form-type filter; keeps only companies that have ever filed this form, e.g. 10-K, 8-K | |
| entity_type | No | Exact entity-type filter as reported by EDGAR (e.g. operating), max 64 characters | |
| max_revenue | No | Maximum latest-annual revenue in USD (normalized), 0 or greater | |
| min_revenue | No | Minimum latest-annual revenue in USD (normalized from the filer's reporting currency at reference rates), 0 or greater | |
| has_financials | No | When true, keep only companies that have XBRL financial statements | |
| min_net_income | No | Minimum latest-annual net income in USD (normalized; negative allowed) | |
| sic_description | No | Exact SIC description filter, e.g. Electronic Computers, max 128 characters | |
| min_total_assets | No | Minimum latest-annual total assets in USD (normalized), 0 or greater | |
| reporting_currency | No | Exact reporting-currency filter, ISO-4217 code, e.g. USD, JPY, EUR | |
| state_of_incorporation | No | Exact state/country-of-incorporation filter as reported by EDGAR, e.g. DE, CA, max 32 characters | |
| min_insider_txn_count_90d | No | Minimum insider (Form 3/4/5) transaction count in the trailing 90 days, 0 or greater |