curl --request POST \
--url https://api.bigdata.com/v1/company-screener/query \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"filters": {
"is_actively_trading": true,
"market_cap_more_than": 1000000000,
"price_more_than": 10,
"sector": "Technology"
},
"limit": 100
}
'{
"results": [
{
"rp_entity_id": "<string>",
"symbol": "AAPL",
"company_name": "Apple Inc.",
"market_cap": 3000000000000,
"sector": "Technology",
"industry": "Consumer Electronics",
"beta": 1.2,
"price": 170.5,
"last_annual_dividend": 0.92,
"volume": 75000000,
"exchange": "NASDAQ",
"exchange_short_name": "NASDAQ",
"country": "US",
"is_etf": false,
"is_actively_trading": true
}
],
"errors": [
{
"message": "<string>"
}
],
"metadata": {
"request_id": "<string>",
"timestamp": "<string>"
}
}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.
curl --request POST \
--url https://api.bigdata.com/v1/company-screener/query \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"filters": {
"is_actively_trading": true,
"market_cap_more_than": 1000000000,
"price_more_than": 10,
"sector": "Technology"
},
"limit": 100
}
'{
"results": [
{
"rp_entity_id": "<string>",
"symbol": "AAPL",
"company_name": "Apple Inc.",
"market_cap": 3000000000000,
"sector": "Technology",
"industry": "Consumer Electronics",
"beta": 1.2,
"price": 170.5,
"last_annual_dividend": 0.92,
"volume": 75000000,
"exchange": "NASDAQ",
"exchange_short_name": "NASDAQ",
"country": "US",
"is_etf": false,
"is_actively_trading": true
}
],
"errors": [
{
"message": "<string>"
}
],
"metadata": {
"request_id": "<string>",
"timestamp": "<string>"
}
}Allows filtering companies based on various financial and descriptive criteria.
Object specifying the filters to apply to the request.
Show child attributes
Minimum market capitalization in USD.
x >= 01000000000
Maximum market capitalization in USD.
x >= 010000000000
Minimum stock price in USD.
x >= 010
Maximum stock price in USD.
x >= 0200
Minimum beta value.
0.5
Maximum beta value.
2
Minimum trading volume.
x >= 01000000
Maximum trading volume.
x >= 010000000
Minimum annual dividend in USD.
x >= 00.1
Maximum annual dividend in USD.
x >= 05
Whether to include ETFs in the results.
false
Whether to include mutual funds in the results.
false
Whether to include only actively trading stocks.
true
Sector of the company.
Basic Materials, Communication Services, Consumer Cyclical, Consumer Defensive, Energy, Financial Services, Healthcare, Industrials, Real Estate, Technology, Utilities "Technology"
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 "Semiconductors"
Country code of the company (ISO 3166-1 alpha-2).
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 "US"
Exchange code of the company.
"NASDAQ"
{
"is_actively_trading": true,
"market_cap_more_than": 1000000000,
"price_more_than": 10,
"sector": "Technology"
}Maximum number of records to return (1-1000).
1 <= x <= 1000Successful Response
Response model for the Company Screener service.
List of companies matching the screening criteria.
Show child attributes
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)
6The stock symbol of the company.
"AAPL"
The name of the company.
"Apple Inc."
The market cap of the company.
3000000000000
The sector of the company.
Basic Materials, Communication Services, Consumer Cyclical, Consumer Defensive, Energy, Financial Services, Healthcare, Industrials, Real Estate, Technology, Utilities "Technology"
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 "Consumer Electronics"
The beta of the company.
1.2
The current price of the company.
170.5
The last annual dividend of the company.
0.92
The trading volume of the company.
75000000
The exchange of the company.
"NASDAQ"
The short name of the exchange.
"NASDAQ"
The country code of the company.
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 "US"
Whether the company's stock is an ETF.
false
Whether the company's stock is actively trading.
true
Was this page helpful?