--- title: "Stocks & Funds Screener" method: POST path: "/v1/company-screener/query" tags: ["Company & Events"] --- # Stocks & Funds Screener `POST /v1/company-screener/query` The Company Screener API enables advanced filtering and discovery of companies based on comprehensive financial and descriptive criteria. Filter companies by market capitalization, stock price, beta, trading volume, dividend yield, sector, industry, country, exchange, and trading status. Perfect for investment research, portfolio construction, and market analysis. ## Request body - CompanyScreenerQuery — Allows filtering companies based on various financial and descriptive criteria. - `filters` CompanyScreenerFilters — Filters for the company screener request. - `market_cap_more_than` integer, nullable — Minimum market capitalization in USD. - `market_cap_lower_than` integer, nullable — Maximum market capitalization in USD. - `price_more_than` number, nullable — Minimum stock price in USD. - `price_lower_than` number, nullable — Maximum stock price in USD. - `beta_more_than` number, nullable — Minimum beta value. - `beta_lower_than` number, nullable — Maximum beta value. - `volume_more_than` integer, nullable — Minimum trading volume. - `volume_lower_than` integer, nullable — Maximum trading volume. - `dividend_more_than` number, nullable — Minimum annual dividend in USD. - `dividend_lower_than` number, nullable — Maximum annual dividend in USD. - `is_etf` boolean, nullable — Whether to include ETFs in the results. - `is_fund` boolean, nullable — Whether to include mutual funds in the results. - `is_actively_trading` boolean, nullable — Whether to include only actively trading stocks. - `sector` union — Sector of the company. - 'Basic Materials' | 'Communication Services' | 'Consumer Cyclical' | 'Consumer Defensive' | 'Energy' | 'Financial Services' | 'Healthcare' | 'Industrials' | 'Real Estate' | 'Technology' | 'Utilities' — Sector enum for public API. - string - `industry` union — Industry of the company. - 'Steel' | 'Silver' | 'Other Precious Metals' | 'Gold' | 'Copper' | 'Aluminum' | 'Paper, Lumber & Forest Products' | 'Industrial Materials' | 'Construction Materials' | 'Chemicals - Specialty' | 'Chemicals' | 'Agricultural Inputs' | 'Telecommunications Services' | 'Internet Content & Information' | 'Publishing' | 'Broadcasting' | 'Advertising Agencies' | 'Entertainment' | 'Travel Lodging' | 'Travel Services' | 'Specialty Retail' | 'Luxury Goods' | 'Home Improvement' | 'Residential Construction' | 'Department Stores' | 'Personal Products & Services' | 'Leisure' | 'Gambling, Resorts & Casinos' | 'Furnishings, Fixtures & Appliances' | 'Restaurants' | 'Auto - Parts' | 'Auto - Manufacturers' | 'Auto - Recreational Vehicles' | 'Auto - Dealerships' | 'Apparel - Retail' | 'Apparel - Manufacturers' | 'Apparel - Footwear & Accessories' | 'Packaging & Containers' | 'Tobacco' | 'Grocery Stores' | 'Discount Stores' | 'Household & Personal Products' | 'Packaged Foods' | 'Food Distribution' | 'Food Confectioners' | 'Agricultural Farm Products' | 'Education & Training Services' | 'Beverages - Wineries & Distilleries' | 'Beverages - Non-Alcoholic' | 'Beverages - Alcoholic' | 'Uranium' | 'Solar' | 'Oil & Gas Refining & Marketing' | 'Oil & Gas Midstream' | 'Oil & Gas Integrated' | 'Oil & Gas Exploration & Production' | 'Oil & Gas Equipment & Services' | 'Oil & Gas Energy' | 'Oil & Gas Drilling' | 'Coal' | 'Shell Companies' | 'Investment - Banking & Investment Services' | 'Insurance - Specialty' | 'Insurance - Reinsurance' | 'Insurance - Property & Casualty' | 'Insurance - Life' | 'Insurance - Diversified' | 'Insurance - Brokers' | 'Financial - Mortgages' | 'Financial - Diversified' | 'Financial - Data & Stock Exchanges' | 'Financial - Credit Services' | 'Financial - Conglomerates' | 'Financial - Capital Markets' | 'Banks - Regional' | 'Banks - Diversified' | 'Banks' | 'Asset Management' | 'Asset Management - Bonds' | 'Asset Management - Income' | 'Asset Management - Leveraged' | 'Asset Management - Cryptocurrency' | 'Asset Management - Global' | 'Medical - Specialties' | 'Medical - Pharmaceuticals' | 'Medical - Instruments & Supplies' | 'Medical - Healthcare Plans' | 'Medical - Healthcare Information Services' | 'Medical - Equipment & Services' | 'Medical - Distribution' | 'Medical - Diagnostics & Research' | 'Medical - Devices' | 'Medical - Care Facilities' | 'Drug Manufacturers - Specialty & Generic' | 'Drug Manufacturers - General' | 'Biotechnology' | 'Waste Management' | 'Trucking' | 'Railroads' | 'Aerospace & Defense' | 'Marine Shipping' | 'Integrated Freight & Logistics' | 'Airlines, Airports & Air Services' | 'General Transportation' | 'Manufacturing - Tools & Accessories' | 'Manufacturing - Textiles' | 'Manufacturing - Miscellaneous' | 'Manufacturing - Metal Fabrication' | 'Industrial - Distribution' | 'Industrial - Specialties' | 'Industrial - Pollution & Treatment Controls' | 'Environmental Services' | 'Industrial - Machinery' | 'Industrial - Infrastructure Operations' | 'Industrial - Capital Goods' | 'Consulting Services' | 'Business Equipment & Supplies' | 'Staffing & Employment Services' | 'Rental & Leasing Services' | 'Engineering & Construction' | 'Security & Protection Services' | 'Specialty Business Services' | 'Construction' | 'Conglomerates' | 'Electrical Equipment & Parts' | 'Agricultural - Machinery' | 'Agricultural - Commodities/Milling' | 'REIT - Specialty' | 'REIT - Retail' | 'REIT - Residential' | 'REIT - Office' | 'REIT - Mortgage' | 'REIT - Industrial' | 'REIT - Hotel & Motel' | 'REIT - Healthcare Facilities' | 'REIT - Diversified' | 'Real Estate - Services' | 'Real Estate - Diversified' | 'Real Estate - Development' | 'Real Estate - General' | 'Information Technology Services' | 'Hardware, Equipment & Parts' | 'Computer Hardware' | 'Electronic Gaming & Multimedia' | 'Software - Services' | 'Software - Infrastructure' | 'Software - Application' | 'Semiconductors' | 'Media & Entertainment' | 'Communication Equipment' | 'Technology Distributors' | 'Consumer Electronics' | 'Renewable Utilities' | 'Regulated Water' | 'Regulated Gas' | 'Regulated Electric' | 'Independent Power Producers' | 'Diversified Utilities' | 'General Utilities' — Industry enum for public API. - string - `country` 'AW' | 'AF' | 'AO' | 'AI' | 'AX' | 'AL' | 'AD' | 'AE' | 'AR' | 'AM' | 'AS' | 'AQ' | 'TF' | 'AG' | 'AU' | 'AT' | 'AZ' | 'BI' | 'BE' | 'BJ' | 'BQ' | 'BF' | 'BD' | 'BG' | 'BH' | 'BS' | 'BA' | 'BL' | 'BY' | 'BZ' | 'BM' | 'BO' | 'BR' | 'BB' | 'BN' | 'BT' | 'BV' | 'BW' | 'CF' | 'CA' | 'CC' | 'CH' | 'CL' | 'CN' | 'CI' | 'CM' | 'CD' | 'CG' | 'CK' | 'CO' | 'KM' | 'CV' | 'CR' | 'CU' | 'CW' | 'CX' | 'KY' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DM' | 'DK' | 'DO' | 'DZ' | 'EC' | 'EG' | 'ER' | 'EH' | 'ES' | 'EE' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FR' | 'FO' | 'FM' | 'GA' | 'GB' | 'GE' | 'GG' | 'GH' | 'GI' | 'GN' | 'GP' | 'GM' | 'GW' | 'GQ' | 'GR' | 'GD' | 'GL' | 'GT' | 'GF' | 'GU' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IM' | 'IN' | 'IO' | 'IE' | 'IR' | 'IQ' | 'IS' | 'IL' | 'IT' | 'JM' | 'JE' | 'JO' | 'JP' | 'KZ' | 'KE' | 'KG' | 'KH' | 'KI' | 'KN' | 'KR' | 'KW' | 'LA' | 'LB' | 'LR' | 'LY' | 'LC' | 'LI' | 'LK' | 'LS' | 'LT' | 'LU' | 'LV' | 'MO' | 'MF' | 'MA' | 'MC' | 'MD' | 'MG' | 'MV' | 'MX' | 'MH' | 'MK' | 'ML' | 'MT' | 'MM' | 'ME' | 'MN' | 'MP' | 'MZ' | 'MR' | 'MS' | 'MQ' | 'MU' | 'MW' | 'MY' | 'YT' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NU' | 'NL' | 'NO' | 'NP' | 'NR' | 'NZ' | 'OM' | 'PK' | 'PA' | 'PN' | 'PE' | 'PH' | 'PW' | 'PG' | 'PL' | 'PR' | 'KP' | 'PT' | 'PY' | 'PS' | 'PF' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SA' | 'SD' | 'SN' | 'SG' | 'GS' | 'SH' | 'SJ' | 'SB' | 'SL' | 'SV' | 'SM' | 'SO' | 'PM' | 'RS' | 'SS' | 'ST' | 'SR' | 'SK' | 'SI' | 'SE' | 'SZ' | 'SX' | 'SC' | 'SY' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TM' | 'TL' | 'TO' | 'TT' | 'TN' | 'TR' | 'TV' | 'TW' | 'TZ' | 'UG' | 'UA' | 'UM' | 'UY' | 'US' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'ZA' | 'ZM' | 'ZW', nullable — Country code of the company (ISO 3166-1 alpha-2). - `exchange` string, nullable — Exchange code of the company. - `limit` integer — Maximum number of records to return (1-1000). ## Response `200` Successful Response - PublicCompanyScreenerResponse — Response model for the Company Screener service. - `results` ScreenedCompany[], required — List of companies matching the screening criteria. - `rp_entity_id` string, required — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`) - `symbol` string, nullable, required — The stock symbol of the company. - `company_name` string, nullable, required — The name of the company. - `market_cap` integer, nullable, required — The market cap of the company. - `sector` union — The sector of the company. - 'Basic Materials' | 'Communication Services' | 'Consumer Cyclical' | 'Consumer Defensive' | 'Energy' | 'Financial Services' | 'Healthcare' | 'Industrials' | 'Real Estate' | 'Technology' | 'Utilities' — Sector enum for public API. - string - `industry` union — The industry of the company. - 'Steel' | 'Silver' | 'Other Precious Metals' | 'Gold' | 'Copper' | 'Aluminum' | 'Paper, Lumber & Forest Products' | 'Industrial Materials' | 'Construction Materials' | 'Chemicals - Specialty' | 'Chemicals' | 'Agricultural Inputs' | 'Telecommunications Services' | 'Internet Content & Information' | 'Publishing' | 'Broadcasting' | 'Advertising Agencies' | 'Entertainment' | 'Travel Lodging' | 'Travel Services' | 'Specialty Retail' | 'Luxury Goods' | 'Home Improvement' | 'Residential Construction' | 'Department Stores' | 'Personal Products & Services' | 'Leisure' | 'Gambling, Resorts & Casinos' | 'Furnishings, Fixtures & Appliances' | 'Restaurants' | 'Auto - Parts' | 'Auto - Manufacturers' | 'Auto - Recreational Vehicles' | 'Auto - Dealerships' | 'Apparel - Retail' | 'Apparel - Manufacturers' | 'Apparel - Footwear & Accessories' | 'Packaging & Containers' | 'Tobacco' | 'Grocery Stores' | 'Discount Stores' | 'Household & Personal Products' | 'Packaged Foods' | 'Food Distribution' | 'Food Confectioners' | 'Agricultural Farm Products' | 'Education & Training Services' | 'Beverages - Wineries & Distilleries' | 'Beverages - Non-Alcoholic' | 'Beverages - Alcoholic' | 'Uranium' | 'Solar' | 'Oil & Gas Refining & Marketing' | 'Oil & Gas Midstream' | 'Oil & Gas Integrated' | 'Oil & Gas Exploration & Production' | 'Oil & Gas Equipment & Services' | 'Oil & Gas Energy' | 'Oil & Gas Drilling' | 'Coal' | 'Shell Companies' | 'Investment - Banking & Investment Services' | 'Insurance - Specialty' | 'Insurance - Reinsurance' | 'Insurance - Property & Casualty' | 'Insurance - Life' | 'Insurance - Diversified' | 'Insurance - Brokers' | 'Financial - Mortgages' | 'Financial - Diversified' | 'Financial - Data & Stock Exchanges' | 'Financial - Credit Services' | 'Financial - Conglomerates' | 'Financial - Capital Markets' | 'Banks - Regional' | 'Banks - Diversified' | 'Banks' | 'Asset Management' | 'Asset Management - Bonds' | 'Asset Management - Income' | 'Asset Management - Leveraged' | 'Asset Management - Cryptocurrency' | 'Asset Management - Global' | 'Medical - Specialties' | 'Medical - Pharmaceuticals' | 'Medical - Instruments & Supplies' | 'Medical - Healthcare Plans' | 'Medical - Healthcare Information Services' | 'Medical - Equipment & Services' | 'Medical - Distribution' | 'Medical - Diagnostics & Research' | 'Medical - Devices' | 'Medical - Care Facilities' | 'Drug Manufacturers - Specialty & Generic' | 'Drug Manufacturers - General' | 'Biotechnology' | 'Waste Management' | 'Trucking' | 'Railroads' | 'Aerospace & Defense' | 'Marine Shipping' | 'Integrated Freight & Logistics' | 'Airlines, Airports & Air Services' | 'General Transportation' | 'Manufacturing - Tools & Accessories' | 'Manufacturing - Textiles' | 'Manufacturing - Miscellaneous' | 'Manufacturing - Metal Fabrication' | 'Industrial - Distribution' | 'Industrial - Specialties' | 'Industrial - Pollution & Treatment Controls' | 'Environmental Services' | 'Industrial - Machinery' | 'Industrial - Infrastructure Operations' | 'Industrial - Capital Goods' | 'Consulting Services' | 'Business Equipment & Supplies' | 'Staffing & Employment Services' | 'Rental & Leasing Services' | 'Engineering & Construction' | 'Security & Protection Services' | 'Specialty Business Services' | 'Construction' | 'Conglomerates' | 'Electrical Equipment & Parts' | 'Agricultural - Machinery' | 'Agricultural - Commodities/Milling' | 'REIT - Specialty' | 'REIT - Retail' | 'REIT - Residential' | 'REIT - Office' | 'REIT - Mortgage' | 'REIT - Industrial' | 'REIT - Hotel & Motel' | 'REIT - Healthcare Facilities' | 'REIT - Diversified' | 'Real Estate - Services' | 'Real Estate - Diversified' | 'Real Estate - Development' | 'Real Estate - General' | 'Information Technology Services' | 'Hardware, Equipment & Parts' | 'Computer Hardware' | 'Electronic Gaming & Multimedia' | 'Software - Services' | 'Software - Infrastructure' | 'Software - Application' | 'Semiconductors' | 'Media & Entertainment' | 'Communication Equipment' | 'Technology Distributors' | 'Consumer Electronics' | 'Renewable Utilities' | 'Regulated Water' | 'Regulated Gas' | 'Regulated Electric' | 'Independent Power Producers' | 'Diversified Utilities' | 'General Utilities' — Industry enum for public API. - string - `beta` number, nullable — The beta of the company. - `price` number, nullable — The current price of the company. - `last_annual_dividend` number, nullable — The last annual dividend of the company. - `volume` integer, nullable — The trading volume of the company. - `exchange` string, nullable — The exchange of the company. - `exchange_short_name` string, nullable — The short name of the exchange. - `country` 'AW' | 'AF' | 'AO' | 'AI' | 'AX' | 'AL' | 'AD' | 'AE' | 'AR' | 'AM' | 'AS' | 'AQ' | 'TF' | 'AG' | 'AU' | 'AT' | 'AZ' | 'BI' | 'BE' | 'BJ' | 'BQ' | 'BF' | 'BD' | 'BG' | 'BH' | 'BS' | 'BA' | 'BL' | 'BY' | 'BZ' | 'BM' | 'BO' | 'BR' | 'BB' | 'BN' | 'BT' | 'BV' | 'BW' | 'CF' | 'CA' | 'CC' | 'CH' | 'CL' | 'CN' | 'CI' | 'CM' | 'CD' | 'CG' | 'CK' | 'CO' | 'KM' | 'CV' | 'CR' | 'CU' | 'CW' | 'CX' | 'KY' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DM' | 'DK' | 'DO' | 'DZ' | 'EC' | 'EG' | 'ER' | 'EH' | 'ES' | 'EE' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FR' | 'FO' | 'FM' | 'GA' | 'GB' | 'GE' | 'GG' | 'GH' | 'GI' | 'GN' | 'GP' | 'GM' | 'GW' | 'GQ' | 'GR' | 'GD' | 'GL' | 'GT' | 'GF' | 'GU' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IM' | 'IN' | 'IO' | 'IE' | 'IR' | 'IQ' | 'IS' | 'IL' | 'IT' | 'JM' | 'JE' | 'JO' | 'JP' | 'KZ' | 'KE' | 'KG' | 'KH' | 'KI' | 'KN' | 'KR' | 'KW' | 'LA' | 'LB' | 'LR' | 'LY' | 'LC' | 'LI' | 'LK' | 'LS' | 'LT' | 'LU' | 'LV' | 'MO' | 'MF' | 'MA' | 'MC' | 'MD' | 'MG' | 'MV' | 'MX' | 'MH' | 'MK' | 'ML' | 'MT' | 'MM' | 'ME' | 'MN' | 'MP' | 'MZ' | 'MR' | 'MS' | 'MQ' | 'MU' | 'MW' | 'MY' | 'YT' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NU' | 'NL' | 'NO' | 'NP' | 'NR' | 'NZ' | 'OM' | 'PK' | 'PA' | 'PN' | 'PE' | 'PH' | 'PW' | 'PG' | 'PL' | 'PR' | 'KP' | 'PT' | 'PY' | 'PS' | 'PF' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'SA' | 'SD' | 'SN' | 'SG' | 'GS' | 'SH' | 'SJ' | 'SB' | 'SL' | 'SV' | 'SM' | 'SO' | 'PM' | 'RS' | 'SS' | 'ST' | 'SR' | 'SK' | 'SI' | 'SE' | 'SZ' | 'SX' | 'SC' | 'SY' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TM' | 'TL' | 'TO' | 'TT' | 'TN' | 'TR' | 'TV' | 'TW' | 'TZ' | 'UG' | 'UA' | 'UM' | 'UY' | 'US' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'ZA' | 'ZM' | 'ZW', nullable — The country code of the company. - `is_etf` boolean, nullable — Whether the company's stock is an ETF. - `is_actively_trading` boolean, nullable — Whether the company's stock is actively trading. - `errors` ErrorDetail[], nullable - `message` string, nullable - `metadata` Metadata - `request_id` string, required - `timestamp` string --- [API](https://skmtc.net/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.net/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/versions/18082de268c4/schema)