Finviz Stocks Scraper (Fundamentals, Screener, Insider)

Here is one real result, with every field the actor returns in quote mode:

{
  "ticker": "AAPL",
  "company": "Apple Inc",
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "country": "USA",
  "exchange": "NASD",
  "marketCapClass": "Mega",
  "index": "DJIA, NDX, S&P 500",
  "marketCap": 4622120000000,
  "enterpriseValue": 4644070000000,
  "income": 128930000000,
  "sales": 466820000000,
  "bookPerShare": 7.36,
  "cashPerShare": 4.28,
  "dividendPercent": 0.34,
  "dividendTtm": 0.33,
  "employees": 166000,
  "ipoDate": "Dec 12, 1980",
  "peRatio": 36.31,
  "forwardPe": 33.19,
  "pegRatio": 2.64,
  "priceToSales": 9.9,
  "priceToBook": 43.03,
  "priceToCash": 74.07,
  "priceToFcf": 33.82,
  "evToEbitda": 27.65,
  "evToSales": 9.95,
  "quickRatio": 0.93,
  "currentRatio": 1,
  "debtToEquity": 0.78,
  "ltDebtToEquity": 0.66,
  "epsTtm": 8.72,
  "epsNextY": 9.54,
  "epsNextQ": 1.98,
  "epsThisYGrowth": 18.46,
  "epsNextYGrowth": 7.98,
  "epsNext5YGrowth": 12.57,
  "epsPast5YGrowth": 17.91,
  "salesPast5YGrowth": 8.71,
  "epsYoYTtm": 32.57,
  "salesYoYTtm": 14.24,
  "epsQoQ": 29.13,
  "salesQoQ": 16.36,
  "earningsDate": "Jul 30 AMC",
  "insiderOwn": 0.12,
  "insiderTrans": -2.23,
  "instOwn": 67.84,
  "instTrans": 0,
  "roa": 36.08,
  "roe": 148.75,
  "roic": 72.08,
  "grossMargin": 48.65,
  "operatingMargin": 33.17,
  "profitMargin": 27.62,
  "payoutRatio": 13.66,
  "sma20": 0.29,
  "sma50": 2.18,
  "sma200": 12.58,
  "sharesOutstanding": 14610000000,
  "sharesFloat": 14580000000,
  "shortFloat": 0.97,
  "shortRatio": 2.51,
  "shortInterest": 141610000,
  "high52w": 344.57,
  "high52wPercent": -8.09,
  "low52w": 223.78,
  "low52wPercent": 41.53,
  "atr": 7.25,
  "rsi": 53.73,
  "beta": 1.08,
  "relVolume": 0.04,
  "avgVolume": 56330000,
  "volume": 126629,
  "perfWeek": 3.75,
  "perfMonth": -2.82,
  "perfQuarter": 4.78,
  "perfHalfYear": 21.54,
  "perfYear": 40.13,
  "perfYtd": 16.5,
  "perf3Y": 81.51,
  "perf5Y": 113.72,
  "perf10Y": 1058.41,
  "analystRecom": 2.06,
  "targetPrice": 334.23,
  "prevClose": 316.83,
  "price": 316.71,
  "changePercent": -0.04,
  "url": "https://finviz.com/quote.ashx?t=AAPL",
  "source": "finviz.com",
  "observedAt": "2026-08-20T11:26:48.418Z",
  "error": null
}

The most complete Finviz stock scraper available. It returns every metric the Finviz snapshot table exposes for each ticker as clean parsed numbers, runs the Finviz screener with friendly filters, and can attach the insider-trading table, latest news headlines and an AI valuation read on demand.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor has two modes.

In quote mode it reads the Finviz quote page for each ticker you pass and returns one record with the full snapshot table parsed into clean numeric fields: valuation (P/E, forward P/E, PEG, P/S, P/B, EV/EBITDA), profitability (ROE, ROA, ROIC, gross, operating and profit margins), balance sheet (debt to equity, current and quick ratios), ownership (insider and institutional), short interest, technicals (RSI, ATR, beta, SMA distances, 52-week high and low), and performance across every window from week to ten years. Company header fields (name, sector, industry, country, exchange, market-cap class) come along with it. Percentages are returned as plain numbers (for example 27.62 for 27.62%) and sizes are expanded to full integers (for example 4622120000000), so no post-processing is needed.

In screener mode it runs the Finviz screener with the filters you set, paginates the full result set, and returns one row per matching stock with ticker, company, sector, industry, country, market cap, P/E, price, change and volume.

Two optional add-ons enrich quote-mode records: an insider-and-news add-on that attaches the insider-trading table and the latest news headlines for the ticker, and an AI summary add-on that adds a valuation read, financial-health note, notable signals and a one-line take built from the fundamentals.

Quickstart

Open the actor, paste this into the input, and press Run. It returns the full fundamentals snapshot for three tickers.

{
  "mode": "quote",
  "tickers": ["AAPL", "MSFT", "NVDA"],
  "maxResults": 10
}

To screen instead of quoting, switch mode and pass filters:

{
  "mode": "screener",
  "marketCap": "large",
  "sector": "Technology",
  "maxResults": 50
}

Input reference

Field	Type	Required	Default	Description
mode	enum	no	quote	quote pulls the full fundamentals snapshot per ticker. screener lists stocks matching filters.
tickers	string[]	for quote	["AAPL","MSFT","NVDA"]	Tickers to pull fundamentals for in quote mode, for example AAPL, MSFT, NVDA. One record per ticker.
screenerFilters	string	no	(empty)	Screener mode. Raw Finviz f= value, for example cap_large,sec_technology,fa_pe_u20. Combined with the friendly filters below.
marketCap	enum	no	(any)	Screener friendly filter: mega, large, mid, small, micro, nano, large+, small-.
sector	enum	no	(any)	Screener friendly filter for sector, for example Technology, Healthcare, Energy.
exchange	enum	no	(any)	Screener friendly filter: NASDAQ, NYSE, AMEX.
index	enum	no	(any)	Screener friendly filter: SP500, DJIA, NASDAQ100.
maxResults	integer	no	10	Maximum stock records to collect across the run. Free Apify plans are capped at 10 per run.
includeInsiderNews	boolean	no	false	Quote mode paid add-on. Attach the insider-trading table and latest news headlines per ticker. Charged only when real rows are returned.
aiStockSummary	boolean	no	false	Quote mode paid add-on. Add an AI valuation read, financial-health note, notable signals and a one-line summary. Charged only when a usable summary is returned.

Quote mode requires at least one ticker. Screener mode requires at least one filter (raw or friendly).

Output reference

One dataset item per stock. Numeric fields are returned as numbers or null when Finviz shows no value. Percentage metrics are plain numbers without the % sign.

Field	Type	Description
ticker	string	Stock ticker symbol.
company	string	Company name.
sector	string	Sector.
industry	string	Industry.
country	string	Country of the company.
exchange	string	Listing exchange code (quote mode).
marketCapClass	string	Market-cap class, for example Mega, Large, Mid (quote mode).
index	string	Indices the stock belongs to (quote mode).
marketCap	number	Market capitalization in USD.
enterpriseValue	number	Enterprise value in USD.
income	number	Net income ttm in USD.
sales	number	Revenue ttm in USD.
bookPerShare	number	Book value per share.
cashPerShare	number	Cash per share.
dividendPercent	number	Forward dividend yield percent.
dividendTtm	number	Trailing dividend yield percent.
employees	number	Number of employees.
ipoDate	string	IPO date.
peRatio	number	Trailing P/E ratio.
forwardPe	number	Forward P/E ratio.
pegRatio	number	PEG ratio.
priceToSales	number	Price to sales ratio.
priceToBook	number	Price to book ratio.
priceToCash	number	Price to cash ratio.
priceToFcf	number	Price to free cash flow ratio.
evToEbitda	number	EV / EBITDA.
evToSales	number	EV / Sales.
quickRatio	number	Quick ratio.
currentRatio	number	Current ratio.
debtToEquity	number	Total debt to equity.
ltDebtToEquity	number	Long-term debt to equity.
epsTtm	number	EPS ttm.
epsNextY	number	EPS estimate next year.
epsNextQ	number	EPS estimate next quarter.
epsThisYGrowth	number	EPS growth this year percent.
epsNextYGrowth	number	EPS growth next year percent.
epsNext5YGrowth	number	EPS growth next 5 years percent.
epsPast5YGrowth	number	EPS growth past 5 years percent.
salesPast5YGrowth	number	Sales growth past 5 years percent.
epsYoYTtm	number	EPS year over year ttm percent.
salesYoYTtm	number	Sales year over year ttm percent.
epsQoQ	number	EPS quarter over quarter percent.
salesQoQ	number	Sales quarter over quarter percent.
earningsDate	string	Next or last earnings date.
insiderOwn	number	Insider ownership percent.
insiderTrans	number	Insider transactions percent.
instOwn	number	Institutional ownership percent.
instTrans	number	Institutional transactions percent.
roa	number	Return on assets percent.
roe	number	Return on equity percent.
roic	number	Return on invested capital percent.
grossMargin	number	Gross margin percent.
operatingMargin	number	Operating margin percent.
profitMargin	number	Profit margin percent.
payoutRatio	number	Dividend payout ratio percent.
sma20	number	Price vs 20-day SMA percent.
sma50	number	Price vs 50-day SMA percent.
sma200	number	Price vs 200-day SMA percent.
sharesOutstanding	number	Shares outstanding.
sharesFloat	number	Share float.
shortFloat	number	Short interest as percent of float.
shortRatio	number	Short ratio in days to cover.
shortInterest	number	Short interest shares.
high52w	number	52-week high price.
high52wPercent	number	Percent from 52-week high.
low52w	number	52-week low price.
low52wPercent	number	Percent from 52-week low.
atr	number	Average true range (14).
rsi	number	Relative strength index (14).
beta	number	Beta.
relVolume	number	Relative volume.
avgVolume	number	Average volume.
volume	number	Volume.
perfWeek	number	Performance past week percent.
perfMonth	number	Performance past month percent.
perfQuarter	number	Performance past quarter percent.
perfHalfYear	number	Performance past half year percent.
perfYear	number	Performance past year percent.
perfYtd	number	Performance year to date percent.
perf3Y	number	Performance past 3 years percent.
perf5Y	number	Performance past 5 years percent.
perf10Y	number	Performance past 10 years percent.
analystRecom	number	Mean analyst recommendation, 1 buy to 5 sell.
targetPrice	number	Mean analyst price target.
prevClose	number	Previous close price.
price	number	Current or last price.
changePercent	number	Price change percent.
insiderTrades	object[]	Insider-trading rows (insider add-on), or null.
insiderTradeCount	number	Number of insider trades returned (insider add-on).
latestNews	object[]	Latest news headlines (insider add-on), or null.
newsCount	number	Number of news items returned (insider add-on).
aiValuation	string	AI valuation read (AI add-on).
aiFinancialHealth	string	AI financial-health note (AI add-on).
aiNotableSignals	string[]	AI notable signals (AI add-on).
aiOneLiner	string	AI one-line summary (AI add-on).
url	string	Source quote page URL.
source	string	Data source.
observedAt	string	ISO 8601 timestamp when the record was collected.
error	string	null on success. On an unknown ticker or failed run, a single item with a populated error field is written and not charged.

Screener-mode rows populate ticker, company, sector, industry, country, marketCap, peRatio, price, changePercent, volume, source and observedAt.

Example output record

Real screener row from a live run (input {"mode":"screener","marketCap":"large","sector":"Technology"}):

{
  "ticker": "ACN",
  "company": "Accenture plc",
  "sector": "Technology",
  "industry": "Information Technology Services",
  "country": "Ireland",
  "marketCap": 111970000000,
  "peRatio": 14.61,
  "price": 182.98,
  "changePercent": -0.1,
  "volume": 611,
  "source": "finviz.com",
  "observedAt": "2026-08-20T11:27:31.004Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~finviz-stocks-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"quote","tickers":["AAPL","MSFT","NVDA"],"maxResults":10}'

Start a screener run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~finviz-stocks-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"screener","index":"SP500","sector":"Healthcare","maxResults":100}'

Apify CLI:

apify call scrapers_lat/finviz-stocks-scraper \
  --input '{"mode":"quote","tickers":["TSLA"],"includeInsiderNews":true}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per stock record returned (result event), plus a small one-time apify-actor-start event per run. See the pricing tab for current prices.
• Optional add-ons. includeInsiderNews and aiStockSummary are off by default, charged only when they actually return data, and disabled on free plans.
• No charge on failure. An unknown ticker or a failed run writes a single item with a populated error field and is not charged. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxResults.

FAQ and troubleshooting

A quote returned an error row. Why? The ticker was not found on the source (unknown, delisted, or a bad symbol). The actor writes an error item for it and does not charge. Check the symbol and try again.

Are percentages returned with a % sign? No. Percentage metrics are parsed to plain numbers, so 27.62% becomes 27.62. Sizes such as market cap are expanded to full integers.

How do I screen with filters that are not in the friendly list? Use screenerFilters with a raw Finviz f= expression, for example cap_large,sec_technology,fa_pe_u20,ta_rsi_os30. It combines with the friendly filters.

What is in the insider and news add-on? The insider-trading table (insider name, relationship, date, transaction type, cost, shares, value, running total and SEC Form 4 date) and the latest news headlines with time, title, link and source, for the ticker.

Does this need a login or an API key? No. You never provide any credentials. Proxy and retries are handled internally.

Is this an official Finviz tool? No. This actor is independent and has no affiliation with Finviz. It reads only data that is publicly available on the site.

Related scrapers

• LATAM Stock Exchanges Scraper: listed companies and quotes from Latin American exchanges.
• SEC EDGAR Company Filings Scraper: SEC filings by ticker or CIK.
• FRED Economic Data Scraper: US and global economic time series.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with Finviz. Accesses only publicly available data.