Finviz API

Finviz stock quotes, screener results, insider trades, earnings and sector performance as JSON, with no Elite plan.

The API.SH Finviz API turns public Finviz pages into structured JSON. Pull a US stock's quote page with every snapshot metric, run the stock screener with Finviz filter codes, read the latest SEC Form 4 insider transactions, check the earnings calendar and compare sector, industry and country performance. Market news comes back as headlines and links.

Get a free API key Try it in the playground

7 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Finviz earnings calendar

GET https://api.api.sh/finviz/v1/earnings

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Finviz API

Stock screening and idea generation

Run the Finviz screener with filter codes, a signal or a ticker list and get every column for each match, sorted any way you like. Look up the filter codes first so your queries match what Finviz offers.

/screener /screener-filters

Single-stock research

Fetch a ticker's company profile, valuation, growth, margins, ownership, short interest and technical metrics, analyst rating changes and recent headlines in one call.

/quote

Insider trading tracking

Follow the latest Form 4 filings with insider, relationship, transaction, price, shares and value, and link back to the SEC filing.

/insider /quote

Earnings calendar alerts

Read the earnings calendar for a given day, sorted by any column, to build a morning list or feed a notification bot.

/earnings

Sector and market rotation

Compare performance by sector, industry, country or market-cap class over a week, month, quarter, half year, year and year to date.

/groups

Trading dashboards and AI agents

Give a dashboard or an AI agent screener results, quotes and market headlines through one key and one JSON shape.

/screener /quote /news

Finviz data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Finviz API endpoints and prices

Every Finviz endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Products, listings and places2

Finviz stock quote /finviz/v1/quote	$1 · $2 PAYG 1 credit
Finviz stock screener /finviz/v1/screener	$1 · $2 PAYG 1 credit

More data5

Finviz earnings calendar /finviz/v1/earnings	$1 · $2 PAYG 1 credit
Finviz sector, industry and country performance /finviz/v1/groups	$1 · $2 PAYG 1 credit
Finviz insider trading /finviz/v1/insider	$1 · $2 PAYG 1 credit
Finviz market news /finviz/v1/news	$1 · $2 PAYG 1 credit
Finviz screener filters /finviz/v1/screener-filters	$1 · $2 PAYG 1 credit

Call the Finviz API

Finviz earnings calendar: GET https://api.api.sh/finviz/v1/earnings

curl "https://api.api.sh/finviz/v1/earnings?date=2024-10-28" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/finviz/v1/earnings",
    params={"date": "2024-10-28"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/finviz/v1/earnings");
url.searchParams.set("date", "2024-10-28");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/finviz/v1/earnings", "date", "2024-10-28")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Finviz" and "Finviz earnings calendar".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Finviz data

Public data only: no Finviz login, cookies or account needed
One key and one response shape for Finviz and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Finviz API

Finviz does offer API access and data export, but according to the search results it is limited to paid Finviz Elite members, returns CSV and has rate limits. API.SH needs no Elite subscription and returns the public screener, quote, insider and group data as JSON.

Instead of maintaining a Finviz scraper or a community Python wrapper that breaks when the page changes, API.SH gives you one key, JSON output and a fixed price per call. It is also simpler than comparing RapidAPI and Apify listings.

Finviz API questions

What Finviz data can I get?+

Quote pages for US stocks (/finviz/v1/quote), the stock screener with its filter codes (/finviz/v1/screener and /finviz/v1/screener-filters), insider transactions (/finviz/v1/insider), the earnings calendar (/finviz/v1/earnings), sector, industry, country and market-cap group performance (/finviz/v1/groups) and market news headlines (/finviz/v1/news).

How much does the Finviz API cost?+

Every Finviz endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /finviz/v1/earnings at 1 credit each.

Is there an official Finviz API?+

Yes, but it is part of the paid Finviz Elite plan and returns CSV. API.SH is a separate service: it reads public Finviz pages, needs no Elite account and returns JSON.

Do I need a Finviz account or login?+

No. API.SH reads public Finviz pages only. No endpoint uses a login, cookies or anyone's account.

Is there a free Finviz API?+

Finviz's own API access is tied to its paid plan. With API.SH you can start free: every account gets 1,000 free credits every month, enough to try the screener, quotes and insider data before you pay for anything.

Can I use the Finviz API from Python?+

Yes. API.SH is plain HTTPS with a JSON response, so requests, httpx or the Python SDK all work. You do not need a community wrapper such as finvizfinance, and results come back as structured data instead of scraped HTML.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /finviz/v1/screener with a filters value taken from /finviz/v1/screener-filters, or /finviz/v1/quote with a ticker. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.