Registry / data / finvizfinance

finvizfinance

library1.3.0pypypiunverified

A Python library to download financial data from Finviz, including stock screeners, quotes, news, insider trades, and ETF holders. Current version 1.3.0, requires Python >=3.9. Released under MIT license with moderate release cadence (major updates every few months).

data

pip install finvizfinance

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · FINVIZFINANCE

finvizfinance

datapythonv1.3.0

Install

8.9s avg

Import

—

Disk

181MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.3.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 181.6MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 8.9s · import 0.000s · 174MB

181MB installed

● package 181MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

FinvizFinance

✓ from finvizfinance import FinvizFinance

✗ from finvizfinance import FinvizFinance

Fetches outer rating (broker ratings) for a stock ticker. No API key required.

from finvizfinance.quote import Quote # Get fundamental data for a ticker finviz = Quote() # Replace 'AAPL' with any stock symbol data = finviz.ticker_outer_rating('AAPL') print(data)

Debug

Known issues

breakingv1.0.0 changed the internal structure: `finvizfinance` objects now return dicts instead of pandas DataFrames in some methods. Code relying on DataFrame methods may break.

fix

Check return types: use `type(result)` and adjust code to handle dicts or use `pd.DataFrame(result)` if pandas needed.

affects: <1.0.0 -> >=1.0.0

gotchaFinviz may block automated requests if rate-limited. The library uses a simple sleep between requests, but heavy use can lead to IP bans or CAPTCHAs.

fix

Use proxies, add delays between requests, and avoid scraping at high frequency. Consider rotating user agents.

affects: all

gotchaThe `ticker_outer_rating` method may return an empty list or missing data for some tickers (e.g., ETFs or less-covered stocks). This is not an error but reflects Finviz's limited coverage.

fix

Always check if the result is non-empty before indexing. Handle empty results gracefully.

affects: all

deprecatedThe `ticker_outer_rating` method was renamed from an older `outer_rating` method in v0.14.x. The old name may still work but is deprecated.

fix

Use `ticker_outer_rating` instead of `outer_rating`.

affects: <0.14.7

Upgrade

Version history

1.3.0latest on PyPI · released Jan 3, 2026

Audit

Dependencies

requestsrequiredHTTP requests to Finviz

beautifulsoup4requiredHTML parsing

lxmloptionalXML/HTML parser

Agent activity

16 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/lit26/finvizfinance ↗

packagehttps://pypi.org/project/finvizfinance/ ↗

homepagehttps://finviz.com ↗