finvizfinance

What it is and what it does

finvizfinance is a web scraper that extracts financial market data from the FinViz website and returns it as Python objects and pandas DataFrames. It covers individual stock quotes (fundamentals, technical charts, insider trades, news, peer comparisons, ETF holdings), financial news aggregation, insider trading activity, and multi-stock screeners filtered by sector, index, valuation metrics, and technical signals. The package wraps requests and BeautifulSoup to parse HTML and expose FinViz data without requiring an official API.

The package is designed for retail investors and traders who want programmatic access to FinViz's free financial research tools. It depends on pandas for data organization, requests for HTTP, and BeautifulSoup/lxml for HTML parsing. Because it scrapes a third-party website rather than calling an official API, it is inherently fragile: any layout change on FinViz can break the parsers. The last release was recent, but the project shows aging maintenance signals with no commits for several months.

Use it for:

• Build a stock screener that filters S&P 500 companies by sector and valuation metrics, returning results as a DataFrame.
• Fetch fundamental data (P/E, market cap, EPS) and insider trading activity for a ticker to inform buy/sell decisions.
• Aggregate recent financial news and blogs from FinViz into a single feed for market monitoring.
• Compare peer stocks and ETF holders for a given ticker to understand competitive landscape.
• Retrieve technical and fundamental ratings from FinViz analysts for a list of stocks in batch.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Scrapes financial data from FinViz website, providing stock fundamentals, charts, news, insider trading info, forex and crypto data, plus screeners for comparing multiple stocks.

Yes, if you accept the web-scraping risk. The package is straightforward to install, has no security vulnerabilities, and offers convenient access to FinViz data without writing your own parsers. However, maintenance is aging (223 days since last release), so expect potential breakage if FinViz redesigns their site. Best suited for personal projects or backtesting, not production systems that require high availability.

Install

finvizfinance on PyPI

pip install finvizfinance

uv add finvizfinance

poetry add finvizfinance

Installing finvizfinance

Before you install

Low install friction with four common dependencies (pandas, requests, beautifulsoup4, lxml). Last release was recent (2026-01-03), but maintenance status is aging with no activity for 223 days.

License in practice

MIT License (permissive) allows commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the license notice.

Quickstart

pip install finvizfinance

from finvizfinance.quote import finvizfinance
stock = finvizfinance('tsla')
fundamentals = stock.ticker_fundament()

Requires Python 3.9 or later. Depends on external FinViz website structure remaining stable; web scraping is fragile to layout changes.

Verify before relying

• Whether FinViz actively blocks or rate-limits automated scraping requests.
• How often the package maintainer updates it when FinViz changes their website layout.
• Whether the screener and group features work reliably across all filter combinations.

Package facts

Evidence: finvizfinance-1.3.0-py3-none-any.whl

Tags

More WWW/HTTP packages