{ "openapi": "3.0.1", "info": { "title": "Finviz Stock Screener Scraper", "description": "Scrape Finviz stock screener - filter stocks by exchange, sector, industry, market cap, P/E ratio, and 50+ other criteria. Get overview data and news for specific tickers.", "version": "1.0", "x-build-id": "0fYgaerKDBG5jnN73" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~finviz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-finviz-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~finviz-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-finviz-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~finviz-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-finviz-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode", "proxyConfiguration" ], "properties": { "mode": { "title": "Mode", "enum": [ "screener", "stockOverview", "newsForTicker", "insiderTrading", "groupPerformance" ], "type": "string", "description": "What to scrape.", "default": "screener" }, "ticker": { "title": "Ticker symbol", "type": "string", "description": "Stock ticker symbol (e.g. AAPL, TSLA). Required for modes stockOverview and newsForTicker." }, "exchange": { "title": "Exchange", "enum": [ "", "AMEX", "CBOE", "NASDAQ", "NYSE" ], "type": "string", "description": "Filter by stock exchange (screener mode).", "default": "" }, "sector": { "title": "Sector", "enum": [ "", "Basic Materials", "Communication Services", "Consumer Cyclical", "Consumer Defensive", "Energy", "Financial", "Healthcare", "Industrials", "Real Estate", "Technology", "Utilities" ], "type": "string", "description": "Filter by market sector (screener mode).", "default": "" }, "industry": { "title": "Industry", "enum": [ "", "stocksonly", "stocksonlyspac", "exchangetradedfund", "advertisingagencies", "aerospacedefense", "agriculturalinputs", "airlines", "airportsairservices", "aluminum", "apparelmanufacturing", "apparelretail", "assetmanagement", "automanufacturers", "autoparts", "autotruckdealerships", "banksdiversified", "banksregional", "beveragesbrewers", "beveragesnonalcoholic", "beverageswineriesdistilleries", "biotechnology", "broadcasting", "buildingmaterials", "buildingproductsequipment", "businessequipmentsupplies", "capitalmarkets", "chemicals", "closedendfunddebt", "closedendfundequity", "closedendfundforeign", "cokingcoal", "communicationequipment", "computerhardware", "confectioners", "conglomerates", "consultingservices", "consumerelectronics", "copper", "creditservices", "departmentstores", "diagnosticsresearch", "discountstores", "drugmanufacturersgeneral", "drugmanufacturersspecialtygeneric", "educationtrainingservices", "electricalequipmentparts", "electroniccomponents", "electronicgamingmultimedia", "electronicscomputerdistribution", "engineeringconstruction", "entertainment", "farmheavyconstructionmachinery", "farmproducts", "financialconglomerates", "financialdatastockexchanges", "fooddistribution", "footwearaccessories", "furnishingsfixturesappliances", "gambling", "gold", "grocerystores", "healthcareplans", "healthinformationservices", "homeimprovementretail", "householdpersonalproducts", "industrialdistribution", "informationtechnologyservices", "infrastructureoperations", "insurancebrokers", "insurancediversified", "insurancelife", "insurancepropertycasualty", "insurancereinsurance", "insurancespecialty", "integratedfreightlogistics", "internetcontentinformation", "internetretail", "leisure", "lodging", "lumberwoodproduction", "luxurygoods", "marineshipping", "medicalcarefacilities", "medicaldevices", "medicaldistribution", "medicalinstrumentssupplies", "metalfabrication", "mortgagefinance", "oilgasdrilling", "oilgasep", "oilgasequipmentservices", "oilgasintegrated", "oilgasmidstream", "oilgasrefiningmarketing", "otherindustrialmetalsmining", "otherpreciousmetalsmining", "packagedfoods", "packagingcontainers", "paperpaperproducts", "personalservices", "pharmaceuticalretailers", "pollutiontreatmentcontrols", "publishing", "railroads", "realestatedevelopment", "realestatediversified", "realestateservices", "recreationalvehicles", "reitdiversified", "reithealthcarefacilities", "reithotelmotel", "reitindustrial", "reitmortgage", "reitoffice", "reitresidential", "reitretail", "reitspecialty", "rentalleasingservices", "residentialconstruction", "resortscasinos", "restaurants", "scientifictechnicalinstruments", "securityprotectionservices", "semiconductorequipmentmaterials", "semiconductors", "shellcompanies", "silver", "softwareapplication", "softwareinfrastructure", "solar", "specialtybusinessservices", "specialtychemicals", "specialtyindustrialmachinery", "specialtyretail", "staffingemploymentservices", "steel", "telecomservices", "textilemanufacturing", "thermalcoal", "tobacco", "toolsaccessories", "travelservices", "trucking", "uranium", "utilitiesdiversified", "utilitiesindependentpowerproducers", "utilitiesregulatedelectric", "utilitiesregulatedgas", "utilitiesregulatedwater", "utilitiesrenewable", "wastemanagement" ], "type": "string", "description": "Filter by specific industry sub-classification (screener mode). More granular than Sector.", "default": "" }, "index": { "title": "Index membership", "enum": [ "", "sp500", "ndx", "dji", "rut" ], "type": "string", "description": "Filter by stock market index membership (screener mode).", "default": "" }, "signal": { "title": "Signal", "enum": [ "", "ta_topgainers", "ta_toplosers", "ta_newhigh", "ta_newlow", "ta_mostvolatile", "ta_mostactive", "ta_unusualvolume", "ta_overbought", "ta_oversold", "n_downgrades", "n_upgrades", "n_earningsbefore", "n_earningsafter", "it_latestbuys", "it_latestsales", "n_majornews", "ta_p_horizontal", "ta_p_tlresistance", "ta_p_tlsupport", "ta_p_wedgeup", "ta_p_wedgedown", "ta_p_wedgeresistance", "ta_p_wedgesupport", "ta_p_wedge", "ta_p_channelup", "ta_p_channeldown", "ta_p_channel", "ta_p_doubletop", "ta_p_doublebottom", "ta_p_multipletop", "ta_p_multiplebottom", "ta_p_headandshoulders", "ta_p_headandshouldersinv" ], "type": "string", "description": "Screen by a technical/fundamental event signal instead of (or in addition to) the filters above (screener mode).", "default": "" }, "marketCap": { "title": "Market Cap", "enum": [ "", "mega", "large", "mid", "small", "micro", "nano" ], "type": "string", "description": "Filter by market capitalization range.", "default": "" }, "country": { "title": "Country", "enum": [ "", "Argentina", "Asia", "Australia", "Bahamas", "Belgium", "BeNeLux", "Bermuda", "Brazil", "BRIC", "Canada", "Cayman Islands", "Chile", "China", "China & Hong Kong", "Colombia", "Cyprus", "Denmark", "Europe", "Finland", "Foreign (ex-USA)", "France", "Germany", "Greece", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Ireland", "Israel", "Italy", "Japan", "Jordan", "Kazakhstan", "Latin America", "Luxembourg", "Malaysia", "Malta", "Mexico", "Monaco", "Netherlands", "New Zealand", "Norway", "Panama", "Peru", "Philippines", "Portugal", "Russia", "Singapore", "South Africa", "South Korea", "Spain", "Sweden", "Switzerland", "Taiwan", "Thailand", "Turkey", "United Arab Emirates", "United Kingdom", "Uruguay", "USA", "Vietnam" ], "type": "string", "description": "Filter by country of incorporation (screener mode).", "default": "" }, "priceFilter": { "title": "Price", "enum": [ "", "u1", "u2", "u3", "u4", "u5", "u7", "u10", "u15", "u20", "u30", "u40", "u50", "o1", "o2", "o3", "o4", "o5", "o7", "o10", "o15", "o20", "o30", "o40", "o50", "o60", "o70", "o80", "o90", "o100", "1to5", "1to10", "1to20", "5to10", "5to20", "5to50", "10to20", "10to50", "20to50", "50to100" ], "type": "string", "description": "Filter by share price range (screener mode).", "default": "" }, "avgVolumeFilter": { "title": "Average volume", "enum": [ "", "u50", "u100", "u500", "u750", "u1000", "o50", "o100", "o200", "o300", "o400", "o500", "o750", "o1000", "o2000", "100to500", "100to1000", "500to1000", "500to10000" ], "type": "string", "description": "Filter by 3-month average daily trading volume (screener mode).", "default": "" }, "dividendYieldFilter": { "title": "Dividend yield", "enum": [ "", "none", "pos", "high", "veryhigh", "o1", "o2", "o3", "o4", "o5", "o6", "o7", "o8", "o9", "o10" ], "type": "string", "description": "Filter by dividend yield (screener mode).", "default": "" }, "analystRecomFilter": { "title": "Analyst recommendation", "enum": [ "", "strongbuy", "buybetter", "buy", "holdbetter", "hold", "holdworse", "sell", "sellworse", "strongsell" ], "type": "string", "description": "Filter by average analyst recommendation (screener mode).", "default": "" }, "shortFloatFilter": { "title": "Short float", "enum": [ "", "low", "high", "u5", "u10", "u15", "u20", "u25", "u30", "o5", "o10", "o15", "o20", "o25", "o30" ], "type": "string", "description": "Filter by short interest as a percent of float (screener mode).", "default": "" }, "ipoDateFilter": { "title": "IPO date", "enum": [ "", "today", "yesterday", "prevweek", "prevmonth", "prevquarter", "prevyear", "prev2yrs", "prev3yrs", "prev5yrs", "more1", "more5", "more10", "more15", "more20", "more25" ], "type": "string", "description": "Filter by how long ago the stock IPO'd (screener mode).", "default": "" }, "earningsDateFilter": { "title": "Earnings date", "enum": [ "", "today", "todaybefore", "todayafter", "tomorrow", "tomorrowbefore", "tomorrowafter", "yesterday", "yesterdaybefore", "yesterdayafter", "nextdays5", "prevdays5", "thisweek", "nextweek", "prevweek", "thismonth" ], "type": "string", "description": "Filter by scheduled earnings-report timing (screener mode).", "default": "" }, "theme": { "title": "Theme", "enum": [ "", "agingpopulationlongevity", "agriculturefoodtech", "artificialintelligence", "autonomoussystems", "bigdata", "biometrics", "cloudcomputing", "commoditiesagriculture", "commoditiesenergy", "commoditiesmetals", "consumergoods", "cryptoblockchain", "cybersecurity", "defenseaerospace", "digitalentertainment", "ecommerce", "educationtechnology", "electricvehicles", "energyrenewable", "energytraditional", "environmentalsustainability", "fintech", "hardware", "healthcarebiotech", "healthyfoodnutrition", "industrialautomation", "internetofthings", "nanotechnology", "quantumcomputing", "realestatereits", "robotics", "semiconductors", "smarthome", "socialmedia", "software", "spacetech", "telecommunications", "transportationlogistics", "virtualaugmentedreality", "wearables" ], "type": "string", "description": "Filter by Finviz thematic classification (screener mode), e.g. Artificial Intelligence, Cybersecurity, Electric Vehicles.", "default": "" }, "subtheme": { "title": "Subtheme", "enum": [ "", "agriculturealtprotein", "agriculturecropinputs", "agricultureindoorfarming", "agricultureprocessing", "agriculturesmartfarming", "aiadssearch", "aiagi", "aiapplications", "aicloud", "aicompute", "aidata", "aiedge", "aienergy", "aienterprise", "aimodels", "ainetworking", "airobotics", "aisecurity", "automationautomation", "automationdprinting", "automationiot", "automationlogistics", "automationmachinevision", "automationrobotics", "automationsoftware", "autonomousavmobility", "autonomousdefense", "autonomousindustrial", "autonomousmachinevision", "autonomoussoftware", "autonomousspecialized", "bigdataaiplatforms", "bigdataanalyticsbi", "bigdatainfrastructure", "bigdataproviders", "biometricsgovdefense", "biometricshardware", "biometricsidentity", "biometricssoftware", "blockchainenterprise", "blockchaininfrastructure", "blockchainmining", "blockchainpayments", "blockchainplatforms", "blockchaintokenization", "clouddatabases", "clouddatacenters", "clouddevops", "cloudedge", "cloudhardware", "cloudhsaas", "cloudhybridcloud", "cloudhyperscalers", "cloudmulticloud", "cloudpaas", "cloudsecurity", "cloudserverless", "commagribiofuels", "commagrifertilizers", "commagrigrains", "commagrilivestock", "commagrisofts", "commenergybiofuels", "commenergygaslng", "commenergyoil", "commenergyuranium", "commmetalsbattery", "commmetalsgold", "commmetalsindustrial", "commmetalsprecious", "commmetalsrareearth", "commmetalsrecycling", "commmetalssilver", "consumerapparel", "consumerfarmdirect", "consumerfood", "consumerhousehold", "consumerluxury", "consumersecondhand", "cybersecurityappsecurity", "cybersecuritycloud", "cybersecurityendpoint", "cybersecurityidentityiam", "cybersecuritynetwork", "cybersecuritysiem", "cybersecuritythreatops", "cybersecurityzerotrust", "defenseaviation", "defensecyberdefense", "defensedrones", "defensemanufacturing", "defensemissiles", "defensespacetech", "defenseweapons", "ecommerceadsmedia", "ecommercedtc", "ecommercegrocery", "ecommercelogistics", "ecommercemarketplaces", "ecommerceomnichannel", "ecommerceplatforms", "ecommercesecondhand", "ecommercesocial", "educationcurriculum", "educationinfrastructure", "educationplatforms", "educationworkforce", "energybasemajors", "energybasenuclear", "energybaseoilproduction", "energybaseoilrefining", "energybaseoilservices", "energybasethermal", "energybaseutilities", "energycleanbatteries", "energycleanbiofuels", "energycleangeothermal", "energycleanhydrogen", "energycleanmaterials", "energycleansmartgrid", "energycleansolar", "energycleanutilities", "energycleanwind", "entertainmentbetting", "entertainmentgambling", "entertainmentgaming", "entertainmentinfrastructure", "entertainmentmusic", "entertainmentvideo", "environmentalagriculture", "environmentalairquality", "environmentalclimate", "environmentalwaste", "environmentalwater", "evsbatteries", "evscharging", "evschips", "evsfleets", "evsmanufacturers", "evsselfdriving", "evssuppliers", "fintechblockchain", "fintechexchanges", "fintechinsurance", "fintechlending", "fintechneobanks", "fintechpayments", "fintechtrading", "hardwaredatacenters", "hardwareelectronics", "hardwaregaming", "hardwareindustrialiot", "hardwarenetworking", "hardwarenextgen", "hardwarepcsdevices", "hardwareprinting", "hardwareservers", "hardwarestorage", "hardwaretelecom", "healthcaredevices", "healthcarediagnostics", "healthcaregenomics", "healthcareitdata", "healthcaremetabolic", "healthcarenextgen", "healthcareoncology", "healthcaretelemedicine", "healthcaretherapeutics", "iotedgedevices", "iotenterprise", "iothardware", "iotnetworking", "iotsecurity", "iotsoftware", "longevityagingpharma", "longevityhealthcare", "longevityhealthyaging", "longevityseniorliving", "nanotechelectronics", "nanotechenergy", "nanotechmaterials", "nanotechmedicine", "nanotechproducts", "nanotechresearchtools", "nutritionaltprotein", "nutritionmealdelivery", "nutritionretailers", "nutritionsupplements", "quantumapplications", "quantumcloud", "quantumenablingtech", "quantumhardware", "quantumnetworking", "quantumsoftware", "realestatehealthcare", "realestatehousing", "realestateittelecom", "realestateoffice", "realestateretail", "realestatetourism", "realestatewarehousing", "roboticsautomation", "roboticsavmobility", "roboticsconsumer", "roboticslogistics", "roboticsmachinevision", "roboticsmedical", "semisanalog", "semiscompute", "semisdesigntools", "semisfoundries", "semislithography", "semismemory", "semisnextgen", "semispackaging", "semiswireless", "smarthomeautomation", "smarthomedevices", "smarthomeenergy", "smarthomenetworking", "smarthomesecurity", "smarthomevoiceai", "socialadvertising", "socialgaming", "socialnetworks", "socialniche", "socialvisualcontent", "softwarecollaboration", "softwarecrm", "softwaredataanalytics", "softwaredesign", "softwaredevops", "softwareecommerce", "softwareenterprise", "softwaregaming", "softwarehsaas", "softwareos", "softwaresecurity", "softwarevsaas", "spacedataanalytics", "spacedefense", "spaceinfrastructure", "spacelaunch", "spacesatellites", "telecomcloudedge", "telecomenterprise", "telecomg", "telecominfrastructure", "telecomsatcom", "telecomwireless", "transportationaircargo", "transportationairtravel", "transportationinfrastructure", "transportationmaritime", "transportationnextgen", "transportationrail", "transportationtrucking", "transportationwarehousing", "varealityapplications", "varealityenterprise", "varealityhardware", "varealityinfrastructure", "varealitysoftware", "wearablesimmersive", "wearablesmedical", "wearablessmartwatches", "wearablessoftware", "wearablessport" ], "type": "string", "description": "Filter by Finviz fine-grained subtheme classification (screener mode) — a more specific slice within a broader Theme, e.g. AI - Foundation Models & Platforms, EVs - Batteries.", "default": "" }, "targetPriceFilter": { "title": "Target price vs. current price", "enum": [ "", "a50", "a40", "a30", "a20", "a10", "a5", "above", "below", "b5", "b10", "b20", "b30", "b40", "b50" ], "type": "string", "description": "Filter by analyst average target price relative to current share price (screener mode).", "default": "" }, "currentVolumeFilter": { "title": "Current volume", "enum": [ "", "u50", "u100", "u500", "u750", "u1000", "o0", "o50", "o100", "o200", "o300", "o400", "o500", "o750", "o1000", "o2000", "o5000", "o10000", "o20000", "o50sf", "o100sf", "uusd1000", "uusd10000", "uusd100000", "uusd1000000", "ousd1000", "ousd10000", "ousd100000", "ousd1000000" ], "type": "string", "description": "Filter by today's current trading volume (screener mode). Distinct from Average volume, which is the 3-month average.", "default": "" }, "floatFilter": { "title": "Float", "enum": [ "", "u1", "u5", "u10", "u20", "u50", "u100", "o1", "o2", "o5", "o10", "o20", "o50", "o100", "o200", "o500", "o1000", "u10p", "u20p", "u30p", "u40p", "u50p", "u60p", "u70p", "u80p", "u90p", "o10p", "o20p", "o30p", "o40p", "o50p", "o60p", "o70p", "o80p", "o90p" ], "type": "string", "description": "Filter by number of shares in the public float, as an absolute count or as a percent of shares outstanding (screener mode).", "default": "" }, "relativeVolumeFilter": { "title": "Relative volume", "enum": [ "", "o10", "o5", "o3", "o2", "o1.5", "o1", "o0.75", "o0.5", "o0.25", "u2", "u1.5", "u1", "u0.75", "u0.5", "u0.25", "u0.1" ], "type": "string", "description": "Filter by today's volume relative to the 3-month average volume, e.g. 'Over 2' = trading at 2x its normal volume (screener mode).", "default": "" }, "sharesOutstandingFilter": { "title": "Shares outstanding", "enum": [ "", "u1", "u5", "u10", "u20", "u50", "u100", "o1", "o2", "o5", "o10", "o20", "o50", "o100", "o200", "o500", "o1000" ], "type": "string", "description": "Filter by total shares outstanding (screener mode).", "default": "" }, "optionableShortableFilter": { "title": "Optionable / shortable", "enum": [ "", "option", "short", "notoption", "notshort", "optionshort", "optionnotshort", "notoptionshort", "notoptionnotshort" ], "type": "string", "description": "Filter by whether the stock has listed options and/or is available to short (screener mode).", "default": "" }, "sortBy": { "title": "Sort by", "enum": [ "", "ticker", "company", "sector", "industry", "country", "marketcap", "pe", "forwardpe", "peg", "pb", "ps", "price", "change", "volume", "dividendyield", "eps", "epsyoy", "high", "low", "beta", "rsi", "targetprice", "perf1w", "perf4w", "perf13w", "perfytd", "perf52w", "sma20", "sma50", "sma200", "roe", "roa", "insiderown", "instown", "sharesoutstanding", "ipodate", "earningsdate" ], "type": "string", "description": "Column to sort screener results by (screener mode).", "default": "" }, "sortDescending": { "title": "Sort descending", "type": "boolean", "description": "Sort results highest-to-lowest instead of lowest-to-highest (screener mode).", "default": false }, "includeExtendedMetrics": { "title": "Include extended metrics (screener mode)", "type": "boolean", "description": "Enrich each screener row with ~45 additional fields (Forward P/E, PEG, P/B, ROE/ROA/ROIC, margins, ownership %, beta, RSI, moving averages, 52-week high/low, multi-year performance, etc.) by fetching Finviz's Valuation/Ownership/Performance/Financial/Technical screener views for every page and merging them in by ticker. This makes ~6x more requests per page, so runs take longer — leave off for fast, lightweight results.", "default": false }, "peFilter": { "title": "P/E ratio", "enum": [ "", "low", "profitable", "high", "u5", "u10", "u15", "u20", "u25", "u30", "u35", "u40", "u45", "u50", "o5", "o10", "o15", "o20", "o25", "o30", "o35", "o40", "o45", "o50" ], "type": "string", "description": "Filter by price-to-earnings ratio (screener mode).", "default": "" }, "forwardPeFilter": { "title": "Forward P/E ratio", "enum": [ "", "low", "profitable", "high", "u5", "u10", "u15", "u20", "u25", "u30", "u35", "u40", "u45", "u50", "o5", "o10", "o15", "o20", "o25", "o30", "o35", "o40", "o45", "o50" ], "type": "string", "description": "Filter by price-to-estimated-next-year-earnings ratio (screener mode).", "default": "" }, "pegFilter": { "title": "PEG ratio", "enum": [ "", "low", "high", "u1", "u2", "u3", "o1", "o2", "o3" ], "type": "string", "description": "Filter by PEG ratio (P/E adjusted for growth) (screener mode).", "default": "" }, "pbFilter": { "title": "Price/Book", "enum": [ "", "low", "high", "u1", "u2", "u3", "u4", "u5", "u6", "u7", "u8", "u9", "u10", "o1", "o2", "o3", "o4", "o5", "o6", "o7", "o8", "o9", "o10" ], "type": "string", "description": "Filter by price-to-book ratio (screener mode).", "default": "" }, "psFilter": { "title": "Price/Sales", "enum": [ "", "low", "high", "u1", "u2", "u3", "u4", "u5", "u6", "u7", "u8", "u9", "u10", "o1", "o2", "o3", "o4", "o5", "o6", "o7", "o8", "o9", "o10" ], "type": "string", "description": "Filter by price-to-sales ratio (screener mode).", "default": "" }, "roeFilter": { "title": "Return on equity (ROE)", "enum": [ "", "pos", "neg", "verypos", "u-50", "u-45", "u-40", "u-35", "u-30", "u-25", "u-20", "u-15", "u-10", "u-5", "o5", "o10", "o15", "o20", "o25", "o30", "o35", "o40", "o45", "o50", "veryneg" ], "type": "string", "description": "Filter by return on equity (screener mode).", "default": "" }, "debtEquityFilter": { "title": "Debt/Equity", "enum": [ "", "high", "low", "u1", "u0.9", "u0.8", "u0.7", "u0.6", "u0.5", "u0.4", "u0.3", "u0.2", "u0.1", "o0.1", "o0.2", "o0.3", "o0.4", "o0.5", "o0.6", "o0.7", "o0.8", "o0.9", "o1" ], "type": "string", "description": "Filter by total debt-to-equity ratio (screener mode).", "default": "" }, "epsGrowthThisYearFilter": { "title": "EPS growth this year", "enum": [ "", "neg", "pos", "poslow", "high", "u5", "u10", "u15", "u20", "u25", "u30", "o5", "o10", "o15", "o20", "o25", "o30" ], "type": "string", "description": "Filter by this year's EPS growth (screener mode).", "default": "" }, "rsiFilter": { "title": "RSI (14)", "enum": [ "", "ob90", "ob80", "ob70", "ob60", "os40", "os30", "os20", "os10", "nob60", "nob50", "nos50", "nos40" ], "type": "string", "description": "Filter by 14-day Relative Strength Index — overbought/oversold technical indicator (screener mode).", "default": "" }, "betaFilter": { "title": "Beta", "enum": [ "", "u0", "u0.5", "u1", "u1.5", "u2", "o0", "o0.5", "o1", "o1.5", "o2", "o2.5", "o3", "o4", "0to0.5", "0to1", "0.5to1", "0.5to1.5", "1to1.5", "1to2" ], "type": "string", "description": "Filter by beta (volatility relative to the overall market) (screener mode).", "default": "" }, "performanceFilter": { "title": "Performance", "enum": [ "", "dup", "ddown", "d15u", "d10u", "d5u", "d5o", "d10o", "d15o", "1w30u", "1w20u", "1w10u", "1wdown", "1wup", "1w10o", "1w20o", "1w30o", "4w50u", "4w30u", "4w20u", "4w10u", "4wdown", "4wup", "4w10o", "4w20o", "4w30o", "4w50o", "13w50u", "13w30u", "13w20u", "13w10u", "13wdown", "13wup", "13w10o", "13w20o", "13w30o", "13w50o", "26w75u", "26w50u", "26w30u", "26w20u", "26w10u", "26wdown", "26wup", "26w10o", "26w20o", "26w30o", "26w50o", "26w100o", "52w75u", "52w50u", "52w30u", "52w20u", "52w10u", "52wdown", "52wup", "52w10o", "52w20o", "52w30o", "52w50o", "52w100o", "52w200o", "52w300o", "52w500o", "ytd75u", "ytd50u", "ytd30u", "ytd20u", "ytd10u", "ytd5u", "ytddown", "ytdup", "ytd5o", "ytd10o", "ytd20o", "ytd30o", "ytd50o", "ytd100o" ], "type": "string", "description": "Filter by recent price performance over a specific period (today, week, month, quarter, half year, year, or YTD) and magnitude (screener mode).", "default": "" }, "roaFilter": { "title": "Return on Assets (ROA)", "enum": [ "", "pos", "neg", "verypos", "veryneg", "u-50", "u-45", "u-40", "u-35", "u-30", "u-25", "u-20", "u-15", "u-10", "u-5", "o5", "o10", "o15", "o20", "o25", "o30", "o35", "o40", "o45", "o50" ], "type": "string", "description": "Filter by return on assets (screener mode).", "default": "" }, "roiFilter": { "title": "Return on Investment (ROI)", "enum": [ "", "pos", "neg", "verypos", "veryneg", "u-50", "u-45", "u-40", "u-35", "u-30", "u-25", "u-20", "u-15", "u-10", "u-5", "o5", "o10", "o15", "o20", "o25", "o30", "o35", "o40", "o45", "o50" ], "type": "string", "description": "Filter by return on investment (screener mode).", "default": "" }, "currentRatioFilter": { "title": "Current ratio", "enum": [ "", "high", "low", "u1", "u0.5", "o0.5", "o1", "o1.5", "o2", "o3", "o4", "o5", "o10" ], "type": "string", "description": "Filter by current ratio (current assets / current liabilities) (screener mode).", "default": "" }, "quickRatioFilter": { "title": "Quick ratio", "enum": [ "", "high", "low", "u1", "u0.5", "o0.5", "o1", "o1.5", "o2", "o3", "o4", "o5", "o10" ], "type": "string", "description": "Filter by quick ratio (acid-test liquidity ratio) (screener mode).", "default": "" }, "grossMarginFilter": { "title": "Gross margin", "enum": [ "", "pos", "neg", "high", "u90", "u80", "u70", "u60", "u50", "u45", "u40", "u35", "u30", "u25", "u20", "u15", "u10", "u5", "u0", "u-10", "u-20", "u-30", "u-50", "u-70", "u-100", "o0", "o5", "o10", "o15", "o20", "o25", "o30", "o35", "o40", "o45", "o50", "o60", "o70", "o80", "o90" ], "type": "string", "description": "Filter by gross profit margin (screener mode).", "default": "" }, "operMarginFilter": { "title": "Operating margin", "enum": [ "", "pos", "neg", "veryneg", "high", "u90", "u80", "u70", "u60", "u50", "u45", "u40", "u35", "u30", "u25", "u20", "u15", "u10", "u5", "u0", "u-10", "u-20", "u-30", "u-50", "u-70", "u-100", "o0", "o5", "o10", "o15", "o20", "o25", "o30", "o35", "o40", "o45", "o50", "o60", "o70", "o80", "o90" ], "type": "string", "description": "Filter by operating profit margin (screener mode).", "default": "" }, "netMarginFilter": { "title": "Net profit margin", "enum": [ "", "pos", "neg", "veryneg", "high", "u90", "u80", "u70", "u60", "u50", "u45", "u40", "u35", "u30", "u25", "u20", "u15", "u10", "u5", "u0", "u-10", "u-20", "u-30", "u-50", "u-70", "u-100", "o0", "o5", "o10", "o15", "o20", "o25", "o30", "o35", "o40", "o45", "o50", "o60", "o70", "o80", "o90" ], "type": "string", "description": "Filter by net profit margin (screener mode).", "default": "" }, "insiderOwnFilter": { "title": "Insider ownership", "enum": [ "", "low", "high", "veryhigh", "o10", "o20", "o30", "o40", "o50", "o60", "o70", "o80", "o90" ], "type": "string", "description": "Filter by percent of shares owned by company insiders (screener mode).", "default": "" }, "instOwnFilter": { "title": "Institutional ownership", "enum": [ "", "low", "high", "u90", "u80", "u70", "u60", "u50", "u40", "u30", "u20", "u10", "o10", "o20", "o30", "o40", "o50", "o60", "o70", "o80", "o90" ], "type": "string", "description": "Filter by percent of shares owned by institutions (screener mode).", "default": "" }, "evEbitdaFilter": { "title": "EV/EBITDA", "enum": [ "", "negative", "low", "profitable", "high", "u5", "u10", "u15", "u20", "u25", "u30", "u35", "u40", "u45", "u50", "o5", "o10", "o15", "o20", "o25", "o30", "o35", "o40", "o45", "o50" ], "type": "string", "description": "Filter by enterprise value to EBITDA ratio (screener mode).", "default": "" }, "pfcfFilter": { "title": "Price/Free Cash Flow", "enum": [ "", "low", "high", "u5", "u10", "u15", "u20", "u25", "u30", "u35", "u40", "u45", "u50", "u60", "u70", "u80", "u90", "u100", "o5", "o10", "o15", "o20", "o25", "o30", "o35", "o40", "o45", "o50", "o60", "o70", "o80", "o90", "o100" ], "type": "string", "description": "Filter by price to free cash flow ratio (screener mode).", "default": "" }, "epsGrowthTTMFilter": { "title": "EPS growth (TTM Y/Y)", "enum": [ "", "neg", "pos", "poslow", "high", "u5", "u10", "u15", "u20", "u25", "u30", "o5", "o10", "o15", "o20", "o25", "o30" ], "type": "string", "description": "Filter by trailing-twelve-months EPS growth vs. the prior TTM period (screener mode).", "default": "" }, "salesGrowthTTMFilter": { "title": "Sales growth (TTM Y/Y)", "enum": [ "", "neg", "pos", "poslow", "high", "u5", "u10", "u15", "u20", "u25", "u30", "o5", "o10", "o15", "o20", "o25", "o30" ], "type": "string", "description": "Filter by trailing-twelve-months revenue growth vs. the prior TTM period (screener mode).", "default": "" }, "insiderTransFilter": { "title": "Insider transactions (6-month change)", "enum": [ "", "veryneg", "neg", "pos", "verypos", "u-90", "u-80", "u-70", "u-60", "u-50", "u-45", "u-40", "u-35", "u-30", "u-25", "u-20", "u-15", "u-10", "u-5", "o5", "o10", "o15", "o20", "o25", "o30", "o35", "o40", "o45", "o50", "o60", "o70", "o80", "o90" ], "type": "string", "description": "Filter by percent change in insider ownership over the last 6 months (screener mode).", "default": "" }, "instTransFilter": { "title": "Institutional transactions (3-month change)", "enum": [ "", "veryneg", "neg", "pos", "verypos", "u-50", "u-45", "u-40", "u-35", "u-30", "u-25", "u-20", "u-15", "u-10", "u-5", "o5", "o10", "o15", "o20", "o25", "o30", "o35", "o40", "o45", "o50" ], "type": "string", "description": "Filter by percent change in institutional ownership over the last 3 months (screener mode).", "default": "" }, "highLow52wFilter": { "title": "52-week high/low proximity", "enum": [ "", "nh", "nl", "b5h", "b10h", "b15h", "b20h", "b30h", "b40h", "b50h", "b60h", "b70h", "b80h", "b90h", "b0to3h", "b0to5h", "b0to10h", "a5h", "a10h", "a15h", "a20h", "a30h", "a40h", "a50h", "a60h", "a70h", "a80h", "a90h", "a100h", "a120h", "a150h", "a200h", "a300h", "a500h", "a0to3h", "a0to5h", "a0to10h" ], "type": "string", "description": "Filter by how close the price is to its 52-week high or low (screener mode).", "default": "" }, "smaFilter50": { "title": "Price vs SMA50", "enum": [ "", "pb", "pb10", "pb20", "pb30", "pb40", "pb50", "pa", "pa10", "pa20", "pa30", "pa40", "pa50", "pc", "pca", "pcb", "cross20", "cross20a", "cross20b", "cross200", "cross200a", "cross200b", "sa20", "sb20", "sa200", "sb200" ], "type": "string", "description": "Filter by the stock's price relative to its 50-day simple moving average, including SMA20/SMA200 crossovers (screener mode).", "default": "" }, "smaFilter20": { "title": "Price vs SMA20", "enum": [ "", "pb", "pb10", "pb20", "pb30", "pb40", "pb50", "pa", "pa10", "pa20", "pa30", "pa40", "pa50", "pc", "pca", "pcb", "cross50", "cross50a", "cross50b", "cross200", "cross200a", "cross200b", "sa50", "sb50", "sa200", "sb200" ], "type": "string", "description": "Filter by the stock's price relative to its 20-day simple moving average, including SMA50/SMA200 crossovers (screener mode).", "default": "" }, "smaFilter200": { "title": "Price vs SMA200", "enum": [ "", "pb", "pb10", "pb20", "pb30", "pb40", "pb50", "pb60", "pb70", "pb80", "pb90", "pa", "pa10", "pa20", "pa30", "pa40", "pa50", "pa60", "pa70", "pa80", "pa90", "pa100", "pc", "pca", "pcb", "cross20", "cross20a", "cross20b", "cross50", "cross50a", "cross50b", "sa20", "sb20", "sa50", "sb50" ], "type": "string", "description": "Filter by the stock's price relative to its 200-day simple moving average, including SMA20/SMA50 crossovers (screener mode).", "default": "" }, "todayChangeFilter": { "title": "Today's change %", "enum": [ "", "u", "u1", "u2", "u3", "u4", "u5", "u6", "u7", "u8", "u9", "u10", "u15", "u20", "d", "d1", "d2", "d3", "d4", "d5", "d6", "d7", "d8", "d9", "d10", "d15", "d20" ], "type": "string", "description": "Filter by today's price change percentage (screener mode).", "default": "" }, "gapFilter": { "title": "Gap %", "enum": [ "", "u", "u0", "u1", "u2", "u3", "u4", "u5", "u6", "u7", "u8", "u9", "u10", "u15", "u20", "d", "d0", "d1", "d2", "d3", "d4", "d5", "d6", "d7", "d8", "d9", "d10", "d15", "d20" ], "type": "string", "description": "Filter by today's opening gap percentage vs. the prior close (screener mode).", "default": "" }, "ltDebtEqFilter": { "title": "LT Debt/Equity", "enum": [ "", "high", "u1", "u0.9", "u0.8", "u0.7", "u0.6", "u0.5", "u0.4", "u0.3", "u0.2", "u0.1", "o0.1", "o0.2", "o0.3", "o0.4", "o0.5", "o0.6", "o0.7", "o0.8", "o0.9", "o1" ], "type": "string", "description": "Filter by long-term debt-to-equity ratio (screener mode).", "default": "" }, "evSalesFilter": { "title": "EV/Sales", "enum": [ "", "positive", "high", "u1", "u2", "u3", "u4", "u5", "u6", "u7", "u8", "u9", "u10", "o1", "o2", "o3", "o4", "o5", "o6", "o7", "o8", "o9", "o10" ], "type": "string", "description": "Filter by enterprise-value-to-sales ratio (screener mode).", "default": "" }, "priceCashFilter": { "title": "Price/Cash", "enum": [ "", "high", "u1", "u2", "u3", "u4", "u5", "u6", "u7", "u8", "u9", "u10", "o1", "o2", "o3", "o4", "o5", "o6", "o7", "o8", "o9", "o10", "o20", "o30", "o40", "o50" ], "type": "string", "description": "Filter by price-to-cash-per-share ratio (screener mode).", "default": "" }, "payoutRatioFilter": { "title": "Payout ratio", "enum": [ "", "none", "pos", "high", "o0", "o10", "o20", "o30", "o40", "o50", "o60", "o70", "o80", "o90", "o100", "u10", "u20", "u30", "u40", "u50", "u60", "u70", "u80", "u90", "u100" ], "type": "string", "description": "Filter by dividend payout ratio (screener mode).", "default": "" }, "epsGrowthNext5YFilter": { "title": "EPS growth next 5 years", "enum": [ "", "pos", "high", "u5", "u10", "u15", "u20", "u25", "u30", "o5", "o10", "o15", "o20", "o25", "o30" ], "type": "string", "description": "Filter by analyst-estimated long-term (5-year) EPS growth rate (screener mode).", "default": "" }, "epsGrowthNextYearFilter": { "title": "EPS growth next year", "enum": [ "", "pos", "poslow", "high", "u5", "u10", "u15", "u20", "u25", "u30", "o5", "o10", "o15", "o20", "o25", "o30" ], "type": "string", "description": "Filter by estimated EPS growth for next year (screener mode).", "default": "" }, "epsGrowthPast3YFilter": { "title": "EPS growth past 3 years", "enum": [ "", "pos", "poslow", "high", "u5", "u10", "u15", "u20", "u25", "u30", "o5", "o10", "o15", "o20", "o25", "o30" ], "type": "string", "description": "Filter by EPS growth over the past 3 years (screener mode).", "default": "" }, "epsGrowthPast5YFilter": { "title": "EPS growth past 5 years", "enum": [ "", "pos", "poslow", "high", "u5", "u10", "u15", "u20", "u25", "u30", "o5", "o10", "o15", "o20", "o25", "o30" ], "type": "string", "description": "Filter by EPS growth over the past 5 years (screener mode).", "default": "" }, "salesGrowthPast3YFilter": { "title": "Sales growth past 3 years", "enum": [ "", "pos", "poslow", "high", "u5", "u10", "u15", "u20", "u25", "u30", "o5", "o10", "o15", "o20", "o25", "o30" ], "type": "string", "description": "Filter by revenue growth over the past 3 years (screener mode).", "default": "" }, "salesGrowthPast5YFilter": { "title": "Sales growth past 5 years", "enum": [ "", "pos", "poslow", "high", "u5", "u10", "u15", "u20", "u25", "u30", "o5", "o10", "o15", "o20", "o25", "o30" ], "type": "string", "description": "Filter by revenue growth over the past 5 years (screener mode).", "default": "" }, "epsGrowthQoQFilter": { "title": "EPS growth quarter over quarter", "enum": [ "", "pos", "poslow", "high", "u5", "u10", "u15", "u20", "u25", "u30", "o5", "o10", "o15", "o20", "o25", "o30" ], "type": "string", "description": "Filter by EPS growth vs. the prior quarter (screener mode).", "default": "" }, "salesGrowthQoQFilter": { "title": "Sales growth quarter over quarter", "enum": [ "", "pos", "poslow", "high", "u5", "u10", "u15", "u20", "u25", "u30", "o5", "o10", "o15", "o20", "o25", "o30" ], "type": "string", "description": "Filter by revenue growth vs. the prior quarter (screener mode).", "default": "" }, "dividendGrowthFilter": { "title": "Dividend growth", "enum": [ "", "1ypos", "1yo5", "1yo10", "1yo15", "1yo20", "1yo25", "1yo30", "3ypos", "3yo5", "3yo10", "3yo15", "3yo20", "3yo25", "3yo30", "5ypos", "5yo5", "5yo10", "5yo15", "5yo20", "5yo25", "5yo30", "cy1", "cy2", "cy3", "cy4", "cy5", "cy6", "cy7", "cy8", "cy9" ], "type": "string", "description": "Filter by dividend growth over 1/3/5-year and consecutive-year-streak windows (screener mode).", "default": "" }, "allTimeHighLowFilter": { "title": "All-time high/low", "enum": [ "", "nh", "nl", "b5h", "b10h", "b15h", "b20h", "b30h", "b40h", "b50h", "b60h", "b70h", "b80h", "b90h", "b0to3h", "b0to5h", "b0to10h", "a5h", "a10h", "a15h", "a20h", "a30h", "a40h", "a50h", "a60h", "a70h", "a80h", "a90h", "a100h", "a120h", "a150h", "a200h", "a300h", "a500h", "a0to3h", "a0to5h", "a0to10h" ], "type": "string", "description": "Filter by proximity to the stock's all-time high or low price (screener mode).", "default": "" }, "highLow20DFilter": { "title": "20-day high/low", "enum": [ "", "nh", "nl", "b5h", "b10h", "b15h", "b20h", "b30h", "b40h", "b50h", "b0to3h", "b0to5h", "b0to10h", "a5h", "a10h", "a15h", "a20h", "a30h", "a40h", "a50h", "a0to3h", "a0to5h", "a0to10h" ], "type": "string", "description": "Filter by proximity to the 20-day trading high or low (screener mode).", "default": "" }, "highLow50DFilter": { "title": "50-day high/low", "enum": [ "", "nh", "nl", "b5h", "b10h", "b15h", "b20h", "b30h", "b40h", "b50h", "b0to3h", "b0to5h", "b0to10h", "a5h", "a10h", "a15h", "a20h", "a30h", "a40h", "a50h", "a0to3h", "a0to5h", "a0to10h" ], "type": "string", "description": "Filter by proximity to the 50-day trading high or low (screener mode).", "default": "" }, "atrFilter": { "title": "Average True Range (ATR)", "enum": [ "", "o0.25", "o0.5", "o0.75", "o1", "o1.5", "o2", "o2.5", "o3", "o3.5", "o4", "o4.5", "o5", "u0.25", "u0.5", "u0.75", "u1", "u1.5", "u2", "u2.5", "u3", "u3.5", "u4", "u4.5", "u5" ], "type": "string", "description": "Filter by Average True Range, a volatility measure in price units (screener mode).", "default": "" }, "changeFromOpenFilter": { "title": "Change from open", "enum": [ "", "u", "u1", "u2", "u3", "u4", "u5", "u6", "u7", "u8", "u9", "u10", "u15", "u20", "d", "d1", "d2", "d3", "d4", "d5", "d6", "d7", "d8", "d9", "d10", "d15", "d20" ], "type": "string", "description": "Filter by percent change of current price from today's opening price (screener mode).", "default": "" }, "volatilityFilter": { "title": "Volatility (week/month)", "enum": [ "", "wo2", "wo3", "wo4", "wo5", "wo6", "wo7", "wo8", "wo9", "wo10", "wo12", "wo15", "mo2", "mo3", "mo4", "mo5", "mo6", "mo7", "mo8", "mo9", "mo10", "mo12", "mo15" ], "type": "string", "description": "Filter by weekly or monthly price volatility (screener mode).", "default": "" }, "performance2Filter": { "title": "Performance (extended)", "enum": [ "", "dup", "ddown", "d15u", "d10u", "d5u", "d5o", "d10o", "d15o", "1w30u", "1w20u", "1w10u", "1wdown", "1wup", "1w10o", "1w20o", "1w30o", "4w50u", "4w30u", "4w20u", "4w10u", "4wdown", "4wup", "4w10o", "4w20o", "4w30o", "4w50o", "13w50u", "13w30u", "13w20u", "13w10u", "13wdown", "13wup", "13w10o", "13w20o", "13w30o", "13w50o", "26w75u", "26w50u", "26w30u", "26w20u", "26w10u", "26wdown", "26wup", "26w10o", "26w20o", "26w30o", "26w50o", "26w100o", "ytd75u", "ytd50u", "ytd30u", "ytd20u", "ytd10u", "ytd5u", "ytddown", "ytdup", "ytd5o", "ytd10o", "ytd20o", "ytd30o", "ytd50o", "ytd100o", "52w75u", "52w50u", "52w30u", "52w20u", "52w10u", "52wdown", "52wup", "52w10o", "52w20o", "52w30o", "52w50o", "52w100o", "52w200o", "52w300o", "52w500o", "3y90u", "3y75u", "3y50u", "3y30u", "3y20u", "3y10u", "3ydown", "3yup", "3y10o", "3y20o", "3y30o", "3y50o", "3y100o", "3y200o", "3y300o", "3y500o", "3y1000o", "5y90u", "5y75u", "5y50u", "5y30u", "5y20u", "5y10u", "5ydown", "5yup", "5y10o", "5y20o", "5y30o", "5y50o", "5y100o", "5y200o", "5y300o", "5y500o", "5y1000o", "10y90u", "10y75u", "10y50u", "10y30u", "10y20u", "10y10u", "10ydown", "10yup", "10y10o", "10y20o", "10y30o", "10y50o", "10y100o", "10y200o", "10y300o", "10y500o", "10y1000o" ], "type": "string", "description": "Filter by price performance over an extended set of periods, including 3/5/10-year windows not covered by the standard Performance filter (screener mode).", "default": "" }, "patternFilter": { "title": "Chart Pattern", "enum": [ "", "horizontal", "horizontal2", "tlresistance", "tlresistance2", "tlsupport", "tlsupport2", "wedgeup", "wedgeup2", "wedgedown", "wedgedown2", "wedgeresistance", "wedgeresistance2", "wedgesupport", "wedgesupport2", "wedge", "wedge2", "channelup", "channelup2", "channeldown", "channeldown2", "channel", "channel2", "doubletop", "doublebottom", "multipletop", "multiplebottom", "headandshoulders", "headandshouldersinv" ], "type": "string", "description": "Filter by detected technical chart pattern (screener mode).", "default": "" }, "candlestickFilter": { "title": "Candlestick Pattern", "enum": [ "", "lls", "lus", "h", "ih", "stw", "stb", "d", "dd", "gd", "mw", "mb" ], "type": "string", "description": "Filter by detected candlestick pattern on the latest bar (screener mode).", "default": "" }, "etfAssetType": { "title": "ETF Asset Type", "enum": [ "", "equitiesstocks", "equitiesstocksipobased", "bonds", "commoditiesmetals", "cryptocurrency", "currency", "carbontrading", "closedendfunds", "freightfutures", "hedgefundreplication", "mlp", "multiassetconservative", "multiassetmoderate", "multiassetgrowthaggressive", "multiassettacticalactive", "multiassetspreadbetweenassetclasses", "multiassettargetdate2030", "multiassettargetdate2035", "multiassettargetdate2040", "multiassettargetdate2045", "multiassettargetdate2050", "multiassettargetdate2055", "multiassettargetdate2060", "multiassettargetdate2065" ], "type": "string", "description": "Restrict screener results to ETFs of a specific asset class (screener mode). Finviz's screener merges stocks and ETFs by default; use this to fetch only ETFs of the chosen type instead of stocks.", "default": "" }, "insiderTransactionType": { "title": "Insider transaction type", "enum": [ "all", "buy", "sale" ], "type": "string", "description": "Filter which transaction types to include (insiderTrading mode). Finviz's free tier exposes the latest ~200 market-wide transactions per type.", "default": "all" }, "groupBy": { "title": "Group by", "enum": [ "sector", "industry", "country", "capitalization" ], "type": "string", "description": "How to aggregate stocks into groups (groupPerformance mode).", "default": "sector" }, "groupView": { "title": "Group view", "enum": [ "overview", "valuation", "performance", "financial" ], "type": "string", "description": "Which metric set to return for each group (groupPerformance mode).", "default": "overview" }, "industrySector": { "title": "Industry parent sector filter", "enum": [ "", "basicmaterials", "communicationservices", "consumercyclical", "consumerdefensive", "energy", "financial", "healthcare", "industrials", "realestate", "technology", "utilities" ], "type": "string", "description": "Optionally narrow the industry breakdown to industries within one parent sector (only applies when Group by = Industry).", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of records to return.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Finviz blocks Apify's datacenter IPs, so Apify Proxy (residential) is used by default to reliably fetch pages.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }