finviz.com APIfinviz.com ↗
Access Finviz stock screener results, insider trading transactions, news sentiment, and market movers via a structured JSON API. 5 endpoints.
curl -X GET 'https://api.parse.bot/scraper/680946c1-3c1f-4cd9-948d-2822f535b6a1/get_insider_trading' \ -H 'X-API-Key: $PARSE_API_KEY'
Extract detailed insider trading data from Finviz. Returns recent insider transactions including ticker, owner, relationship, transaction type, cost, shares, and value. Supports filtering by minimum transaction value.
| Param | Type | Description |
|---|---|---|
| min_value | integer | Minimum transaction value in USD to include in results. Transactions below this value are excluded. |
{
"type": "object",
"fields": {
"data": "array of insider trading transaction objects with keys: Ticker, Owner, Relationship, Date, Transaction, Cost, #Shares, Value ($), #Shares Total, SEC Form 4, SEC Form 4 URL"
},
"sample": {
"data": [
{
"Cost": "8.01",
"Date": "May 12 '26",
"Owner": "Grossman Jerrold B",
"Ticker": "ADMA",
"#Shares": "12,500",
"Value ($)": "100,125",
"SEC Form 4": "May 14 07:00 AM",
"Transaction": "Buy",
"Relationship": "Director",
"#Shares Total": "513,884",
"SEC Form 4 URL": "http://www.sec.gov/Archives/edgar/data/1368514/000114036126021150/xslF345X06/form4.xml"
}
],
"status": "success"
}
}About the finviz.com API
The Finviz API provides structured access to five endpoints covering stock screening, insider trading activity, news sentiment, and market movers. Using get_screener_results you can filter the full Finviz screener by any combination of fundamental and technical filter codes and receive matching stocks with fields like Market Cap, P/E, Price, Change, and Volume. The API also exposes insider transaction records, per-ticker news sentiment, and lists of top gainers, losers, and unusually active stocks.
Endpoints and Data Coverage
The get_screener_results endpoint accepts a filters string using Finviz filter codes (e.g. fa_peg_u1,ta_sma200_pc5) and returns an array of stocks with 11 fields per row: No., Ticker, Company, Sector, Industry, Country, Market Cap, P/E, Price, Change, and Volume. The get_market_movers endpoint uses a mover_type parameter — top_gainers, top_losers, most_active, or unusual_volume — and returns the same field shape, making it straightforward to compare screener output against real-time movers.
Insider Trading and News Sentiment
The get_insider_trading endpoint returns recent insider transactions with fields: Ticker, Owner, Relationship, Date, Transaction, Cost, #Shares, and Value ($). An optional min_value integer parameter filters out transactions below a given USD threshold, useful when focusing on significant trades. The get_stock_news_sentiment endpoint takes a required ticker symbol and returns recent news items for that stock, each tagged with a sentiment classification — Positive, Negative, or Neutral — derived from headline keyword matching. Response fields include date, time, headline, source, and url.
General-Purpose Table Extraction
The get_tabular_data endpoint accepts any Finviz page URL and returns all tables found on that page as an array of objects, each with table_index, headers, and a data array of row objects. This covers Finviz pages not addressed by the dedicated endpoints — sector performance, futures, forex, or any other page with tabular content.
- Scan for undervalued stocks by passing fundamental filter codes to get_screener_results and sorting on P/E and Market Cap.
- Monitor executive stock sales by filtering get_insider_trading results by min_value to surface large-value transactions.
- Track daily sentiment shifts for a watchlist by calling get_stock_news_sentiment for each ticker and aggregating Positive/Negative counts.
- Build a pre-market alert system using get_market_movers with the unusual_volume type to catch early volume spikes.
- Compare top gainers against insider buying signals by combining get_market_movers and get_insider_trading outputs on the same ticker.
- Extract sector performance tables or futures data from any Finviz page using get_tabular_data with a target URL.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.