Get Reporting Season
get_reporting_seasonFind busy and quiet weeks in public company reporting windows by viewing aggregate event counts per week or month. Filter by sector, country, exchange, and more to analyze reporting load distribution.
Instructions
Show how reporting load is distributed over time, so you can find the busy weeks and the quiet ones. Returns aggregate rows per bucket, not per company: period start and end, event count, company count, estimated share and mean confidence. Bucket by week or month with season_group_by, and optionally split by sector, country or exchange with season_split_by. The window defaults to today through 180 days out; set season_from and season_to for another. At least one filter is required and company identifiers are not accepted. Charged per aggregate row returned, which is far fewer rows than the companies behind them. 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. | |
| season_to | No | season mode. ISO date. Defaults to 180 days from today. | |
| event_types | No | full_year_results, half_year_results, quarterly_results, trading_update, annual_report_publication, sustainability_report_publication, agm, proxy_filing, capital_markets_day. | |
| season_from | No | season mode. ISO date. Defaults to today. | |
| 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. | |
| season_group_by | No | season mode. Bucket size. | |
| season_split_by | No | season mode. Optional second dimension. | |
| 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. |