# Finviz API: Screen US stocks > Screens US-listed stocks on Finviz by sector, company size, minimum dividend yield, maximum P/E ratio and market signal, ranked by market value, today's gain or dividend yield. Unofficial. Not affiliated with or endorsed by Finviz. - Page: https://fous.com/methods/finviz.com/screen-stocks - Method: `finviz.com/screen_stocks`, version 1 - Website: finviz.com - Returns: company, ticker, sector, industry, country, market cap, P/E, price, today's change, volume, Finviz page - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `page` | integer | no | | 1-based page of results to start from, for example 2. Default 1. | | `sort` | string | no | | Stock ranking, for example largest_first. One of "largest_first", "biggest_gainers", "highest_dividend". Default "largest_first". | | `sector` | string | no | `"Technology"` | Business sector, for example Technology; any includes all sectors. One of "any", "Basic Materials", "Communication Services", "Consumer Cyclical", "Consumer Defensive", "Energy", "Financial", "Healthcare", "Industrials", "Real Estate", "Technology", "Utilities". Default "any". | | `signal` | string | no | | Market signal, for example top_gainers. One of "none", "top_gainers", "top_losers", "new_52_week_high", "new_52_week_low", "unusual_volume", "most_active", "oversold", "overbought". Default "none". | | `max_results` | integer | no | `20` | Maximum number of stocks to return, for example 20. Up to 100. Default 20. | | `company_size` | string | no | `"mega"` | Market value range, for example large ($10B–$200B). One of "any", "mega", "large", "mid", "small", "micro". Default "any". | | `minimum_dividend_yield_percent` | number | no | | Minimum annual dividend yield as a percentage, for example 2.5. Default 0. | | `maximum_price_to_earnings_ratio` | number | no | | Max P/E ratio, for example 25. Omit to include any P/E. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "sector": "Technology", "max_results": 20, "company_size": "mega" } ``` Its output: ```json { "stocks": [ { "sector": "Technology", "ticker": "NVDA", "company": "NVIDIA Corp", "country": "USA", "industry": "Semiconductors", "page_url": "https://finviz.com/quote.ashx?t=NVDA", "price_usd": 228.86, "volume_shares": 142344321, "market_cap_usd": 5515530000000, "change_percent_today": 1.68, "price_to_earnings_ratio": 28.93 }, { "sector": "Technology", "ticker": "AAPL", "company": "Apple Inc", "country": "USA", "industry": "Consumer Electronics", "page_url": "https://finviz.com/quote.ashx?t=AAPL", "price_usd": 338.4, "volume_shares": 32820848, "market_cap_usd": 4938670000000, "change_percent_today": -0.78, "price_to_earnings_ratio": 38.79 }, { "sector": "Technology", "ticker": "MSFT", "company": "Microsoft Corp", "country": "USA", "industry": "Software - Infrastructure", "page_url": "https://finviz.com/quote.ashx?t=MSFT", "price_usd": 509.22, "volume_shares": 19626939, "market_cap_usd": 3781240000000, "change_percent_today": -1.35, "price_to_earnings_ratio": 28.38 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"finviz.com/screen_stocks","input":{"sector":"Technology","max_results":20,"company_size":"mega"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find large-cap Utilities stocks yielding at least 3.5% with a P/E under 20, sorted by highest dividend yield. - Which small-cap Healthcare stocks are showing unusual volume today? Give me the top 15 by today's gain. - On Finviz, pull mega-cap Technology companies ranked by market cap, with ticker, P/E, price and volume. - Show me oversold mid-cap Energy stocks with P/E below 12 and a dividend of at least 2%. - Use Finviz to list Financial sector stocks hitting new 52-week highs, sorted by today's biggest gainers, page 2, 50 results. ## Input schema ```json { "type": "object", "properties": { "page": { "type": "integer", "default": 1, "minimum": 1, "description": "1-based page of results to start from, for example 2." }, "sort": { "enum": [ "largest_first", "biggest_gainers", "highest_dividend" ], "type": "string", "default": "largest_first", "description": "Stock ranking, for example largest_first." }, "sector": { "enum": [ "any", "Basic Materials", "Communication Services", "Consumer Cyclical", "Consumer Defensive", "Energy", "Financial", "Healthcare", "Industrials", "Real Estate", "Technology", "Utilities" ], "type": "string", "default": "any", "description": "Business sector, for example Technology; any includes all sectors." }, "signal": { "enum": [ "none", "top_gainers", "top_losers", "new_52_week_high", "new_52_week_low", "unusual_volume", "most_active", "oversold", "overbought" ], "type": "string", "default": "none", "description": "Market signal, for example top_gainers." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of stocks to return, for example 20. Up to 100." }, "company_size": { "enum": [ "any", "mega", "large", "mid", "small", "micro" ], "type": "string", "default": "any", "description": "Market value range, for example large ($10B–$200B)." }, "minimum_dividend_yield_percent": { "type": "number", "default": 0, "minimum": 0, "description": "Minimum annual dividend yield as a percentage, for example 2.5." }, "maximum_price_to_earnings_ratio": { "type": "number", "minimum": 0, "description": "Max P/E ratio, for example 25. Omit to include any P/E." } } } ``` ## Output schema ```json { "type": "object", "required": [ "stocks" ], "properties": { "stocks": { "type": "array", "items": { "type": "object", "required": [ "company", "ticker", "sector", "industry", "country", "market_cap_usd", "price_to_earnings_ratio", "price_usd", "change_percent_today", "volume_shares", "page_url" ], "properties": { "sector": { "type": [ "string", "null" ], "description": "Business sector." }, "ticker": { "type": "string", "description": "Stock symbol." }, "company": { "type": "string", "description": "Company name." }, "country": { "type": [ "string", "null" ], "description": "Company country." }, "industry": { "type": [ "string", "null" ], "description": "Industry." }, "page_url": { "type": "string", "description": "Finviz stock page." }, "price_usd": { "type": [ "number", "null" ], "description": "Price in US dollars." }, "volume_shares": { "type": [ "integer", "null" ], "description": "Shares traded." }, "market_cap_usd": { "type": [ "number", "null" ], "description": "Market capitalization in US dollars." }, "change_percent_today": { "type": [ "number", "null" ], "description": "Current-day price change, percent." }, "price_to_earnings_ratio": { "type": [ "number", "null" ], "description": "Price-to-earnings ratio." } }, "additionalProperties": false }, "description": "Matching US stocks." } }, "additionalProperties": false } ``` ## See more - [Finviz API: Get stock snapshot](https://fous.com/methods/finviz.com/get-stock-snapshot.md): Get a delayed US-listed stock snapshot from its ticker or company name. Analyst labels summarize Finviz's 1-5 mean score; dividend yield uses the estimated dividend when available. Missing metrics return null. - [Finviz API: List insider trades](https://fous.com/methods/finviz.com/list-insider-trades.md): Lists recent Form 4 insider trades on Finviz, optionally for one company or ticker and filtered to buys, sales, or both. - [TradingView API: Screen stocks by country, sector and size](https://fous.com/methods/tradingview.com/screen-stocks.md): Finds publicly listed stocks in a country, filtered by sector, US-dollar market cap band and minimum dividend yield, in the requested order. Quotes may be delayed. - [Yahoo API: List market movers](https://fous.com/methods/finance.yahoo.com/list-market-movers.md): Lists Yahoo Finance's top gainers, top losers, most active stocks, or regional trending tickers in Yahoo's order, with price, change, volume and market cap. - [MSN API: List market movers](https://fous.com/methods/msn.com/list-market-movers.md): Lists MSN Money's current leading stock gainers, losers, or most-active shares in a selected market, in MSN's order. Lists may contain fewer than 50 stocks and prices may be delayed. - [SEC EDGAR API: Get company financials](https://fous.com/methods/sec.gov/get-company-financials.md): Looks up a public company by name or ticker on SEC EDGAR and returns its reported annual or quarterly financial figures from XBRL company facts. Quarterly flows are derived from year-to-date totals when no quarterly figure is filed. Unavailable figures are null. - [Fortune API: List Fortune 500 companies](https://fous.com/methods/fortune.com/list-fortune-500.md): Lists the Fortune 500 for a year. You can filter by industry or sector and by headquarters state. Each company comes with its public financial and company details. - [CompaniesMarketCap API: List largest companies](https://fous.com/methods/companiesmarketcap.com/list-largest-companies.md): Ranks public companies worldwide, or by country and industry, by market cap, revenue, earnings, employees or dividend yield. When both a country and an industry are set, the industry ranking order is kept and only companies from that country are shown. - [All Finviz methods](https://fous.com/methods/finviz.com.md)