# Finviz API: Get stock snapshot > 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. Unofficial. Not affiliated with or endorsed by Finviz. - Page: https://fous.com/methods/finviz.com/get-stock-snapshot - Method: `finviz.com/get_stock_snapshot`, version 1 - Website: finviz.com - Returns: company name, ticker, exchange, sector, industry, country, price, valuation ratios, analyst rating and target, ownership, 52-week range, Finviz link - 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 | |---|---|---|---|---| | `company` | string | yes | `"Apple"` | Company name or US stock ticker, for example Apple or AAPL. | ## Output From a run on Oct 23, 2026. Its input: ```json { "company": "Apple" } ``` Its output: ```json { "sector": "Technology", "ticker": "AAPL", "country": "USA", "exchange": "Nasdaq", "industry": "Consumer Electronics", "price_usd": 345.87, "finviz_link": "https://finviz.com/stock?t=AAPL", "company_name": "Apple Inc", "market_cap_usd": 5047690000000, "short_float_percent": 0.83, "today_change_percent": -0.67, "profit_margin_percent": 27.62, "analyst_recommendation": "Buy", "dividend_yield_percent": 0.32, "fifty_two_week_low_usd": 243.42, "fifty_two_week_high_usd": 348.36, "price_to_earnings_ratio": 39.65, "raw_recommendation_score": 2.2, "insider_ownership_percent": 0.12, "forward_price_to_earnings_ratio": 36.04, "institutional_ownership_percent": 68.94, "average_analyst_price_target_usd": 335.44, "expected_earnings_growth_next_year_percent": 8.61 } ``` ## 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/get_stock_snapshot","input":{"company":"Apple"}}' ``` 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 - Can you pull up the current snapshot for NVDA including its price and analyst rating? - I need the delayed stock quote and valuation ratios for Coca-Cola. - What's the 52-week range and analyst target for Tesla stock right now? - Give me a quick overview of Microsoft: sector, industry, exchange, and dividend yield. - Look up the ticker JPM on finviz.com and show me its ownership details and P/E ratio. ## Input schema ```json { "type": "object", "required": [ "company" ], "properties": { "company": { "type": "string", "description": "Company name or US stock ticker, for example Apple or AAPL." } } } ``` ## Output schema ```json { "type": "object", "required": [ "company_name", "ticker", "exchange", "sector", "industry", "country", "price_usd", "today_change_percent", "market_cap_usd", "price_to_earnings_ratio", "forward_price_to_earnings_ratio", "expected_earnings_growth_next_year_percent", "profit_margin_percent", "dividend_yield_percent", "analyst_recommendation", "average_analyst_price_target_usd", "insider_ownership_percent", "institutional_ownership_percent", "short_float_percent", "fifty_two_week_high_usd", "fifty_two_week_low_usd", "finviz_link", "raw_recommendation_score" ], "properties": { "sector": { "type": "string", "description": "Business sector" }, "ticker": { "type": "string", "description": "Stock ticker" }, "country": { "type": "string", "description": "Company country" }, "exchange": { "type": "string", "description": "US listing exchange" }, "industry": { "type": "string", "description": "Industry" }, "price_usd": { "type": [ "number", "null" ], "description": "Delayed share price in US dollars" }, "finviz_link": { "type": "string", "description": "Finviz stock page" }, "company_name": { "type": "string", "description": "Company name" }, "market_cap_usd": { "type": [ "number", "null" ], "description": "Market capitalization in US dollars, full number" }, "short_float_percent": { "type": [ "number", "null" ], "description": "Short float as percent of float" }, "today_change_percent": { "type": [ "number", "null" ], "description": "Change today, in percent" }, "profit_margin_percent": { "type": [ "number", "null" ], "description": "Profit margin in percent" }, "analyst_recommendation": { "type": [ "string", "null" ], "description": "Analyst recommendation from Strong buy to Strong sell" }, "dividend_yield_percent": { "type": [ "number", "null" ], "description": "Estimated dividend yield in percent, null if none" }, "fifty_two_week_low_usd": { "type": [ "number", "null" ], "description": "52-week low in US dollars" }, "fifty_two_week_high_usd": { "type": [ "number", "null" ], "description": "52-week high in US dollars" }, "price_to_earnings_ratio": { "type": [ "number", "null" ], "description": "Trailing price-to-earnings ratio" }, "raw_recommendation_score": { "type": [ "number", "null" ], "description": "Finviz analyst mean score from 1 (buy) to 5 (sell)" }, "insider_ownership_percent": { "type": [ "number", "null" ], "description": "Insider ownership in percent" }, "forward_price_to_earnings_ratio": { "type": [ "number", "null" ], "description": "Forward price-to-earnings ratio" }, "institutional_ownership_percent": { "type": [ "number", "null" ], "description": "Institutional ownership in percent" }, "average_analyst_price_target_usd": { "type": [ "number", "null" ], "description": "Mean analyst price target in US dollars" }, "expected_earnings_growth_next_year_percent": { "type": [ "number", "null" ], "description": "Expected earnings growth next year, in percent" } } } ``` ## See more - [Finviz API: Screen US stocks](https://fous.com/methods/finviz.com/screen-stocks.md): 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. - [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. - [Stock Analysis API: Get key statistics](https://fous.com/methods/stockanalysis.com/get-key-statistics.md): Looks up a stock by company name or ticker on Stock Analysis and returns its valuation ratios and company statistics, with the date the figures were last updated. - [MSN API: Get stock quote](https://fous.com/methods/msn.com/get-stock-quote.md): Gets a stock's latest MSN Money quote and key facts by company name or ticker and listing country. Quotes may be delayed outside market hours. - [Yahoo API: Get quote](https://fous.com/methods/finance.yahoo.com/get-quote.md): Looks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed. - [Yahoo API: Get company news](https://fous.com/methods/finance.yahoo.com/get-company-news.md): Looks up a company by name or ticker on Yahoo Finance and returns its latest news headlines, with article summaries when the article page provides one. - [Stock Analysis API: Get financial statements](https://fous.com/methods/stockanalysis.com/get-financial-statements.md): Looks up a company by name or ticker on Stock Analysis and returns its annual or quarterly income statement, balance sheet, or cash flow statement for the free periods. - [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. - [All Finviz methods](https://fous.com/methods/finviz.com.md)