📊 Finviz Stock Screener Scraper

Scrape Finviz.com stock screener results with powerful filtering. Get fundamental data, technical indicators, financial metrics, and more for thousands of stocks — all as clean, structured JSON.

Perfect for:

• Quantitative analysis — screen stocks by P/E, market cap, dividends, momentum
• Portfolio research — find stocks matching your investment criteria
• Market monitoring — track top gainers, losers, unusual volume, overbought/oversold
• Data pipelines — feed stock data into spreadsheets, databases, or trading systems

🚀 What It Does

1. Screen stocks using 20+ filter categories (market cap, sector, P/E, price, volume, RSI, SMA, and more)
2. Extract overview data — ticker, company name, sector, industry, country, market cap, P/E, price, change%, volume
3. Optionally scrape detailed pages — get 60+ fundamental metrics, news headlines, insider trading data, and analyst targets per stock
4. Handle pagination automatically — Finviz shows 20 results per page, this actor handles all of them
5. Output clean JSON ready for analysis

📋 Input Options

Quick Start — Paste a Finviz URL

Already configured filters on Finviz? Just paste the URL:

{
    "screenerUrl": "https://finviz.com/screener.ashx?v=151&f=cap_largeover,fa_pe_u20&ft=4"
}

Filter by Parameters

Use the built-in filter dropdowns:

{
    "marketCap": "cap_largeover",
    "sector": "sec_technology",
    "pe": "pe_u20",
    "dividendYield": "dividendyield_o2",
    "maxResults": 50
}

Look Up Specific Tickers

{
    "tickers": "AAPL,MSFT,GOOGL,AMZN,NVDA",
    "scrapeDetails": true
}

Pre-Built Signals

{
    "signal": "top_gainers",
    "maxResults": 20
}

Full Configuration Example

{
    "marketCap": "cap_largeover",
    "sector": "sec_technology",
    "pe": "pe_u30",
    "sma50": "ta_sma50_pa",
    "sma200": "ta_sma200_pa",
    "orderBy": "marketcap",
    "orderDirection": "desc",
    "scrapeDetails": true,
    "maxResults": 100,
    "requestDelay": 1000,
    "proxyConfig": {
        "useApifyProxy": true
    }
}

📊 Output Format

Overview Data (always included)

{
    "ticker": "AAPL",
    "company": "Apple Inc",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "country": "USA",
    "marketCap": "3842.49B",
    "marketCapRaw": 3842490000000,
    "pe": 33.11,
    "price": 261.73,
    "change": "-5.00%",
    "changeNum": -5.0,
    "volume": 77567270,
    "finvizUrl": "https://finviz.com/quote.ashx?t=AAPL&ty=c&ta=1&p=d"
}

Detailed Data (when scrapeDetails is enabled)

Adds 60+ additional fields per stock:

{
    "ticker": "AAPL",
    "company": "Apple Inc",
    "...": "...overview fields...",
    "eps": "7.90",
    "forwardPe": "28.20",
    "peg": "2.52",
    "ps": "8.82",
    "pb": "59.00",
    "dividendYield": "0.50%",
    "roa": "31.10%",
    "roe": "145.50%",
    "roi": "55.60%",
    "grossMargin": "46.90%",
    "operMargin": "33.70%",
    "profitMargin": "27.00%",
    "currentRatio": "0.90",
    "debtEquity": "1.51",
    "beta": "1.24",
    "rsi14": "42.10",
    "sma20": "-3.50%",
    "sma50": "-5.20%",
    "sma200": "1.10%",
    "targetPrice": "248.00",
    "analystRecommendation": "2.0",
    "earningsDate": "Jul 31/a",
    "insiderOwn": "0.10%",
    "instOwn": "65.67%",
    "shortFloat": "0.80%",
    "perfWeek": "-5.14%",
    "perfMonth": "0.26%",
    "perfQuarter": "-4.91%",
    "perfYear": "22.50%",
    "news": [
        {
            "date": "Today",
            "time": "05:57PM",
            "headline": "Apple fends off 4G wireless patent lawsuit",
            "source": "Reuters",
            "url": "https://..."
        }
    ],
    "insiderTrading": [
        {
            "insiderName": "Cook Timothy D",
            "relationship": "CEO",
            "date": "Apr 01",
            "transaction": "Sale",
            "cost": "236.40",
            "shares": "196,410",
            "value": "46,430,940"
        }
    ]
}

⚙️ Available Filters

Filter	Options
Market Cap	Mega ($200B+), Large ($10B+), Mid ($2B+), Small ($300M+), Micro ($50M+), Nano
Sector	Technology, Healthcare, Financial, Energy, Consumer, Industrials, etc.
Exchange	NYSE, NASDAQ, AMEX
Index	S&P 500, Dow Jones, NASDAQ 100
P/E Ratio	Low/High, Under/Over 5-50
Forward P/E	Under/Over 5-30
Dividend Yield	Positive, High (5%+), Very High (10%+), Over 1-10%
Price	Under/Over $1-$100
Average Volume	Over 50K-2M
Analyst Rec	Strong Buy, Buy, Hold, Sell, Strong Sell
RSI (14)	Overbought (60-90+), Oversold (10-40-)
SMA	20/50/200 Day — Above, Below, Cross
Performance	Day/Week/Month/Quarter/Half/Year — Up or Down
Signal	Top Gainers/Losers, New High/Low, Most Active, Unusual Volume, etc.
Custom Filters	Any Finviz filter code (for filters not listed above)

💡 Use Cases

Value Investing Screen

Find undervalued large-cap dividend stocks:

{
    "marketCap": "cap_largeover",
    "pe": "pe_u15",
    "dividendYield": "dividendyield_o3",
    "scrapeDetails": true,
    "maxResults": 50
}

Growth Stock Scanner

High-growth tech stocks above moving averages:

{
    "sector": "sec_technology",
    "marketCap": "cap_midover",
    "sma50": "ta_sma50_pa",
    "sma200": "ta_sma200_pa",
    "orderBy": "perfyear",
    "orderDirection": "desc"
}

Daily Market Movers

{
    "signal": "top_gainers",
    "maxResults": 20,
    "scrapeDetails": true
}

Oversold Bounce Candidates

{
    "rsi": "ta_rsi_os30",
    "marketCap": "cap_smallover",
    "volume": "sh_avgvol_o500",
    "scrapeDetails": true
}

⏱ Performance & Pricing

• Overview only: ~20 stocks/second (fast, lightweight)
• With details: ~1 stock/second (due to rate limiting on individual pages)
• Typical run: 100 stocks overview = ~10 seconds, 100 stocks with details = ~2 minutes

Pay-per-result pricing — you only pay for the stocks returned.

⚠️ Notes

• Finviz free tier is scraped (no API key needed)
• Rate limiting is built in — the actor respects Finviz's servers
• Enable Apify proxy for best reliability on cloud runs
• Finviz data updates during market hours (9:30 AM - 4:00 PM ET)
• Some financial data may show as "-" for stocks that don't report certain metrics

🔗 Links

• Finviz Screener — Configure filters visually, then paste the URL
• Finviz Filter Codes — All available filter parameters