Finviz Stock Screener Scraper

Scrape Finviz — the popular stock screener and market-visualization platform used by traders and investors. Screen thousands of US-listed stocks with 90+ fundamental, technical, and ownership filters, pull a full fundamentals snapshot for any ticker, fetch a ticker's latest news, monitor market-wide insider (SEC Form 4) transactions, or pull sector/industry/country/market-cap aggregate performance.

What this actor does

• Five modes: screener (default), stockOverview, newsForTicker, insiderTrading, groupPerformance
• Stock screener with 90+ combinable filters — exchange, sector, industry, market cap, country, index, theme/subtheme, valuation, growth, ownership, technical, and signal-based (Top Gainers, Unusual Volume, chart patterns, etc.)
• Stock overview returns a rich fundamentals snapshot for one ticker — valuation, ownership, technicals, and performance
• Optional extended metrics on the screener (includeExtendedMetrics) add ~45 more fields per row (Forward P/E, PEG, P/B, ROE/ROA/ROIC, margins, ownership %, moving averages, etc.)
• Insider trading and group performance modes cover market-wide SEC Form 4 filings and sector/industry/country/cap-tier aggregate stats
• Empty fields are omitted — a field only appears on a record if Finviz actually published a value for it

Output: per stock (mode = screener)

• ticker, company
• sector, industry, country
• marketCap, peRatio, price, change, volume
• avgVolume, float, short, analyst
• performanceWeek, performanceMonth, performanceQuarter, performanceYear, performanceYTD
• earningsDate
• finvizUrl — link to the stock's Finviz page
• recordType: "stock", scrapedAt

With includeExtendedMetrics: true, rows are additionally enriched with (when published): forwardPE, peg, ps, pb, pc, pfcf, epsThisYear, epsNextYear, epsPast5Y, epsNext5Y, salesPast5Y, sharesOutstanding, insiderOwn, insiderTrans, instOwn, instTrans, shortRatio, performanceHalfYear, performance3Y, performance5Y, performance10Y, volatilityWeek, volatilityMonth, relVolume, dividendYield, roa, roe, roic, currentRatio, quickRatio, ltDebtEq, debtEq, grossMargin, operMargin, profitMargin, beta, atr, sma20, sma50, sma200, pctFromHigh52w, pctFromLow52w, rsi, changeFromOpen, gap.

Output: stock fundamentals (mode = stockOverview)

Only the fields Finviz publishes for the given ticker are included — up to 80+ of:

• ticker, company, description, finvizUrl
• sector, industry, country, exchange, website, index
• Valuation: marketCap, enterpriseValue, income, sales, bookPerShare, cashPerShare, peRatio, forwardPE, peg, ps, pb, pc, pfcf, evEbitda, evSales
• Dividends: dividend, dividendYield, dividendEst, dividendTTM, dividendExDate, dividendGrowth3_5Y, payout
• Growth & EPS: eps, epsNextYear, epsNextYearGrowth, epsNextQ, epsThisYear, epsNext5Y, epsPast5Y, epsPast3_5Y, salesPast5Y, salesPast3_5Y, epsYoYTTM, salesYoYTTM, epsQoQ, salesQoQ, epsSalesSurprise
• Ownership: insiderOwn, insiderTrans, instOwn, instTrans, sharesOutstanding, float, short, shortRatio, shortInterest
• Financial health: quickRatio, currentRatio, debtEq, ltDebtEq, roa, roe, roi, roic, grossMargin, operMargin, profitMargin
• Technicals: sma20, sma50, sma200, high52w, low52w, pctFromHigh52w, pctFromLow52w, volatility, atr, rsi, beta, relVolume, avgVolume, volume, trades, optionable, shortable, optionShort
• Company info: employees, ipoDate
• Performance: performanceWeek, performanceMonth, performanceQuarter, performanceHalfYear, performanceYTD, performanceYear, performance3Y, performance5Y, performance10Y
• Trading: analyst, targetPrice, prevClose, price, change, earningsDate
• recordType: "stockOverview", scrapedAt

Output: per article (mode = newsForTicker)

• ticker
• headline
• source
• url
• publishedAt
• recordType: "news", scrapedAt

Output: per transaction (mode = insiderTrading)

• ticker, finvizUrl
• company
• owner — name of the insider
• relationship — e.g. CEO, Director, 10% Owner
• transactionDate
• transactionType — Buy / Sale / Option Exercise
• costPerShare
• shares
• value
• sharesTotal — post-transaction holding
• secFormUrl — link to the official SEC filing
• secFormFiledAt
• recordType: "insiderTrading", scrapedAt

Output: per group (mode = groupPerformance)

• groupName, groupBy, view
• stocksCount
• Fields present depend on the chosen groupView:
  • overview — marketCap, dividendYield, peRatio, forwardPE, peg, debtEq, ltDebtEq, shortFloat, analystRecom, change, volume
  • valuation — peRatio, forwardPE, peg, ps, pb, pc, pfcf, epsPast5Y, epsNext5Y, salesPast5Y, change, volume
  • performance — performanceWeek, performanceMonth, performanceQuarter, performanceHalfYear, performanceYear, performanceYTD, avgVolume, relVolume, change, volume
  • financial — roa, roe, roic, currentRatio, quickRatio, grossMargin, operMargin, profitMargin, change, volume
• recordType: "groupPerformance", scrapedAt

Input

Field	Type	Default	Description
mode	string	screener	screener / stockOverview / newsForTicker / insiderTrading / groupPerformance
ticker	string	–	Stock ticker, e.g. AAPL (required for stockOverview and newsForTicker)
exchange	string	–	AMEX / CBOE / NASDAQ / NYSE (screener)
sector	string	–	One of 11 market sectors (screener)
industry	string	–	One of 145+ granular industry sub-classifications, more specific than sector (screener)
index	string	–	S&P 500 / NASDAQ 100 / DJIA / Russell 2000 (screener)
signal	string	–	Technical/fundamental event, e.g. Top Gainers, Unusual Volume, chart patterns (screener)
marketCap	string	–	mega / large / mid / small / micro / nano (screener)
country	string	–	One of 60+ countries/regions (screener)
priceFilter	string	–	Share price range, e.g. Under $10, $5–$50 (screener)
avgVolumeFilter	string	–	3-month average daily volume tier (screener)
dividendYieldFilter	string	–	None / Positive / High / Very High / threshold (screener)
analystRecomFilter	string	–	Strong Buy through Strong Sell, incl. "or better/worse" (screener)
shortFloatFilter	string	–	Short interest as % of float (screener)
ipoDateFilter	string	–	How long ago the stock IPO'd (screener)
earningsDateFilter	string	–	Scheduled earnings-report timing (screener)
theme	string	–	Finviz thematic classification, e.g. AI, Cybersecurity, EVs (screener)
subtheme	string	–	Fine-grained slice within a theme, 268 options (screener)
targetPriceFilter	string	–	Analyst target price vs. current price (screener)
currentVolumeFilter	string	–	Today's trading volume (screener)
floatFilter	string	–	Public float, absolute or % of shares outstanding (screener)
relativeVolumeFilter	string	–	Today's volume relative to 3-month average (screener)
sharesOutstandingFilter	string	–	Total shares outstanding (screener)
optionableShortableFilter	string	–	Has listed options and/or is shortable (screener)
peFilter	string	–	Trailing P/E ratio (screener)
forwardPeFilter	string	–	Forward P/E ratio (screener)
pegFilter	string	–	PEG ratio (screener)
pbFilter	string	–	Price/Book ratio (screener)
psFilter	string	–	Price/Sales ratio (screener)
roeFilter	string	–	Return on Equity (screener)
debtEquityFilter	string	–	Total Debt/Equity ratio (screener)
epsGrowthThisYearFilter	string	–	This year's EPS growth (screener)
rsiFilter	string	–	14-day RSI (screener)
betaFilter	string	–	Beta / volatility vs. market (screener)
performanceFilter	string	–	Price performance over today/week/month/quarter/half/year/YTD (screener)
roaFilter	string	–	Return on Assets (screener)
roiFilter	string	–	Return on Investment (screener)
currentRatioFilter	string	–	Current ratio (screener)
quickRatioFilter	string	–	Quick ratio (screener)
grossMarginFilter	string	–	Gross profit margin (screener)
operMarginFilter	string	–	Operating profit margin (screener)
netMarginFilter	string	–	Net profit margin (screener)
insiderOwnFilter	string	–	% owned by company insiders (screener)
instOwnFilter	string	–	% owned by institutions (screener)
evEbitdaFilter	string	–	EV/EBITDA ratio (screener)
pfcfFilter	string	–	Price/Free Cash Flow ratio (screener)
epsGrowthTTMFilter	string	–	Trailing-12-month EPS growth vs. prior TTM (screener)
salesGrowthTTMFilter	string	–	Trailing-12-month revenue growth vs. prior TTM (screener)
insiderTransFilter	string	–	% change in insider ownership, last 6 months (screener)
instTransFilter	string	–	% change in institutional ownership, last 3 months (screener)
highLow52wFilter	string	–	Proximity to 52-week high/low (screener)
smaFilter50	string	–	Price relative to 50-day SMA, incl. crossovers (screener)
smaFilter20	string	–	Price relative to 20-day SMA, incl. crossovers (screener)
smaFilter200	string	–	Price relative to 200-day SMA, incl. crossovers (screener)
todayChangeFilter	string	–	Today's price change % (screener)
gapFilter	string	–	Today's opening gap % vs. prior close (screener)
ltDebtEqFilter	string	–	Long-term Debt/Equity ratio (screener)
evSalesFilter	string	–	EV/Sales ratio (screener)
priceCashFilter	string	–	Price/Cash ratio (screener)
payoutRatioFilter	string	–	Dividend payout ratio (screener)
epsGrowthNext5YFilter	string	–	Analyst-estimated 5-year EPS growth (screener)
epsGrowthNextYearFilter	string	–	Estimated EPS growth for next year (screener)
epsGrowthPast3YFilter	string	–	EPS growth over past 3 years (screener)
epsGrowthPast5YFilter	string	–	EPS growth over past 5 years (screener)
salesGrowthPast3YFilter	string	–	Revenue growth over past 3 years (screener)
salesGrowthPast5YFilter	string	–	Revenue growth over past 5 years (screener)
epsGrowthQoQFilter	string	–	EPS growth vs. prior quarter (screener)
salesGrowthQoQFilter	string	–	Revenue growth vs. prior quarter (screener)
dividendGrowthFilter	string	–	Dividend growth over 1/3/5-year or streak windows (screener)
allTimeHighLowFilter	string	–	Proximity to all-time high/low (screener)
highLow20DFilter	string	–	Proximity to 20-day trading high/low (screener)
highLow50DFilter	string	–	Proximity to 50-day trading high/low (screener)
atrFilter	string	–	Average True Range (screener)
changeFromOpenFilter	string	–	% change from today's open (screener)
volatilityFilter	string	–	Weekly/monthly price volatility (screener)
performance2Filter	string	–	Extended performance windows incl. 3/5/10-year (screener)
patternFilter	string	–	Detected technical chart pattern (screener)
candlestickFilter	string	–	Detected candlestick pattern on latest bar (screener)
etfAssetType	string	–	Restrict to ETFs of a given asset class instead of stocks (screener)
sortBy	string	–	Column to sort screener results by (screener)
sortDescending	boolean	false	Sort highest-to-lowest instead of lowest-to-highest (screener)
includeExtendedMetrics	boolean	false	Enrich every row with ~45 extra valuation/ownership/technical/performance fields — makes more requests per page (screener)
insiderTransactionType	string	all	all / buy / sale (insiderTrading)
groupBy	string	sector	sector / industry / country / capitalization (groupPerformance)
groupView	string	overview	overview / valuation / performance / financial (groupPerformance)
industrySector	string	–	Narrow groupBy=industry to one parent sector (groupPerformance)
maxItems	integer	50	Maximum number of records to return (1–5000)
proxyConfiguration	object	Apify residential proxy	Proxy settings — residential proxy is required (see FAQ)

Example: screen large-cap tech stocks

{
  "mode": "screener",
  "exchange": "NASDAQ",
  "sector": "Technology",
  "industry": "semiconductors",
  "marketCap": "large",
  "maxItems": 100
}

Example: today's top gainers with extended metrics

{
  "mode": "screener",
  "signal": "ta_topgainers",
  "includeExtendedMetrics": true,
  "maxItems": 50
}

Example: full fundamentals for one ticker

{
  "mode": "stockOverview",
  "ticker": "AAPL"
}

Example: market-wide insider buying

{
  "mode": "insiderTrading",
  "insiderTransactionType": "buy",
  "maxItems": 50
}

Example: sector performance leaderboard

{
  "mode": "groupPerformance",
  "groupBy": "sector",
  "groupView": "performance"
}

Use cases

• Investment research — build custom screens combining valuation, growth, ownership, and technical criteria
• Portfolio monitoring — track live performance and technical metrics for a watchlist
• Quantitative screening — feed screener output into algorithmic trading or backtesting pipelines
• News monitoring — track headlines for tickers you follow
• Insider-activity tracking — spot clusters of insider buying or selling across the whole market
• Sector and market analysis — compare sector/industry/country performance and valuation at a glance

FAQ

Q: How many stocks can I scrape per run? A: Up to 5,000 records in screener mode via maxItems.

Q: How current is the data? A: Finviz displays delayed quotes (typically 15–20 minutes), which is what this actor reflects. It does not use Finviz Elite real-time data.

Q: What markets/exchanges are covered? A: NYSE, NASDAQ, AMEX, and CBOE — US-listed equities and ETFs, matching what Finviz's public screener exposes.

Q: Can I filter by multiple sectors or industries in one run? A: Each run takes one sector/industry value. Run the actor multiple times with different values and merge the results if you need several.

Q: Can I screen for event-driven signals like "Top Gainers" or "Unusual Volume"? A: Yes — the signal input covers Top/Bottom movers, New High/Low, Most Active/Volatile, Unusual Volume, Overbought/Oversold, Analyst Upgrades/Downgrades, Recent Insider Buying/Selling, Major News, and chart patterns, and can be combined with any other filter.

Q: What does includeExtendedMetrics add, and why is it off by default? A: It enriches each screener row with ~45 additional valuation, ownership, technical, and multi-year performance fields sourced from Finviz's extra screener views. It's off by default because it takes noticeably longer per page of results.

Q: Is insiderTrading mode ticker-specific? A: No — it returns the latest market-wide SEC Form 4 transactions across all tickers, optionally filtered to buys or sales only. Finviz's free tier exposes roughly the latest 200 transactions per type.

Q: Why is residential proxy required? A: Finviz blocks requests coming from datacenter IP ranges. Residential proxy IPs are treated as regular browser traffic and load pages reliably, so the actor requires Apify's residential proxy group by default.

Q: Is this actor affiliated with Finviz? A: No, this is an independent third-party actor that reads Finviz's public website; it is not affiliated with or endorsed by Finviz.