Google Finance Scraper

Extract real-time stock quotes, price history graphs, financial statements, market indices, company info, and related news from Google Finance. Supports stocks, ETFs, indices, currencies, and crypto - run a single symbol or scrape an entire portfolio in one call.

---

What This Actor Returns

For each symbol queried, the actor returns:

• Real-time quote - current price, price change, percent change, exchange, currency, and after-hours data
• Price history graph - intraday or historical price and volume data points for your chosen time window (1D to MAX)
• Market overview - US, European, and Asian indices; major currencies; top cryptocurrencies; futures; and top market news
• Company knowledge graph - market cap, P/E ratio, 52-week high/low, dividend yield, EPS, and company description
• Related news - headlines with title, source, date, and link
• Financial statements - income statement, balance sheet, and cash flow data (where available)
• Related instruments - stocks, ETFs, and other instruments suggested by Google Finance

Each symbol is pushed as a separate item in the Apify dataset. One run can scrape a single ticker or an entire portfolio.

---

Use Cases

• Portfolio monitoring - batch-fetch quotes and key stats for all your holdings in one run
• Financial research - pull income statements, balance sheets, and cash flow data for analysis
• Earnings tracking - monitor EPS, revenue, and quarterly financials over time
• Market dashboards - build real-time dashboards with index levels, currency rates, and crypto prices
• Crypto and currency data - fetch BTC-USD, ETH-USD, EUR-USD, and other pairs alongside traditional equities
• News aggregation - collect finance news for any symbol or market segment

---

Input Parameters

Parameter	Type	Required	Default	Description
queries	string[]	Yes (or q)	-	List of symbols for batch runs, e.g. ["GOOGL:NASDAQ", "BTC-USD"]. Takes precedence over q.
q	string	Yes (or queries)	-	Single symbol for a quick lookup, e.g. "GOOGL:NASDAQ". Ignored if queries is set.
hl	string	No	"en"	Language code (ISO 639-1) for news and descriptions, e.g. "es", "de".
window	string	No	"1D"	Time window for price history graph: 1D, 5D, 1M, 6M, YTD, 1Y, 5Y, MAX.
max_queries	integer	No	0	Cap the number of symbols processed. 0 = unlimited (process all).
output_file	string	No	-	Optional filename to save results as JSON (e.g. "portfolio.json").

Symbol Format Guide

Instrument	Format	Examples
US stocks	TICKER:EXCHANGE	GOOGL:NASDAQ, AAPL:NASDAQ, MSFT:NASDAQ, JPM:NYSE
International stocks	TICKER:EXCHANGE	BP:LON, SAP:ETR, 7203:TYO
Cryptocurrencies	TICKER-USD	BTC-USD, ETH-USD, SOL-USD
Currency pairs	BASE-QUOTE	EUR-USD, GBP-JPY, USD-JPY
US indices	.TICKER:INDEXID	.DJI:INDEXDJX, .IXIC:INDEXNASDAQ, .INX:INDEXSP

---

Example Output

Single Symbol

Input:

{
  "q": "GOOGL:NASDAQ"
}

Output item (truncated):

{
  "search_timestamp": "2026-05-07T14:30:00.123456",
  "search_parameters": {
    "q": "GOOGL:NASDAQ",
    "hl": "en",
    "window": "1D"
  },
  "search_metadata": {
    "status": "Success"
  },
  "summary": {
    "title": "Alphabet Inc Class A",
    "price": "166.32",
    "stock": {
      "price": 166.32,
      "price_movement": {
        "percentage": 0.49,
        "value": 0.81,
        "movement": "Up"
      }
    },
    "market_info": {
      "exchange": "NASDAQ",
      "currency": "USD"
    }
  },
  "graph": [
    { "date": "May 7, 2:00 AM", "price": 163.91, "volume": 1450000 },
    { "date": "May 7, 9:30 AM", "price": 165.51, "volume": 3820000 }
  ],
  "knowledge_graph": {
    "title": "Alphabet Inc Class A",
    "type": "NASDAQ: GOOGL",
    "key_stats": [
      { "label": "Market cap", "value": "2.03T USD" },
      { "label": "P/E ratio", "value": "18.13" },
      { "label": "Div yield", "value": "0.50%" },
      { "label": "52-wk high", "value": "208.70" },
      { "label": "52-wk low", "value": "140.53" }
    ]
  },
  "news_results": [
    {
      "date": "3 days ago",
      "title": "Alphabet Reports Record Q1 Revenue",
      "link": "https://example.com/article",
      "source": "Reuters"
    }
  ],
  "financials": [
    {
      "title": "Income Statement",
      "annual": [
        {
          "year": "TTM",
          "revenue": "359.5B",
          "net_income": "115.7B"
        }
      ]
    }
  ],
  "markets": {
    "us": [
      { "market_index": "S&P 500", "stock": { "price": 5627.89, "price_movement": { "movement": "Up" } } }
    ]
  },
  "discover_more": [
    {
      "title": "People also search for",
      "items": [
        { "name": "Microsoft", "price": "449.15", "extracted_price": 449.15 }
      ]
    }
  ]
}

Multi-Symbol Portfolio

Input:

{
  "queries": ["GOOGL:NASDAQ", "AAPL:NASDAQ", "BTC-USD"],
  "window": "1Y"
}

The actor pushes one dataset item per symbol, so the dataset contains 3 items - one for each of GOOGL, AAPL, and BTC. Each item has the same structure as the single-symbol example above with 1-year price history.

---

Pricing

Event	Cost	When charged
Setup	$0.02	Once per run
Per symbol	$0.02	Per symbol fetched

Examples:

• 1 symbol → $0.04 total
• 10 symbols → $0.22 total
• 50 symbols (full portfolio) → $1.02 total

---

How to Get Started

Quick start - single symbol

{
  "q": "GOOGL:NASDAQ"
}

Portfolio run - multiple symbols

{
  "queries": [
    "GOOGL:NASDAQ",
    "AAPL:NASDAQ",
    "MSFT:NASDAQ",
    "AMZN:NASDAQ",
    "BTC-USD",
    "EUR-USD",
    ".DJI:INDEXDJX"
  ],
  "window": "1Y",
  "hl": "en"
}

Get financial statements only

{
  "queries": ["GOOGL:NASDAQ", "AAPL:NASDAQ", "MSFT:NASDAQ"],
  "window": "1D"
}

Then use the ?view=financials dataset endpoint for a focused financial statements view.

---

Use with Claude, Cursor, and Any MCP Client

This actor is available as an MCP (Model Context Protocol) tool, letting you query Google Finance data directly inside Claude, Cursor, or any MCP-compatible AI client — no code required. Ask questions in plain English and get live financial data back.

How to Connect

1. Open the actor on Apify and click API → MCP Server
2. Copy your personal MCP server URL
3. Add it to your Claude Desktop or Cursor config (see the Apify MCP docs for step-by-step instructions)
4. Ask financial questions in plain English

Example Prompts

• "Is TSLA up or down vs its 200-day moving average right now?"
• "Compare NVDA's last 8 quarters of revenue growth vs SPY"
• "What's Apple's current P/E ratio and market cap?"
• "Show me Bitcoin's price history for the last month"
• "Fetch quotes for my portfolio: GOOGL, AAPL, MSFT, AMZN, NVDA"
• "Rank my holdings by today's volatility"

Note: this actor returns market data only — it is not financial advice.

---

FAQ

What symbol format should I use? For US stocks: TICKER:EXCHANGE (e.g. GOOGL:NASDAQ, JPM:NYSE). For crypto: TICKER-USD (e.g. BTC-USD). For currencies: BASE-QUOTE (e.g. EUR-USD). For indices: .TICKER:INDEXID (e.g. .DJI:INDEXDJX). You can search Google Finance directly to find the exact symbol format for international equities.

What if I enter a company name like "Google" instead of a symbol? Plain company names won't return data. Google Finance requires a symbol in the formats described above - GOOGL:NASDAQ, not Google. If you submit an unrecognized query, the actor will push an error record to the dataset and you will still be charged for the attempt (the underlying API call was made). To avoid wasted charges, use the Symbol Format Guide above or look up the correct symbol on Google Finance first.

What happens if a symbol has no results? The actor pushes an error record for that symbol with "error": true and a descriptive message. Other symbols in the same run continue processing - one bad symbol won't abort the run.

Are financial statements available for all symbols? Financial statements (income statement, balance sheet, cash flow) are only available for equities. Crypto, currencies, and indices return null for the financials field.

How many symbols can I fetch in one run? There is no hard limit. Use max_queries to cap the run. For large portfolios, the actor processes each symbol sequentially and charges per symbol.

What is the window parameter for? It controls the time range of the price history graph returned in the graph field. 1D returns intraday data points; 5Y or MAX returns multi-year historical price points. The quote summary (summary) always reflects the current real-time price regardless of the window.

---

Last Updated: 2026.06.02