{ "openapi": "3.0.1", "info": { "title": "Finviz Stock Screener Scraper", "description": "Screen 11,000+ US-listed stocks on Finviz with 30+ signal presets and 9 filter dimensions. Enriches each ticker with 70+ fundamental and technical fields. No API key required.", "version": "0.1", "x-build-id": "VuRScgFPNP0w11eWO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~finviz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~finviz-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-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/parseforge~finviz-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-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", "properties": { "tickers": { "title": "Tickers", "type": "array", "description": "Restrict the screen to a specific list of tickers. Up to ~500 symbols. Leave empty to scan the full 11,000+ universe with the filters below.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000." }, "signal": { "title": "Signal preset", "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": "Top gainers, latest insider buys, oversold, earnings tonight, etc. Apply a Finviz built-in scan in one click.", "default": "" }, "exchange": { "title": "Exchange", "enum": [ "", "amex", "cboe", "nasd", "nyse" ], "type": "string", "description": "Stock exchange.", "default": "" }, "index": { "title": "Index membership", "enum": [ "", "sp500", "ndx", "dji", "rut" ], "type": "string", "description": "Only include constituents of a major index.", "default": "" }, "sector": { "title": "Sector", "enum": [ "", "basicmaterials", "communicationservices", "consumercyclical", "consumerdefensive", "energy", "financial", "healthcare", "industrials", "realestate", "technology", "utilities" ], "type": "string", "description": "GICS-style sector grouping.", "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": "Specific industry. Use Stocks only / Stocks only ex-Funds to exclude ETFs.", "default": "" }, "country": { "title": "Country", "enum": [ "", "usa", "notusa", "asia", "europe", "latinamerica", "bric", "argentina", "australia", "bahamas", "belgium", "benelux", "bermuda", "brazil", "canada", "caymanislands", "chile", "china", "chinahongkong", "colombia", "cyprus", "denmark", "finland", "france", "germany", "greece", "hongkong", "hungary", "iceland", "india", "indonesia", "ireland", "israel", "italy", "japan", "jordan", "kazakhstan", "luxembourg", "malaysia", "malta", "mexico", "monaco", "netherlands", "newzealand", "norway", "panama", "peru", "philippines", "portugal", "russia", "singapore", "southafrica", "southkorea", "spain", "sweden", "switzerland", "taiwan", "thailand", "turkey", "unitedarabemirates", "unitedkingdom", "uruguay", "vietnam" ], "type": "string", "description": "Country of company headquarters.", "default": "" }, "marketCap": { "title": "Market Cap", "enum": [ "", "mega", "large", "mid", "small", "micro", "nano", "largeover", "midover", "smallover", "microover", "largeunder", "midunder", "smallunder", "microunder" ], "type": "string", "description": "Market capitalization bucket.", "default": "" }, "customFilters": { "title": "Custom raw filters", "type": "string", "description": "Advanced: raw Finviz filter expression to append, comma separated, without the leading f= (e.g. fa_pe_low20,ta_sma200_pa). Combined AND with the dropdowns above." }, "sortBy": { "title": "Sort by", "enum": [ "", "ticker", "company", "sector", "industry", "country", "marketcap", "pe", "forwardpe", "peg", "ps", "pb", "pc", "dividendyield", "eps_yoy_ttm", "sales_yoy_ttm", "roa", "roe", "roi", "grossmargin", "opermargin", "profitmargin", "insiderown", "insidertransactions", "instown", "insttrans", "shortfloat", "beta", "volatility", "rsi", "perf1w", "perf4w", "perf13w", "perf26w", "perfytd", "perf52w", "price", "change", "volume", "averagevolume", "relativevolume" ], "type": "string", "description": "Column used to order results.", "default": "" }, "sortDirection": { "title": "Sort direction", "enum": [ "asc", "desc" ], "type": "string", "description": "Ascending or descending.", "default": "desc" }, "enrich": { "title": "Enrich with full quote data", "type": "boolean", "description": "For each ticker, also fetch the dedicated Finviz quote page and merge 70+ extra fundamentals, technicals, ownership, and analyst fields. Adds one HTTP request per ticker.", "default": true } } }, "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 } } } } } } } } } }