Build Company Universe
build_company_universeFilter public companies by exchange, region, sector, and more to build a custom universe. Returns 44 fields per company, using criteria instead of identifiers.
Instructions
Build a list of listed companies from filters rather than from identifiers you already hold. Filter by exchange, country, region, sector, security type, public float band, fiscal year end month, reporting cadence, operating status and foreign private issuer status. Returns 44 fields per company, the same shape resolve_company returns. At least one filter is required, so a bare call cannot pull the whole universe. This tool does NOT accept company identifiers: use resolve_company, qualify_company or get_reporting_timing for specific companies. SET limit EXPLICITLY. It defaults to 1000 and you are charged per company row returned, so an unbounded call is an expensive call. Truncation is always reported, never silent. Requires an APIFY_TOKEN and consumes Apify credits. Read only.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows for universe and season. Truncation is always reported, never silent. | |
| regions | No | Shorthand for a set of venues and countries: us, uk, eu. Widens an explicit exchange or country filter rather than replacing it. | |
| sectors | No | SEC SIC descriptions, e.g. Pharmaceutical Preparations. Populated on roughly 65 percent of the publishable universe. | |
| cadences | No | quarterly, semiannual, annual, unknown. | |
| country_codes | No | ISO 3166-1 alpha-2, e.g. US, GB, FR. | |
| exchange_codes | No | ISO 10383 MICs. 18 venues are covered. | |
| security_types | No | ordinary_shares, depositary_receipt, preferred_shares. | |
| public_float_bands | No | micro, small, mid, large, mega, unknown. Size runs on public float because market capitalization is not populated anywhere in this dataset. | |
| us_registrant_only | No | Keep only companies carrying an SEC CIK. | |
| exclude_share_alike | No | Drop rows derived from CC BY-SA sources, whose share alike condition may not suit a closed product. | |
| exclude_blank_checks | No | Drop pre deal SPACs. Separate from the operating company filter: a blank check shell is flagged as an operating company and passes every ordinary firmographic filter. | |
| fiscal_year_end_months | No | Integers 1 to 12. Fiscal year end is effectively a United States field in this dataset. | |
| foreign_private_issuer | No | Filter on foreign private issuer status. | |
| operating_companies_only | No | Drop funds, trusts and other non operating entities. Sent as a string for Clay compatibility. | |
| exclude_name_only_matches | No | Drop rows whose identity link rests on a name and country agreeing rather than on an identifier. Use this wherever a wrong identity link matters. | |
| min_provenance_confidence | No | Set to high to exclude rows whose source terms were never read. | |
| exclude_december_fiscal_year_end | No | Keep only companies whose fiscal year ends in a month other than December, the accounts whose budget cycle is out of phase with a calendar quarter. |