Finviz Scraper - Stock Screener & Market Data

Scrape stock screening data from Finviz.com, covering 11,000+ US-listed stocks. Extract overview, valuation, financial, ownership, performance, and technical data with flexible filtering.

Features

• 6 data views: Overview, Valuation, Financial, Ownership, Performance, Technical
• Signal filters: Top Gainers, Top Losers, Most Active, Most Volatile, Overbought, Oversold, New High, New Low, Unusual Volume
• Sector/Industry filters: Filter by any of 11 sectors and 140+ industries
• Market cap filters: Mega, Large, Mid, Small, Micro, Nano
• Pagination: Automatically scrapes all pages up to your max results limit
• Lightweight: Uses Cheerio (no browser needed), fast and cost-effective

Input Parameters

Parameter	Type	Default	Description
view	select	overview	Data view: overview, valuation, financial, ownership, performance, technical
signal	select	(none)	Signal filter: top_gainers, top_losers, most_active, etc.
sector	select	(any)	Sector: technology, healthcare, financial, energy, etc.
industry	string	(any)	Industry code (e.g., semiconductors, biotechnology)
marketCap	select	(any)	Market cap: mega, large, mid, small, micro, nano
maxResults	integer	200	Max stocks to return (0 = all)
proxyConfiguration	object	-	Optional proxy settings

Output Fields by View

Overview (v=111)

ticker, company, sector, industry, country, marketCap, pe, price, change, volume

Valuation (v=121)

ticker, marketCap, pe, forwardPE, peg, ps, pb, pc, pfcf, epsThisY, epsNextY, epsPast5Y, epsNext5Y, salesPast5Y, price, change, volume

Financial (v=161)

ticker, marketCap, dividend, roa, roe, roic, currentRatio, quickRatio, ltDebtEq, debtEq, grossMargin, operMargin, profitMargin, earnings, price, change, volume

Ownership (v=131)

ticker, marketCap, outstanding, float, insiderOwn, insiderTrans, instOwn, instTrans, shortFloat, shortRatio, avgVolume, price, change, volume

Performance (v=141)

ticker, perfWeek, perfMonth, perfQuarter, perfHalf, perfYTD, perfYear, perf3Y, perf5Y, perf10Y, volatilityWeek, volatilityMonth, avgVolume, relVolume, price, change, volume

Technical (v=171)

ticker, beta, atr, sma20, sma50, sma200, high52W, low52W, rsi, price, change, changeFromOpen, gap, volume

Example Output (Overview)

{
    "ticker": "AAPL",
    "company": "Apple Inc",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "country": "USA",
    "marketCap": "3979.47B",
    "pe": "34.29",
    "price": 271.06,
    "change": "-0.87%",
    "volume": 38030105,
    "view": "overview",
    "scrapedAt": "2026-04-25T12:00:00.000Z"
}

Usage Examples

Get all mega-cap tech stocks (overview)

{
    "view": "overview",
    "sector": "technology",
    "marketCap": "mega",
    "maxResults": 100
}

Get today's top gainers with valuation data

{
    "view": "valuation",
    "signal": "ta_topgainers",
    "maxResults": 50
}

Get technical indicators for all stocks

{
    "view": "technical",
    "maxResults": 0
}

Get semiconductor industry ownership data

{
    "view": "ownership",
    "industry": "semiconductors",
    "maxResults": 500
}

Industry Codes

Common industry filter values (use lowercase, no spaces):

• semiconductors, softwareapplication, softwareinfrastructure
• biotechnology, medicaldevices, healthcareplans
• banksregional, banksdiversified, capitalmarkets, creditservices
• oilgasep, oilgasintegrated, oilgasmidstream
• internetretail, internetcontentinformation
• consumerelectronics, entertainement, restaurants

Cost

This scraper uses Cheerio (HTML parsing only, no browser). Typical costs:

• 200 stocks: ~20 seconds, minimal compute
• All 11,000+ stocks: ~10 minutes, ~550 page fetches

Notes

• Data is sourced from Finviz's free screener (no Elite subscription needed)
• Prices and market data reflect market hours / last close
• Rate limiting is built in (0.5-1s between page requests) to avoid blocks
• The scraper respects Finviz's pagination (20 rows per page)